ndekoui
Open-source React components that animate every change of state: 685 components, 66 blocks and 10 templates on Base UI, motion and Tailwind CSS 4. Install with the shadcn CLI or through MCP.
Install / Use
claude mcp add NdekoCode -- npx -y github:NdekoCode/ndekouiIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of ndekoui
ndekoui scores 76/100 on our quality scale, 3753rd of 4,705 Development & Engineering skills we index.
Its MCP Server is 4.6 KB long, well organised into 8 sections with 3 code examples: a solid amount of guidance for an agent.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 2 days ago, so ndekoui is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
ndekoui compared with similar skills
All 4 of these similar skills score higher than ndekoui; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| ndekoui (this skill)by NdekoCode | 76 | 10 | 2d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
Frequently asked questions
- How do I install ndekoui?
- Run
claude mcp add NdekoCode -- npx -y github:NdekoCode/ndekoui. The install tabs above show the steps for each supported agent. - Which AI agents does ndekoui work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is ndekoui safe to use?
- It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is ndekoui still maintained?
- The repository was last updated 2 days ago, so ndekoui is actively maintained.
Skill content
View source on GitHubndekoui
Open-source React components that animate every change of state. <!-- count:components -->842 component variants across 49 families<!-- /count -->, <!-- count:motion -->75<!-- /count --> motion effects, <!-- count:blocks -->150<!-- /count --> blocks, <!-- count:templates -->21<!-- /count --> templates and <!-- count:primitives -->90<!-- /count --> 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
What is in it
- Primitives: <!-- count:primitives -->90<!-- /count --> accessible building blocks on Base UI (button, field, select, menu, dialog, sheet, tabs, slider, chat input...). Try them at /kit.
- Components: <!-- count:components -->842 component variants across 49 families<!-- /count -->, from inputs and date pickers to charts, text effects, notifications, comments and team lists. Browse them at /components.
- Blocks: <!-- count:blocks -->150<!-- /count --> whole sections of a product (app shells, boards, task lists, dashboards, billing, settings, pricing, heroes, testimonials, team sections, blog, docs, help center, error pages, agent chats, agent reviews, agent operations, workflows, maps...). See them at /blocks.
- Templates: <!-- count:templates -->21<!-- /count --> complete pages in <!-- count:template-kinds -->14<!-- /count --> kinds, from sign in and settings to dashboards, agent workspaces and docs, at /templates.
- Motion: <!-- count:motion -->75<!-- /count --> effects, from text effects and scroll animations to marquees, device frames and more, documented at /docs.
- Theme: light and dark tokens, ink colours that pass AA, one-pixel hairlines and a few 3D materials, installed with every item, plus <!-- count:themes -->9<!-- /count --> colour themes to pick from at /themes.
Install a component
Every item is a shadcn registry item, listed in the shadcn registry directory as @ndeko. In a project set up with the shadcn CLI, React 19 and Tailwind CSS 4:
npx shadcn@latest add @ndeko/notification-28
The theme, the cn helper and every primitive the item uses come with it, and imports are rewritten to your own aliases. There is nothing to declare in components.json: the CLI adds the @ndeko entry itself the first time.
In a project fresh from shadcn init, the CLI asks whether to replace lib/utils.ts and components/ui/button.tsx: answer yes, or add --overwrite to the command. The items are built on the ndekoui button and on a cn helper that knows the hairline classes of the theme. If you have edited those two files, keep your copy and check that the item still looks right.
With an older shadcn CLI that does not read the registry directory, give it the full address of the item:
npx shadcn@latest add https://ui.ndekocode.dev/r/notification-28.json
Use it from your editor
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.
Develop
pnpm install
pnpm dev # the site on http://localhost:3000
pnpm typecheck
pnpm lint
pnpm registry:build # registry.json, preview indexes and public/r
pnpm stats:readme # the counts in this README, from registry.json
Node.js 24 and pnpm are required.
Design system
The rules every item follows (tokens, lines, materials, motion, writing) are in docs/DESIGN-SYSTEM.md.
Contributing
Read the contributing guide and the port checklist in docs/ROADMAP.md.
Credits and licence
ndekoui is MIT licensed, see LICENCE.md. Inspired by Motion Primitives by ibelick; the notices of the code and of the brand marks it carries are in THIRD_PARTY_NOTICES.md.
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
