# Lerpa UI

> Free, open-source React component library: 1179 copy-paste components across 16 categories plus 178 page blocks, distributed through a shadcn-compatible registry and CLI. Built with Next.js 16, React 19, Tailwind CSS v4, TypeScript, Framer Motion, and Radix UI. MIT licensed.

Components are copy-paste: install one with `pnpm dlx lerpa-cli add <id>` or `npx shadcn add https://lerpaui.com/r/<id>.json`. Every component is accessibility-minded, respects `prefers-reduced-motion`, and is themed through CSS variables / design tokens (never inline styles). For the complete machine-readable catalog with every component and description, read /llms-full.txt.

## Docs
- [Introduction](https://lerpaui.com): What Lerpa UI is and how copy-paste install works.
- [Documentation](https://lerpaui.com/docs): Install, configure, theme, and use the CLI.
- [Installation](https://lerpaui.com/docs/installation): Set up the CLI and add your first component.
- [Component gallery](https://lerpaui.com/gallery/components): Browse every component by category.
- [Page blocks](https://lerpaui.com/gallery/blocks): Multi-component marketing/app sections.
- [Use with AI](https://lerpaui.com/ai-builder): MCP server config and copy-paste prompts for Claude, Cursor, and v0.
- [MCP server](https://lerpaui.com/docs/mcp): Let agents search and install components by natural language.
- [llms.txt guide](https://lerpaui.com/docs/llms): How Lerpa UI exposes its catalog to AI tools.
- [Theme Studio](https://lerpaui.com/theme-studio): Visual design-token / theme editor.
- [Accessibility](https://lerpaui.com/accessibility): The a11y standard every component meets.
- [Blog](https://lerpaui.com/blog): Guides and comparisons (vs shadcn/ui, Material UI, Chakra UI, Ant Design, Tailwind UI).

## Install
- CLI: `pnpm dlx lerpa-cli add <component-id>`
- shadcn registry: `npx shadcn add https://lerpaui.com/r/<component-id>.json`
- MCP server: `@lerpa/mcp-server` — lets agents browse, search, and install components by natural language.

## Conventions
- Accessibility is a hard requirement: semantic elements, visible focus rings, correct ARIA.
- All animation respects `prefers-reduced-motion`.
- Theme via CSS variables / design tokens — never inline style overrides.
- Compose primitives; do not add dependencies outside the peer set (React 19, Tailwind v4, Framer Motion, Radix).

## Components
- [Account & Settings](https://lerpaui.com/gallery/account): 8 components.
- [AI Interfaces](https://lerpaui.com/gallery/ai): 95 components.
- [Authentication](https://lerpaui.com/gallery/auth): 18 components.
- [Blog & Content](https://lerpaui.com/gallery/blog): 9 components.
- [Buttons & Inputs](https://lerpaui.com/gallery/buttons): 51 components.
- [Calendars & Dates](https://lerpaui.com/gallery/calendars): 14 components.
- [Cards & Data Display](https://lerpaui.com/gallery/cards): 111 components.
- [Charts](https://lerpaui.com/gallery/charts): 24 components.
- [Creative & Motion FX](https://lerpaui.com/gallery/creative): 480 components.
- [Dashboard](https://lerpaui.com/gallery/dashboard): 32 components.
- [Docs & Reference](https://lerpaui.com/gallery/docs): 20 components.
- [Ecommerce](https://lerpaui.com/gallery/ecommerce): 62 components.
- [Feedback & Status](https://lerpaui.com/gallery/feedback): 19 components.
- [Forms](https://lerpaui.com/gallery/forms): 200 components.
- [Navigation](https://lerpaui.com/gallery/navigation): 26 components.
- [Tables & Data Grids](https://lerpaui.com/gallery/tables): 10 components.

## Optional
- [Full component catalog](https://lerpaui.com/llms-full.txt): Every component with description and install command.