shadcn-ui / ui
Composable, accessible components with thoughtful defaults. Build your own component library with code you can customize, extend, and make your own.
github.com/shadcn-ui/uiIndexed at db2db46Up to date with upstreamRefreshes weekly
About this codebase
`ui` is a customizable component-library monorepo that delivers shadcn/ui end-to-end by ingesting design-system source assets (templates and primitives), indexing and registering component schemas, and producing published component “entrypoints” plus documentation-ready artifacts for developers to use and extend. In practice, authors and consumers move through a pipeline that starts with templates (for bootstrapping apps/monorepos) and component/registry inputs, then runs through schema/registry transformation and proxy/theme tooling, and finally emits structured packages and doc-friendly outputs that power the public docs experience and “make it your own” workflows.
Written by gpt-5.4-nano from the index
5,069 files and 10,497 symbols in 6 modules, led by TypeScript (3,757 files) and JavaScript (28).
Start reading
Code health
This codebase scores 8.3 out of 10 for code health, which we rate good. It also scores maintainability 8.9 and static performance 9.9 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 56 of 5,069 files are git hotspots, and they average 5.0 — which is where the fixes pay off most.
On the leaderboards:#3 of 37 TypeScript repos
Do next
3 things worth doing this quarter.
Worth planning
Fix 2 broken references in
apps/v4/content/docs/registry/namespace.mdxThe document points readers and agents at paths this repository no longer has.
- broken references
- 2
- first
- apps/v4/content/docs/registry/namespace.mdx#built-in-registries
Small effortFix 1 broken reference in
apps/v4/content/docs/registry/registry-index.mdxThe document points readers and agents at a path this repository no longer has.
- broken references
- 1
- first
- apps/v4/registry/directory.json
Small effortDelete 2 unused symbols and files (65 lines)
Nothing in the graph reaches them, across 2 files; every reader and agent pays to skip them.
- symbols
- 2
- lines
- 65
- safe to delete
- Yes(inferred)
Small effort
Use shadcn-ui/ui in your agent
Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.
https://api.repowise.dev/mcp/shadcn-ui/uiOne command, run anywhere. Adds the server to your local Claude Code config.
Docsclaude mcp add --transport http repowise https://api.repowise.dev/mcp/shadcn-ui/ui \ --header "Authorization: Bearer rw_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
This repo is public, so anyone with a Repowise account and an API key can connect.
Try asking
- get_overview()
- get_answer("how is ui put together?")
- get_why("why is ui structured this way?")
Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.
Go deeper
- OverviewEverything the index found, what changed this week, commits and decisions.
- DocumentationModule-by-module documentation, 4,238 pages, 71 written by a model.
- ArchitectureDependency graph, layers and third-party dependencies.
- Code healthEvery file's score, the findings behind it, tests and refactoring plans.
- CommitsEach commit's effect on code health, with agent provenance.
- ContributorsWho owns what, and where one person holds most of the knowledge.
- DecisionsArchitectural decisions mined from commits and pull requests.
- Ask this codebaseSign inGrounded answers over the indexed code.
Maintain this repo? Claim the page
Sign in with GitHub and we check that you are an admin or maintainer of shadcn-ui/ui. Then add a badge to the README that links readers here.
Use this repo from Claude or ChatGPT
Add this URL as a custom connector and sign in with repowise when asked. No API key to copy.
https://api.repowise.dev/mcp/shadcn-ui/uiFor maintainers
Add a badge to your README
Every badge is public, cached, and updates on its own after every index. Nothing to install.
Repowise badge
Links to this page, with no score on it. Adding it also re-indexes the repo every week.
[](https://repowise.dev/repo/shadcn-ui/ui?src=badge_wiki)Code health badge
The repo's health score out of 10, from the latest index.
[](https://repowise.dev/repo/shadcn-ui/ui?src=badge_health)Code health card
A larger card with the score, its change since the last index, and when it was measured. The HTML version follows the reader's light or dark theme.
[](https://repowise.dev/repo/shadcn-ui/ui?src=badge_card)How shadcn-ui/ui works
Composable, accessible components with thoughtful defaults. Build your own component library with code you can customize, extend, and make your own. This page is a map of the shadcn-ui/ui repository, written primarily in TypeScript, rebuilt from the source each time it is indexed. Repowise parses every symbol, computes a dependency graph, scores per-file code health from complexity, duplication, test coverage and churn, mines git history for hotspots and ownership, and lifts the architectural decisions into documentation you can read here or query through MCP.
The codebase has 5,069 files and 10,497 symbols in 6 modules, led by TypeScript, JavaScript and Dockerfile. Code health is 8.3 out of 10, rated good.
Use the links above to open each view, or connect this repository to your agent for grounded answers inside Claude, Cursor, Codex or VS Code.