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-05 · 292 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
# 292 shadcn-compatible registries · generated 2026-09-05

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 + 292 per-library)

path	format	size	description
/json	json	—	Full agent directory: every library + component with URLs, commands, pro info.
/agent-directory.json	json	14.7 MB	Same document as /json, served as a static file.
/directory.json	json	7.3 MB	Legacy enriched directory shape (back-compat).
/directory.md	markdown	782 KB	Full directory as one Markdown document.
/libraries.json	json	1.9 MB	Normalized library records.
/components.json	json	1.3 MB	Inverted index: component name -> libraries that ship it.
/components.md	markdown	896 KB	Component index as Markdown.
/components-full.json	json	19.2 MB	Flattened per-component records across all libraries.
/taxonomy.json	json	6 KB	Categories + tags with counts.
/categories.json	json	9 KB	Category index with member library ids.
/tags.json	json	76 KB	Tag index with member library ids.
/sources.json	json	43 KB	Source-host index.
/llms.txt	text	4 KB	AI-agent entry point listing every machine-readable artifact.
/md/index.md	markdown	29 KB	Index of all per-library Markdown files.
/csv/libraries.csv	csv	237 KB	One row per library.
/csv/components.csv	csv	9.4 MB	One row per component.
/csv/files.csv	csv	55 KB	This file: index of every published artifact.

Plus one Markdown brief per library at /md/<slug>.md (292 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/react-bits/index.json— a library's registry listing (verbatim)

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

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

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

96 libraries · 8,498 components · 83 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/1st-pouf— human-readable detail page

https://sh4dcn.vercel.app/md/1st-pouf.md— agent-readable Markdown brief

https://sh4dcn.vercel.app/json— full record under libraries[] where slug == "1st-pouf"

Source

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