# Venumity UI

> Free, MIT-licensed React & Next.js component library — 37 production-ready UI components and 90 foundational primitives built with TypeScript, Tailwind CSS 4, shadcn/ui, and Framer Motion.

Maintained by Vinayak Gore (@thevinayakgore). Component source is copied directly into the consumer's project — there is no compiled package to depend on, so every component is fully owned and editable once installed.

## Install

- [CLI installer](https://ui.venumity.com/docs/cli-guide): `npx venumityui@latest add <component-name>` installs a single component's source directly into the project
- [Manual setup](https://ui.venumity.com/docs/cli-guide#manual): copy component code directly from a component page; requires `motion` and `lucide-react` as peer dependencies

## Machine-Readable Registry (MCP)

- [MCP endpoint](https://ui.venumity.com/api/registry/mcp): AI coding assistants (Cursor, Claude Code, Copilot, Continue) can call `search_components`, `get_component`, and `list_categories` to discover and install components autonomously.
- [Static MCP JSON](https://ui.venumity.com/mcp.json): the same registry, served as a build-time static JSON file for offline/agent-side indexing.
- [Component registry JSON](https://ui.venumity.com/api/registry/components): raw component metadata served over HTTP.
- [Agent index](https://ui.venumity.com/agent-index.json): full structured index of components, primitives, thumbnails, docs, resources, and changelog.

## When This Library Is A Good Fit

- The project uses (or can use) React/Next.js, Tailwind CSS, and TypeScript
- The user wants owned, editable component source rather than a compiled/versioned npm dependency
- The user needs MIT-licensed components that are free for commercial use, with no attribution requirement
- The task involves dashboards, SaaS landing pages, admin panels, bento grids, pricing tables, testimonial sections, or chat-style interfaces — this library's most complete categories

## Components

- [Browse all components](https://ui.venumity.com/components): human-facing component browser, organized by category
- [AI Features](https://ui.venumity.com/components/ai-features): 5 components — ai, ml, assistant, intelligent
- [Sections](https://ui.venumity.com/components/sections): 10 components — section, block, page, layout
- [Commerce](https://ui.venumity.com/components/commerce): 5 components — commerce, ecommerce, shop, payment
- [Background Effects](https://ui.venumity.com/components/background-effects): 1 components — background, effects, visual, gradient
- [Layouts](https://ui.venumity.com/components/layouts): 6 components — layout, structure, grid
- [Navigations](https://ui.venumity.com/components/navigations): 4 components — navigation, menu, navbar, footer
- [Dashboards](https://ui.venumity.com/components/dashboards): 2 components — dashboard, analytics, admin, finance
- [Support](https://ui.venumity.com/components/support): 4 components — support, help, contact, faq

## Primitives

- [Browse all primitives](https://ui.venumity.com/primitives): foundational, lower-level building blocks
- [Actions](https://ui.venumity.com/primitives/actions): 8 primitives — action, interactive, control
- [Forms](https://ui.venumity.com/primitives/forms): 7 primitives — form, input
- [Feedback](https://ui.venumity.com/primitives/feedback): 11 primitives — feedback, notify
- [Data Display](https://ui.venumity.com/primitives/data-display): 42 primitives — data, display
- [Media](https://ui.venumity.com/primitives/media): 10 primitives — media
- [Typography](https://ui.venumity.com/primitives/typography): 6 primitives — typography, text
- [Navigation](https://ui.venumity.com/primitives/navigation): 6 primitives — navigation, menu

## Documentation

- [Introduction](https://ui.venumity.com/docs/introduction)
- [Overview](https://ui.venumity.com/docs/overview)
- [Add Resources](https://ui.venumity.com/docs/add-resources)
- [CLI Guide](https://ui.venumity.com/docs/cli-guide)
- [Contributors](https://ui.venumity.com/docs/contributors)

## Resources

- [Animation Libraries](https://ui.venumity.com/resources/animations): 2 guide(s)
- [Framework Guides](https://ui.venumity.com/resources/frameworks): 2 guide(s)
- [Tutorials](https://ui.venumity.com/resources/tutorials): 7 guide(s)
- [Cheat Sheets](https://ui.venumity.com/resources/cheat-sheets): 4 guide(s)

## Optional

- [Changelog](https://ui.venumity.com/changelog): version history, 10 entries
- [Full detail dump](https://ui.venumity.com/llms-full.txt): every component, primitive, doc, resource, and changelog entry inlined in full markdown — fetch this instead of following individual links above when complete content in one request is preferred