Gathering detailed insights and metrics for directus-extension-operation-nanoid
Generate a NanoID in your Directus flows
Installations
npm install directus-extension-operation-nanoidDeveloper Guide
BETA
Typescript
No
Module System
ESM
Node Version
22.6.0
NPM Version
10.8.3
Releases
5
Contributors
1
Unable to fetch Contributors
Languages
1
TypeScript
TypeScript (100%)
Love this project? Help keep it running — sponsor us today! 🚀
Developer
Download Statistics
Total Downloads
635
Last Day
1
Last Week
7
Last Month
110
Last Year
635
GitHub Statistics
2 Stars
33 Commits
1 Watching
2 Branches
1 Contributors
Maintainers
1
Package Meta Information
Latest Version
1.0.7
Package Id
directus-extension-operation-nanoid@1.0.7
Unpacked Size
72.94 kB
Size
19.32 kB
File Count
5
NPM Version
10.8.3
Node Version
22.6.0
Publised On
17 Jan 2025
Total Downloads
Cumulative downloads
Total Downloads
635
Last day
-85.7%
1
Compared to previous day
Last week
-91.1%
7
Compared to previous week
Last month
511.1%
110
Compared to previous month
Last year
0%
635
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
1
Dev Dependencies
5
Versions
Introduction
A Directus operation extension that generates a NanoID for your Directus flows using the official nanoid package.
- Customize your seed: Use the default alphabet (
A-Za-z0-9_-) or use your own custom alphabet. - Set your length: Modify the length of your NanoID according to your flow use-case.
- Add a prefix or suffix: Want to use Stripe-style identifiers? Add a prefix and suffix to generated NanoIDs.
Use Cases
- Alternate IDs: Create secondary IDs for your Directus items and resources.
- Unique identifiers: Generate unique IDs for invoices, product codes, or any other specific needs.
- URL shortening: Produce short, shareable links or permalinks.
Installation
Install via Directus Marketplace
The easiest way to install this extension is through the Directus Marketplace, located inside of your Settings module.
Install via Package Manager
Install the extension by using your preferred package manager (i.e. pnpm, bun).
1# Using pnpm 2pnpm i directus-extension-operation-nanoid 3 4# Using bun 5bun i directus-extension-operation-nanoid 6 7# Using npm 8npm i directus-extension-operation-nanoid 9 10# Using yarn 11yarn add directus-extension-operation-nanoid
Install Manually
Clone this repository into the /extensions folder of your Directus project.
1git clone https://github.com/antonioso-ng/directus-extension-operation-nanoid
If you require further information on how to manually install the extension inside your self-hosted instance or Docker instance, refer to the Directus documentation.
Usage
- Create a Directus flow with your chosen trigger.
- Add the NanoID operation to your flow.
- Customize operation according to your needs by modifying the following options.
- Seed: The operation includes a default NanoID seed. You can specify a different seed value if you require deterministic IDs across executions.
- Prefix: Add a string to prepend to each generated NanoID, helping categorize or identify your IDs easily.
- Suffix: Include a string to append to each generated NanoID, providing additional context or uniqueness.
- Length: Set the desired length for the generated NanoID. The default is typically 21 characters, but you can adjust it as needed.
- Save the operation and preview an example of a generated NanoID using your settings.
- Finish your flow and see it in action.
Step-by-Step
Create a Directus flow
For most flows, the recommended trigger will be an Event Hook with the items.create scope. This trigger will be used to generate a NanoID upon the creation of an item in the selected collections.
Add the NanoID operation
From the initial trigger card, add a new operation and select the NanoID operation, which can be found at the bottom of the operations list. You can then customize the NanoID to suit your requirements.
The example below demonstrates how to create a Stripe-like NanoID, complete with a custom prefix and seed.
Save and preview the NanoID operation
After saving the operation, you can preview the generated NanoID. The result can be accessed by using {{ $last }} in subsequent operations.
Save the NanoID to the trigger item
To save the generated NanoID, create an Update Data operation. In this example, the Customer collection includes a field named identifier, where the generated NanoID will be stored.
You will assign the trigger's item ID using {{ $trigger.key }} and set the payload to update the identifier field with the value {{ $last }}.
Save your flow and test it
After saving and activating your flow, test it to ensure that your custom NanoID is generated and stored in the identifier field whenever a new item is created in the assigned collection.
Developing
To contribute or customize the extension, clone the repository.
1git clone https://github.com/antonioso-ng/directus-extension-operation-nanoid
Install project dependencies using your preferred package manager.
1bun i
Run the extension on watch mode or build it.
1# Develop and watch 2bun run dev 3 4# Build extension 5bun run build
FAQ
What is NanoID?
NanoID is a small, secure, and URL-friendly unique string ID generator. It's an excellent alternative to UUID for creating compact and non-sequential identifiers in your applications.
You can find more information about NanoID right here.
Why should I use it?
This extension offers a powerful and simple alternative for generating custom identifiers beyond the standard options available in Directus.
NanoIDs are highly customizable, secure, and significantly smaller than UUIDs, making them an excellent choice for any project.
What if I encounter issues?
If you run into any issues, first ensure you are using the latest version of Directus and that your flows are set up correctly.
If the problem persists, please open a new issue on GitHub, including detailed information about the issue you’re experiencing.
How can I contribute?
To get started, follow the steps outlined in the Developing section by forking this repository. Begin by forking this repository, creating a new branch, and implementing any changes you'd like to propose.
When you're ready, commit your changes following the Git Conventional Commits guidelines and submit a pull request. I’ll review your contributions and provide feedback or approval.
Acknowledgements
- The Directus team for creating and maintaining an amazing platform with limitless potential.
- Andrey Sitnik for the
nanoidpackage.
Made with 💜 and 5 cups of ☕
Website antonioso.ng • Buy Me a Coffee ☕ • LinkedIn @antoniosong
This extension is released under the MIT license. See LICENSE more information.
No vulnerabilities found.
No security vulnerabilities found.