Registry

The Mukoko Registry is a shadcn-compatible component registry that serves 94 items (82 UI components, 3 hooks, 9 library utilities). It allows any Mukoko app to install production-ready components with a single CLI command.

How it works

The registry serves components in two ways:

1. Dynamic API — GET /api/v1/ui/{name} reads registry.json at runtime, inlines component source code, and serves it with CORS headers
2. Static build — pnpm registry:build pre-generates JSON files into public/r/ for CDN serving

Both formats are compatible with the shadcn CLI.

Architecture

registry.json (manifest — source of truth)
    │
    ├── Dynamic API (app/api/v1/ui/)
    │   ├── GET /api/v1/ui → registry index
    │   └── GET /api/v1/ui/{name} → component JSON with source
    │
    └── Static build (scripts/build-registry.js)
        └── public/r/{name}.json → pre-built component JSON

Explore

Quick install

npx shadcn@latest add https://registry.mukoko.com/api/v1/ui/button

This fetches the button component JSON, resolves its dependencies (radix-ui, class-variance-authority), and writes components/ui/button.tsx to your project.