Axie UI is the performative UI library for React product apps. It ships as a normal package and as a shadcn-style registry, so teams can either import components from axie-ui or copy the source into their app when they want full ownership.
- 36 React primitives for forms, navigation, overlays, feedback, data display, and mobile surfaces.
- Theme tokens for color, radius, spacing, elevation, and motion.
- A Next.js docs app with examples, recipes, templates, search, and registry output.
- Agent-friendly docs through
llms.txtand predictable registry URLs.
Use the package when you want stable imports and npm updates.
pnpm add axie-ui@import "tailwindcss";
@import "axie-ui/styles.css";
@source "../node_modules/axie-ui/dist";import { Button, Field, Input } from "axie-ui";Use the registry when you want the component source copied into your app.
pnpm dlx shadcn@latest add https://axie.alexi.life/r/button.jsonAfter adding the namespace once, shorthand installs work too.
pnpm dlx shadcn@latest registry add @axie=https://axie.alexi.life/r/{name}.json
pnpm dlx shadcn@latest add @axie/buttonButton, Input, Autocomplete, Input OTP, Field, Checkbox, Switch, Segmented Control, Tabs, Accordion, Command Menu, Dialog, Select, Radio Group, Card, Alert, Badge, Avatar, Breadcrumb, Popover, Progress, Slider, Pagination, Stepper, Table, List Row, Empty State, Skeleton, Kbd, Mobile Dock, Code Block, Bottom Sheet, Tooltip, Toast, Separator, and Stat.
apps/docs Next.js documentation site
packages/ui axie-ui React package
packages/registry component catalog shared by docs, search, and registry builds
registry generated shadcn registry sourceThe component catalog lives in packages/registry/src/component-catalog.json. Rich docs live in apps/docs/content/component-docs/*.tsx, one file per component.
pnpm install
pnpm dev
pnpm typecheck
pnpm buildBuild the shadcn-compatible registry files with:
pnpm registry:buildThis writes registry/registry.json and emits static component entries to apps/docs/public/r.