URL-safe
Case-insensitive and contains no special characters
puidv7
URL-safe typed IDs for humans, time-ordered UUIDv7's for databases
What is puidv7?
Section titled “What is puidv7?”A puidv7 is a Prefixed UUIDv7 which:
- Is encoded using Crockford Base32 encoding
- Is always lowercase
- Contains no hyphens
- Has a 3-character alphabetic prefix (a-z)
UUIDv7 is great for databases and distributed systems, but not as great for humans.
The idea of puidv7 is to store UUIDv7 in your database and show puidv7 to your users.
Example
Section titled “Example”UUIDv7 = 01970a1c-e31e-7422-9cd5-e9651d11cc97
puidv7 = acc06bgm7733st2576nx5jht4ecjw
Best practice: Use puidv7 in URLs, APIs, and user interfaces. Convert back to UUIDv7 for database storage to maintain compatibility with existing UUID tooling and indexing.
Why puidv7?
Section titled “Why puidv7?”Nadrama created puidv7 to be:
Shorter
29 characters vs 36 for UUIDv7
Easy to copy
No hyphens means easier copy & paste
Error-resistant
Crockford swaps O→0 and I/l→1 to avoid misinterpretation
Type-inferrable
Prefix indicates the entity type (great for support teams)
Time-ordered in DB
Leverage UUIDv7’s timestamp-based ordering
Libraries
Section titled “Libraries” JavaScript / TypeScript npm install puidv7
Go go get github.com/puidv7/puidv7-go
OpenTofu / Terraform puidv7/puidv7 provider