{"id":50873123,"url":"https://github.com/21st-dev/registry","last_synced_at":"2026-06-15T07:03:56.776Z","repository":{"id":354942936,"uuid":"1225877795","full_name":"21st-dev/registry","owner":"21st-dev","description":"Open-source CLI for managing private React component registries — publish, install, search, and share components with your team. Works with any AI agent that supports SKILL.md (Claude Code, Cursor).","archived":false,"fork":false,"pushed_at":"2026-06-04T12:53:41.000Z","size":61,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-04T14:18:19.781Z","etag":null,"topics":["21st","ai-agent","anthropic-skill","claude-code","cli","components","cursor","react","registry","shadcn","skill","tailwind"],"latest_commit_sha":null,"homepage":"https://21st.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/21st-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-30T18:31:27.000Z","updated_at":"2026-06-04T12:53:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/21st-dev/registry","commit_stats":null,"previous_names":["21st-dev/registry"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/21st-dev/registry","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/21st-dev%2Fregistry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/21st-dev%2Fregistry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/21st-dev%2Fregistry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/21st-dev%2Fregistry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/21st-dev","download_url":"https://codeload.github.com/21st-dev/registry/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/21st-dev%2Fregistry/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34351451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["21st","ai-agent","anthropic-skill","claude-code","cli","components","cursor","react","registry","shadcn","skill","tailwind"],"created_at":"2026-06-15T07:03:55.980Z","updated_at":"2026-06-15T07:03:56.772Z","avatar_url":"https://github.com/21st-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# @21st-dev/registry\n\n\u003e **Open-source CLI for managing private React component registries.**\n\u003e Publish, install, search, and share components across your team — with\n\u003e first-class support for AI agents (Claude Code, Cursor) via the bundled\n\u003e `21st-registry` skill.\n\n[![npm](https://img.shields.io/npm/v/@21st-dev/registry.svg)](https://www.npmjs.com/package/@21st-dev/registry)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\n```bash\nnpx @21st-dev/registry login\nnpx @21st-dev/registry ./Button.tsx --description \"Animated primary button\"\nnpx @21st-dev/registry add @your-team/button\n```\n\n## What it does\n\nA team library is a **shadcn-compatible registry** of your team's React\ncomponents, hosted on [21st.dev](https://21st.dev). You can:\n\n- **Publish** — push any `.tsx` file (with auto-detected demo) into a team\n  registry. Component visibility controls who can install it.\n- **Install** — `npx @21st-dev/registry add @team/component` writes the file\n  into your project and runs your package manager (pnpm/npm/yarn/bun).\n- **Search** — semantic search across the team library by name, description,\n  or tags.\n- **Invite** — print a shareable link or send email invites for teammates.\n- **Multi-registry** — organise components into named registries (e.g.\n  `marketing-blocks`, `internal-tools`).\n\nEvery command works equally well from the terminal **or** through any AI\nagent that supports Anthropic's\n[SKILL.md format](https://github.com/anthropics/skills) — the bundled skill\nteaches the agent how and when to use the CLI on your behalf.\n\n## Quick start\n\n```bash\n# 1. One-time setup — install the AI-agent skill globally\nnpx @21st-dev/registry install-skill --global\n\n# 2. Authenticate (uses ~/.an/credentials, also reads API_KEY_21ST env var)\nnpx @21st-dev/registry login\n\n# 3. Publish a component\nnpx @21st-dev/registry ./Button.tsx \\\n  --description \"Animated primary button with loading state\"\n\n# 4. Install in another project\nnpx @21st-dev/registry add @your-team/button\n```\n\n## Convention\n\nA publishable component lives in a directory like:\n\n```\nmy-button/\n├── 21st.json\n├── component.tsx               ← must default-export the component\n├── demos/\n│   └── default.tsx             ← imports the component, renders it with props\n└── preview.png                 ← optional, ~1200×900 PNG/JPEG\n```\n\n`21st.json`:\n\n```json\n{\n  \"name\": \"Animated Button\",\n  \"description\": \"Smooth hover \u0026 press animations using framer-motion.\",\n  \"registry\": \"ui\",\n  \"tags\": [\"button\", \"animation\"],\n  \"visibility\": \"unlisted\",\n  \"component\": \"./component.tsx\",\n  \"demos\": [\n    {\n      \"name\": \"Default\",\n      \"slug\": \"default\",\n      \"file\": \"./demos/default.tsx\",\n      \"preview\": \"./preview.png\"\n    }\n  ]\n}\n```\n\n## Demo imports\n\nThe published component lives at `@/components/ui/{slug}` inside the\nsandbox. The CLI rewrites any **relative** demo import that resolves to your\n`component` file into that alias automatically — so this works:\n\n```tsx\n// demos/default.tsx\nimport Button from \"../component\"\n\nexport default function Demo() {\n  return \u003cButton\u003eClick\u003c/Button\u003e\n}\n```\n\n## Non-interactive flags\n\n```bash\nnpx @21st-dev/registry \\\n  --name \"Animated Button\" \\\n  --description \"Smooth hover \u0026 press animations.\" \\\n  --registry ui \\\n  --tags \"button,animation\" \\\n  --component ./component.tsx \\\n  --demo ./demos/default.tsx \\\n  --preview ./preview.png \\\n  --to my-registry \\\n  --unlisted\n```\n\n### Visibility tiers\n\n- `--unlisted` (default) — direct URL only, not in marketplace search\n- `--public` — submitted to the public 21st.dev marketplace (admin review)\n- `--private` — only members of the registry team\n\n### Multi-registry targeting\n\n`--to \u003cregistry-slug\u003e` targets a specific registry inside the team attached to\nyour API key. Without it, the server uses your team's first/default registry.\n\n## AI Agent Skill\n\n```bash\n# Install for any agent that supports SKILL.md format\nnpx @21st-dev/registry install-skill --global\n```\n\nThe skill teaches AI agents (Claude Code, Cursor, etc.) when and how to\npublish, install, and search components in your team registry — so you can\njust say \"publish this to our registry\" and the agent handles the rest.\n\nAlso installable from skills.sh:\n\n```bash\nnpx skills add 21st-dev/registry\n```\n\n## Auth\n\nCredentials live at `~/.an/credentials`. Run `npx @21st-dev/registry login` once — it\nprompts for your API key from\n[https://21st.dev/team/api-keys](https://21st.dev/team/api-keys).\n\nYou can also pass `API_KEY_21ST=...` in the environment.\n\n## Environment variables\n\n| Var | Default | What |\n|---|---|---|\n| `API_KEY_21ST` | – | Auth token (also accepts legacy `AN_API_KEY`) |\n| `API_URL_21ST` | `https://21st.dev/api/v1` | Override API base |\n| `APP_URL_21ST` | `https://21st.dev` | Override app base (used in success URL) |\n\n## Commands\n\n| Command | What it does |\n|---|---|\n| `login` | Authenticate with 21st.dev |\n| `publish \u003cpath\u003e` (or just `\u003cpath\u003e`) | Publish a component |\n| `add @user/slug` | Install from a team registry |\n| `search \"\u003cquery\u003e\"` | Semantic search across your team's library |\n| `invite` | Print a shareable invite link for your team |\n| `team \u003csubcommand\u003e` | View, create, and edit your teams |\n| `registry \u003csubcommand\u003e` | View, create, and edit team registries |\n| `install-skill` | Install the AI-agent skill (Claude + Cursor) |\n| `print-skill` | Print the bundled SKILL.md to stdout |\n\nRun any command with `--help` for full flag list.\n\n## Teams \u0026 registries\n\nManage teams and registries without leaving the terminal. All subcommands\naccept `--json` for machine-readable output. Teams are addressed by slug via\n`--team \u003cslug\u003e` (or a positional `[team]` argument where shown); without it,\ncommands target the team your API key belongs to.\n\n```bash\n# Teams\nnpx @21st-dev/registry team list                            # your teams (slug, role, default)\nnpx @21st-dev/registry team info acme                       # details, members, pending invites\nnpx @21st-dev/registry team create \"Acme\" --description \"Design systems\"\nnpx @21st-dev/registry team edit acme --name \"Acme Inc\"     # owner only\nnpx @21st-dev/registry team invite dev@acme.com --team acme # email invite\n\n# Registries (slug-addressed within a team)\nnpx @21st-dev/registry registry list --team acme\nnpx @21st-dev/registry registry info ui-kit --team acme\nnpx @21st-dev/registry registry create \"UI Kit\" --team acme # slug auto-derived: ui-kit\nnpx @21st-dev/registry registry edit ui-kit --description \"Buttons, inputs, cards\"\n```\n\nDeletion is intentionally not supported from the CLI — use the web Studio.\n\n## License\n\nMIT — see [LICENSE](./LICENSE). Open source, contributions welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F21st-dev%2Fregistry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F21st-dev%2Fregistry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F21st-dev%2Fregistry/lists"}