Snapid

A fast, secure, URL-safe, short unique ID generator for Node.js, browser, and Deno. Ideal for database keys, tokens, URLs, logs, caches, or any scenario where you need unique identifiers.

---

Features

• Zero dependencies – plug and play
• URL-safe by default (Base58)
• Configurable length (size)
• Optional timestamp prefix for sortable IDs
• Optional deterministic seed for reproducible IDs
• Supports Node.js, Browser, and Deno
• High-performance – generate millions of IDs quickly

---

Installation

npm install snapid

---

Usage

import { snapid } from "snapid";

// default usage
const id = snapid();
console.log(id); // e.g., "a7FgQwLx9Z"

// custom size
const id16 = snapid({ size: 16 });
console.log(id16);

// timestamp prefix (sortable)
const timestampId = snapid({ time: true });
console.log(timestampId);

// deterministic ID
const seededId = snapid({ seed: "user123" });
console.log(seededId);

// custom alphabet
const hexId = snapid({ alphabet: "hex", size: 12 });
console.log(hexId);

// append ID to a short URL
const shortUrl = `https://example.com/${snapid()}`;
console.log(shortUrl); // e.g., "https://example.com/a7FgQwLx9Z"

// create a referral code URL
const referralUrl = `https://example.com/ref/${snapid({ size: 8 })}`;
console.log(referralUrl); // e.g., "https://example.com/ref/3kPq9Xz1"

// generate a tracking link with timestamp prefix
const trackUrl = `https://example.com/track/${snapid({ time: true })}`;
console.log(trackUrl); // e.g., "8M2Fh7QaZx3a"

Options

Option	Type	Default	Description
size	number	10	Length of the random part
time	boolean	false	Prepend timestamp prefix
alphabet	'base58' | 'base62' | 'hex'	'base58'	Alphabet used for encoding
seed	string	undefined	Optional deterministic seed

---

Example Use Cases

• Database primary keys
• Short URLs or referral codes
• Session or API tokens
• Cache keys
• Trace/log IDs for observability