dev.ndekocode.uiPublished by ui.ndekocode.devOfficial publisherv1.0.0Updated Nov 7, 2026
Search, read and install ndekoui React components, blocks and templates with the shadcn CLI.
Searches the ndekoui React component registry, returns item source and shadcn install commands, and shares its design rules.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/dev.ndekocode.ui%2Fndekoui/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"ndekoui": {
"type": "http",
"url": "https://ui.ndekocode.dev/mcp"
}
}
}Open-source React components that animate every change of state. 685 components in 36 categories, 66 blocks, 10 templates and 72 primitives, built on Base UI, motion and Tailwind CSS 4, installed with the shadcn CLI or through an MCP server.
Site and catalogue: ui.ndekocode.dev
Every item is a shadcn registry item. In a project set up with the shadcn CLI, React 19 and Tailwind CSS 4:
The theme, the cn helper and every primitive the item uses come with it, and imports are rewritten to your own aliases.
To use the short form, declare the registry in components.json:
The MCP server at https://ui.ndekocode.dev/mcp lets Claude, Claude Code, Codex, Cursor, VS Code, Windsurf, Zed and other MCP clients search the catalogue, read the source of an item, get its install command and follow the design rules. Setup for each client: ui.ndekocode.dev/mcp/connect.
For language models, the catalogue is also described in llms.txt and, item by item, in llms-full.txt. The registry index is at r/registry.json.
Node.js 24 and pnpm are required.
The rules every item follows (tokens, lines, materials, motion, writing) are in docs/DESIGN-SYSTEM.md.
Read the contributing guide and the port checklist in docs/ROADMAP.md.
ndekoui is MIT licensed, see LICENCE.md. It started from Motion Primitives by ibelick and redraws compositions from the MIT edition of Origin UI; their notices and those of the brand marks are in THIRD_PARTY_NOTICES.md.
Source: README.md at commit 45e2f02
Search items
Search the ndekoui registry by words, ranked like the search on ui.ndekocode.dev: titles first, then names, groups and descriptions. Use it before list_items when you know what you need ("pricing", "date range", "kanban"). Filter by kind: primitive, component, block, template, motion or lib.
kindlimitqueryrequiredList items
List ndekoui registry items of one kind. Kinds: primitive (Base UI building blocks such as button or dialog), component (ready compositions such as accordion-01), block (product sections such as heroes-01), template (whole pages), motion (animation components) and lib (theme, utilities, icons, sample images, hooks). Narrow with category: a category or group slug such as accordion, heroes or application, or a component family such as forms or overlays. Paged with offset and limit.
kindrequiredlimitoffsetcategoryGet item
Get one ndekoui item by name: the full source of its files, its npm dependencies, the registry items it pulls in, the shadcn command that installs it and its page on ui.ndekocode.dev. Large templates return the source of their first files and list the rest; pass file with a path from that list to read one file.
filenamerequiredGet install command
Build the shadcn CLI command that installs one or more ndekoui items, for npm, pnpm, yarn or bun. Returns the command with full registry URLs, which works in any shadcn project, and the shorter @ndeko form for projects whose components.json declares the namespace.
namesrequiredpackageManagerGet theme
Summarise the theme item every ndekoui piece depends on: the colour tokens with their light and dark values, the radius and easing tokens, and the utilities it adds (hairlines, chip-3d, keycap-3d, gem-plate, surface-raised, surface-brand). Read it before changing colours or writing new styles.
Takes no parameters.
Get design guidelines
The rules for writing UI that looks and moves like ndekoui: surfaces and hairlines, radius, colour, type, how to compose the Base UI primitives, the motion signatures and their timing, and what to avoid. Call it once before writing UI. Pass section with a number or a title ("7", "motion") to read one section of the design system in full, or "all" for the whole document.
sectionList categories
The map of the ndekoui catalogue with counts: primitive groups, component families and their categories, block groups, template groups, motion groups and library items. Use the slugs it returns as the category of list_items.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
npx shadcn@latest add https://ui.ndekocode.dev/r/notification-28.json{ "registries": { "@ndeko": "https://ui.ndekocode.dev/r/{name}.json" }}npx shadcn@latest add @ndeko/notification-28pnpm installpnpm dev # the site on http://localhost:3000pnpm typecheckpnpm lintpnpm registry:build # registry.json, preview indexes and public/r