Home

@crimson_dev/command Wiki

Welcome to the @crimson_dev/command wiki — the complete reference for building command palettes with the modern web stack.

---

Quick Navigation

Getting Started

• Installation — Package setup with pnpm, npm, or yarn
• Quick Start — Your first command palette in 2 minutes
• Migration from cmdk — Automated migration with codemods

Core Concepts

• Architecture — Three-layer design, state machine, plugin system
• State Machine — Events, state transitions, subscriber pattern
• Search Engine — Fuzzy scoring, incremental filtering, pluggable interface
• Frecency — Frequency x recency ranking with Temporal decay
• Keyboard Shortcuts — Registry, parser, conflict detection

React 19 Adapter

• Compound Components — Command, Input, List, Item, Group, Dialog
• Virtualization — Automatic virtual scrolling for large datasets
• Accessibility — WAI-ARIA, forced-colors, screen readers

Advanced

• WASM Search — Rust trigram index, Web Worker mode
• Theming — OKLCH color space, CSS custom properties, dark mode
• GPU Animations — @starting-style, scroll-timeline, spring easing
• ES2026 Features — Iterator Helpers, Temporal, using/await using

API Reference

• Core API — createCommandMachine, createSearchEngine, FrecencyEngine
• React API — All 14 compound components and hooks
• WASM API — createWasmSearchEngine, createWorkerWasmSearchEngine
• Codemod API — CLI usage and transform details

Contributing

• Development Setup — Clone, install, test, benchmark
• Project Structure — Monorepo layout and conventions

---

Stack: TypeScript 6.0.1-rc | React 19.3.0-canary | ES2026 | Radix UI | Vitest | Playwright