sh4dcn(7)

agents

Machine-readable twins of every listing — JSON, Markdown, CSV. Upstream directory.json is re-fetched and AI-enriched daily (06:00 UTC); last sync 2026-09-21 · 373 libraries.

Start here

agent directory

Merged libraries + components with install/clone URLs

/json

libraries.json

Normalized library records (categories, tags, health)

/libraries.json

directory.json

Legacy enriched shape — back-compat with older agents

/directory.json

components-full.json

Every component row with registry + item URL

/components-full.json

taxonomy.json

Controlled vocabulary for categories and tags

/taxonomy.json

llms.txt

AI-agent entry point pointing at the feeds above

/llms.txt

Synopsis

# sh4dcn — instructions for AI coding agents
# 373 shadcn-compatible registries · generated 2026-09-21

1. Read the directory:      curl -s https://sh4dcn.vercel.app/json
   (lighter tabular form:   curl -s https://sh4dcn.vercel.app/csv/libraries.csv)
2. Pick a library and read its brief:
                            curl -s https://sh4dcn.vercel.app/md/<slug>.md
3. Pull component source WITHOUT hitting the upstream vendor — sh4dcn clones
   the free registries locally, in two tiers:
     clone (verbatim):      curl -s https://sh4dcn.vercel.app/clone/<slug>/items/<name>.json
     copies (modified):     curl -s https://sh4dcn.vercel.app/copies/<slug>/items/<name>.json
     per-library brief:     curl -s https://sh4dcn.vercel.app/clone/<slug>/PROMPT.md
     what's cloned:         curl -s https://sh4dcn.vercel.app/clone/manifest.json
     what's modified:       curl -s https://sh4dcn.vercel.app/copies/manifest.json
   Precedence when applying: a /copies/ version overrides its /clone/, which
   overrides a live fetch. Clones stay pristine; copies hold your edits.
4. Install into a shadcn project:
                            npx shadcn@latest add <registry_json_url>
   ...or one component using the install_command listed per component.
5. Never scrape the HTML UI — every page here has a machine-readable twin.
   Full artifact index:     https://sh4dcn.vercel.app/csv/files.csv

Ground rules

Directory and component listing only — not the official shadcn/ui library, not a clone of its website.
Read the structured files; do not scrape this UI.
Every library lists website, GitHub repo, components folder, registry JSON, install commands, tags, and pro/paid-tier info when one exists.
Pro tiers are indexed as metadata (URL + pricing link) only — paid component source is not mirrored here.

Files (17 global + 373 per-library)

path	format	size	description
/json	json	—	Full agent directory: every library + component with URLs, commands, pro info.
/agent-directory.json	json	18.0 MB	Same document as /json, served as a static file.
/directory.json	json	9.0 MB	Legacy enriched directory shape (back-compat).
/directory.md	markdown	943 KB	Full directory as one Markdown document.
/libraries.json	json	2.4 MB	Normalized library records.
/components.json	json	1.5 MB	Inverted index: component name -> libraries that ship it.
/components.md	markdown	1.1 MB	Component index as Markdown.
/components-full.json	json	23.4 MB	Flattened per-component records across all libraries.
/taxonomy.json	json	6 KB	Categories + tags with counts.
/categories.json	json	10 KB	Category index with member library ids.
/tags.json	json	92 KB	Tag index with member library ids.
/sources.json	json	54 KB	Source-host index.
/llms.txt	text	4 KB	AI-agent entry point listing every machine-readable artifact.
/md/index.md	markdown	36 KB	Index of all per-library Markdown files.
/csv/libraries.csv	csv	271 KB	One row per library.
/csv/components.csv	csv	11.5 MB	One row per component.
/csv/files.csv	csv	69 KB	This file: index of every published artifact.

Plus one Markdown brief per library at /md/<slug>.md (373 files) — frontmatter metadata, install commands, the full component table, and agent instructions.

Cloned component source (clone + copies)

To spare the upstream registries (and to keep working offline), sh4dcn clones each free library's registry-item JSON into this repo in two tiers: clone (verbatim upstream source) and copies(modified versions). A copy overrides its clone; the clone stays pristine. Read it same-origin instead of re-fetching from the vendor:

https://sh4dcn.vercel.app/clone/manifest.json— index of everything cloned, with per-library counts

https://sh4dcn.vercel.app/copies/manifest.json— index of modified versions (empty until edits exist)

https://sh4dcn.vercel.app/clone/shadcn/index.json— a library's registry listing (verbatim)

https://sh4dcn.vercel.app/clone/shadcn/items/<name>.json— one component's registry-item JSON (source included)

https://sh4dcn.vercel.app/clone/shadcn/PROMPT.md— per-library clone brief (pull → install → modify)

https://sh4dcn.vercel.app/copies/shadcn/items/<name>.json— a modified version, when one has been added

96 libraries · 8,042 components · 96 MB cloned · 8 modified copies. Pro/paid tiers are indexed by URL only — their source is never cloned here.

Per-library deep links

https://sh4dcn.vercel.app/registry/shadcn— human-readable detail page

https://sh4dcn.vercel.app/md/shadcn.md— agent-readable Markdown brief

https://sh4dcn.vercel.app/json— full record under libraries[] where slug == "shadcn"

Source

Upstream: shadcn-ui/ui · apps/v4/registry/directory.json · refreshed daily at 06:00 UTC · 373 libraries