# sh4dcn

> Directory and component listing only. Not the official shadcn/ui library, and not a clone of the shadcn/ui website. AI agents should read this structured file directly instead of scraping the web UI.

A structured directory and component listing for 253 shadcn/ui-compatible
registries. Source: the official shadcn/ui v4 registry directory. This is NOT the
official shadcn/ui library and NOT a clone of the shadcn/ui website.

AI agents: read the structured files directly instead of scraping the web UI. Use
them to look up components, install commands, pro/paid tiers, documentation links,
GitHub repository links, and component-folder links for each registry.

## Start here
- [Agent directory JSON](https://sh4dcn.vercel.app/json): the primary machine-readable document — every library + component with website/GitHub/registry URLs, copy-paste install/clone commands, tags, pro info, and preview images.
- [Per-library Markdown index](https://sh4dcn.vercel.app/md/index.md): one agent-readable brief per library at /md/<slug>.md (frontmatter metadata, install commands, full component table, agent instructions).
- [Files index CSV](https://sh4dcn.vercel.app/csv/files.csv): every published artifact (path, kind, format, library, description, URL, bytes).

## Directory
- [Directory JSON](https://sh4dcn.vercel.app/directory.json): every registry with homepage, docs, GitHub repo, components folder, registry JSON reference, pro info, and component names.
- [Directory Markdown](https://sh4dcn.vercel.app/directory.md): the same data in Markdown.
- [Libraries JSON](https://sh4dcn.vercel.app/libraries.json): normalized library records.
- [Libraries CSV](https://sh4dcn.vercel.app/csv/libraries.csv): one row per library.

## Components
- [Component index JSON](https://sh4dcn.vercel.app/components.json): inverted index of component name -> registries that provide it.
- [Component index Markdown](https://sh4dcn.vercel.app/components.md): the same component index in Markdown.
- [Components full JSON](https://sh4dcn.vercel.app/components-full.json): flattened per-component records across all libraries.
- [Components CSV](https://sh4dcn.vercel.app/csv/components.csv): one row per component.

## Taxonomy
- [Taxonomy JSON](https://sh4dcn.vercel.app/taxonomy.json): categories + tags with counts.
- [Categories JSON](https://sh4dcn.vercel.app/categories.json) · [Tags JSON](https://sh4dcn.vercel.app/tags.json) · [Sources JSON](https://sh4dcn.vercel.app/sources.json)

## Cloned component source (serve/read same-origin, no upstream fetch)
sh4dcn clones free registries' registry-item JSON locally so you can read component
source without hitting the upstream vendor. Two tiers, and a copy overrides its clone:
- [Clone manifest](https://sh4dcn.vercel.app/clone/manifest.json): what's cloned (verbatim), with per-library counts. Files: /clone/<slug>/index.json, /clone/<slug>/items/<name>.json.
- [Copies manifest](https://sh4dcn.vercel.app/copies/manifest.json): modified versions (empty until edits exist). Files: /copies/<slug>/items/<name>.json — these take precedence over the clone.
- Per-library clone brief: https://sh4dcn.vercel.app/clone/<slug>/PROMPT.md (pull → install → make a modified copy).
- Pro/paid libraries are indexed by URL only; their source is never cloned here.

## How to install components
1. Pick a library from https://sh4dcn.vercel.app/json (or /csv/libraries.csv).
2. Read its brief at https://sh4dcn.vercel.app/md/<slug>.md for the component table, or its clone brief at https://sh4dcn.vercel.app/clone/<slug>/PROMPT.md.
3. Add the whole registry: `npx shadcn@latest add <registry_json_url>` — or a single component with the install command listed per component. Prefer the cloned JSON at /clone/<slug>/items/<name>.json (or a /copies/ override) to avoid re-fetching upstream.

## Source
- [Upstream registry directory](https://github.com/shadcn-ui/ui/blob/main/apps/v4/registry/directory.json)
- [Raw upstream](https://raw.githubusercontent.com/shadcn-ui/ui/main/apps/v4/registry/directory.json)