llms.txt
Compare with other sites' llms.txt files →# Arc
> Arc is a React component and block library designed for AI-assisted frontend development. It provides copy-paste components, complete interface blocks, machine-readable registry metadata, AI skills, and MCP compatibility. Components and blocks share design tokens, CSS modules, and Motion. Free items install with the shadcn CLI from a public registry; Pro items are licensed and install from the token-gated @uiarc-pro registry.
Arc has 242 components and 141 blocks. 121 components and 22 blocks are free and open source (MIT); 121 components and 119 blocks are Arc Pro. Arc Pro costs $149 per year or $249 once for lifetime access, and a team plan covers up to 10 people for $799 once or $449 per year. Plans: https://uiarc.dev/pricing. Component links point to per-component markdown with when to use it, when not to, usage, props, keyboard, accessibility, motion, responsive, and performance notes. Block links point to per-block markdown with variants, props, sample data, and install notes.
## Install
Arc items are shadcn-compatible registry items. Each one pulls in the motion presets (`arc-motion-tokens`) and any Arc components it builds on. The design tokens (`arc-foundation`, `foundation.css`) install once per app, and no item reinstalls them.
```bash
npx shadcn@latest add https://uiarc.dev/r/arc-foundation.json
npx shadcn@latest add https://uiarc.dev/r/button.json
```
Or register the namespace once in `components.json` and install by name:
```json
{ "registries": { "@uiarc": "https://uiarc.dev/r/{name}.json" } }
```
```bash
npx shadcn@latest add @uiarc/button @uiarc/dialog
```
Import the tokens once in the root layout: `import "@/components/arc/foundation.css";`. Files install into an `arc/` folder under the `components` alias from `components.json` (for example `components/arc/button/button.tsx`, or `src/components/arc/…` in a `src/` project or a monorepo package) and import each other with relative paths, so no `tsconfig.json` change is needed. Import them from there: `import { Button } from "@/components/arc/button/button";`. Components use CSS modules and CSS variables, not Tailwind classes. Dark mode: `data-theme="dark"` on `<html>`. Accent: `data-accent` = neutral, violet, blue, green, amber, orange, coral, or rose.
### Pro items
Pro components, blocks, and templates install from the token-gated `@uiarc-pro` registry. A Pro member creates a token (`arc_pro_…`) at https://uiarc.dev/account#pro-access, sets `ARC_PRO_TOKEN` in the environment or `.env.local` (never committed), and adds the registry to `components.json`:
```json
{ "registries": { "@uiarc": "https://uiarc.dev/r/{name}.json", "@uiarc-pro": { "url": "https://uiarc.dev/r/pro/{name}.json", "headers": { "Authorization": "Bearer ${ARC_PRO_TOKEN}" } } } }
```
```bash
npx shadcn@latest add @uiarc-pro/dock
```
The MCP server unlocks Pro for a Pro account that signed in through the MCP client (OAuth), or with the same token as `Authorization: Bearer …`: `get_component` then returns Pro source and `get_install_command` returns `@uiarc-pro` commands. Without Pro access, never reconstruct a Pro item; offer a free alternative or https://uiarc.dev/pricing. Setup: https://uiarc.dev/docs/ai#pro-access
## Rules for agents
- Prefer an existing Arc component or block over writing a new one; compose blocks from Arc components.
- Read the component's markdown before using it; use only documented props.
- Keep semantic HTML, keyboard behavior, and a reduced-motion branch for every animation.
- Use the semantic tokens (`--background`, `--surface`, `--foreground`, `--text-secondary`, `--border`, `--accent`, `--success`, `--warning`, `--danger`) instead of raw colors, and check light and dark themes.
- Use motion presets from `components/arc/lib/motion-tokens.ts` (`snappy` for presses, `smooth` for panels, `morph` for shared highlights). Motion should explain cause and effect.
- Sentence case copy, regular and medium weights only, no eyebrow labels, no em dashes, no focus rings on pointer focus (keyboard focus gets the shared :focus-visible ring), no decorative gradients or glows.
- Pro items are licensed: never reconstruct their source; point people to the pricing page.
## Skills
Install every free skill file with `npx shadcn@latest add https://uiarc.dev/r/arc-skill.json`, or read them directly:
- [SKILL.md](https://uiarc.dev/r/skills/arc/SKILL.md): Entry point: workflow, principles, never-do list, and quick decisions
- [INSTRUCTIONS.md](https://uiarc.dev/r/skills/arc/INSTRUCTIONS.md): Short always-on rules for AGENTS.md, CLAUDE.md, or Cursor rules
- [checklist.md](https://uiarc.dev/r/skills/arc/checklist.md): The review loop to run before finishing, with grep sweeps
- [components.md](https://uiarc.dev/r/skills/arc/components.md): Choosing the right component or block by job, with ids
- [composition.md](https://uiarc.dev/r/skills/arc/composition.md): Page containers, dashboards, marketing sections, states, React correctness
- [copy.md](https://uiarc.dev/r/skills/arc/copy.md): Sentence case, no eyebrows or em dashes, verbs on buttons, honest claims
- [design.md](https://uiarc.dev/r/skills/arc/design.md): Color, type, surfaces, concentric radii, spacing, and icons
- [motion.md](https://uiarc.dev/r/skills/arc/motion.md): Motion tokens, spring choice, patterns with code, reduced motion
- [accessibility.md](https://uiarc.dev/r/skills/arc/accessibility.md): Focus without rings, semantics, keyboard, and announcements
- [responsive.md](https://uiarc.dev/r/skills/arc/responsive.md): Widths to check, overflow, tables, and touch targets
- [example-settings.md](https://uiarc.dev/r/skills/arc/example-settings.md): A worked account settings page
- [example-pricing.md](https://uiarc.dev/r/skills/arc/example-pricing.md): A worked pricing section with plans, comparison, and FAQ
- [example-dashboard.md](https://uiarc.dev/r/skills/arc/example-dashboard.md): A worked analytics overview with KPIs, chart, and table
Pro skills (Arc Pro, served to signed-in Pro members at https://uiarc.dev/api/skills):
- Arc Pro skill: Entry point: picks the right Pro workflow and sets up Pro access
- Full-page generation: Brief, plan region by region with every state, build, and verify a whole page, or stop at the plan
- Design system generation: A brand theme on Arc tokens with contrast checked in both themes
- Refactor to Arc: Migrate custom, shadcn/ui, MUI, or Chakra UI to Arc with parity checks
- Motion audit: Inventory every animation, assign tokens, cut motion that explains nothing
- Responsive audit: Measure five widths, fix overflow, layout, and touch, then re-measure
- Accessibility audit: A ranked audit of structure, keyboard, contrast, and motion with patches
## Guides
- [All guides](https://uiarc.dev/guides): Step-by-step builds with Arc components and blocks
- [SaaS dashboard in React](https://uiarc.dev/guides/saas-dashboard-react): Shell, metrics, tables, and states for a product dashboard
- [React motion: springs and reduced motion](https://uiarc.dev/guides/react-motion-springs-reduced-motion): Choosing springs and writing a reduced-motion branch
- [shadcn registry for AI coding tools](https://uiarc.dev/guides/shadcn-registry-ai-coding-tools): Installing Arc through the registry, MCP, and llms.txt
- [React settings page](https://uiarc.dev/guides/react-settings-page): Forms, switches, and destructive actions on one settings screen
- [Onboarding flows](https://uiarc.dev/guides/onboarding-flows): Multi-step setup with progress and in-place confirmation
- [React command menu](https://uiarc.dev/guides/react-command-menu): A keyboard-first command palette for global search and actions
- [Best React component libraries in 2026](https://uiarc.dev/guides/best-react-component-libraries): How shadcn/ui, Magic UI, Aceternity UI, React Bits, HeroUI, Mantine, MUI and Arc differ, and when to pick each
- [Best UI library for AI coding agents](https://uiarc.dev/guides/best-ui-library-for-ai-coding-agents): What makes a library agent-friendly: registry, MCP server, llms.txt, per-component markdown
## Comparisons
- [Compare Arc](https://uiarc.dev/compare): Fact tables against other React UI libraries, with the date each fact was checked
- [Arc vs Magic UI](https://uiarc.dev/compare/magic-ui): Stack, license, free and paid items, install method and AI support
- [Arc vs Aceternity UI](https://uiarc.dev/compare/aceternity-ui): Stack, license, free and paid items, install method and AI support
- [21st.dev alternative](https://uiarc.dev/compare/21st-dev): Arc compared with the 21st.dev community registry
## Templates
- [Templates](https://uiarc.dev/templates) (Pro): Complete starter apps built from Arc blocks
- [Arc CRM](https://uiarc.dev/templates/arc-crm) (Pro): Relay, a clean CRM for sales teams: companies, company records, people, a deals pipeline and a linked inbox
## Docs
- [AI setup](https://uiarc.dev/docs/ai): Connect the MCP server, install the agent skill, and use the registry
- [Agent skill](https://uiarc.dev/r/skills/arc/SKILL.md): Drop-in SKILL.md for Claude Code and other agents (install with `npx shadcn@latest add https://uiarc.dev/r/arc-skill.json`)
- [Agent instructions](https://uiarc.dev/r/skills/arc/INSTRUCTIONS.md): The rules to keep in AGENTS.md, CLAUDE.md, or Cursor rules
- [Skill index](https://uiarc.dev/r/skills/index.json): Every skill file as JSON
- [MCP server](https://uiarc.dev/api/mcp): Streamable HTTP endpoint with list, search, get, install, and skill tools. Clients sign in with an Arc account over OAuth (a free account is enough; Pro source unlocks from the plan)
- [Registry index](https://uiarc.dev/r/registry.json): shadcn registry of every installable item
- [Catalog](https://uiarc.dev/r/catalog.json): Machine-readable metadata for every component and block, including Pro
- [Full context](https://uiarc.dev/llms-full.txt): This file with every component's markdown inlined
- [Small context](https://uiarc.dev/llms-small.txt): Overview, install, and one line per item, for small context windows
## Components
### Actions
- [Button](https://uiarc.dev/components/button/markdown): A clear, responsive action with quiet secondary states.
- [Action button](https://uiarc.dev/components/action-button/markdown): A compact button for frequent toolbar actions.
- [Split button](https://uiarc.dev/components/split-button/markdown): A primary action with a menu of nearby alternatives.
- [Button group](https://uiarc.dev/components/button-group/markdown): Related actions joined into one surface with hairline dividers: a hover highlight glides between segments, the pressed one answers in place, and an attached menu can close the row.
- [Floating button group](https://uiarc.dev/components/floating-button-group/markdown): Separate soft buttons in a quiet tray, with one shared highlight that morphs from button to button as you move, and a pressed state that settles in place.
- [Expanding button group](https://uiarc.dev/components/expanding-button-group/markdown): Icon buttons in a compact group: the one you point at or focus grows to reveal its label while its neighbours slide aside, and an action confirms in place.
- [Copy button](https://uiarc.dev/components/copy-button/markdown): Copy a value with immediate confirmation.
- [Action swap](https://uiarc.dev/components/action-swap/markdown): Swap an action label while preserving its place and intent.
- [Icon morph](https://uiarc.dev/components/icon-morph/markdown): Icons that morph between states: menu to close, play to pause, copy to check, and more.
- [Confirm morph](https://uiarc.dev/components/confirm-morph/markdown): A destructive button that morphs into an inline confirmation, a spinner, and a result with undo.
- [Hold to confirm](https://uiarc.dev/components/hold-to-confirm/markdown): Confirm a destructive action by holding, not tapping.
- [Swipe actions](https://uiarc.dev/components/swipe-actions/markdown): Reveal row actions with a swipe, or from the same actions in a menu.
- [Reactions](https://uiarc.dev/components/reactions/markdown): Acknowledge a post in one tap, with counts that roll.
- [Dropdown menu](https://uiarc.dev/components/dropdown-menu/markdown): A focused list of actions anchored to a trigger.
- [Context menu](https://uiarc.dev/components/context-menu/markdown): Secondary actions kept close to the selected object.
- [User menu](https://uiarc.dev/components/user-menu/markdown): Your account, settings, theme, and sign out behind the avatar. Opens as a bottom sheet on phones.
- [Theme switcher](https://uiarc.dev/components/theme-switch/markdown): Four smooth ways to move between light and dark appearance.
- [Eclipse](https://uiarc.dev/components/theme-switch-eclipse/markdown): The next appearance crosses the page like an eclipse.
- [Split](https://uiarc.dev/components/theme-switch-split/markdown): The next appearance opens from a slim center seam.
- [Rise](https://uiarc.dev/components/theme-switch-rise/markdown): The next appearance rises into place.
### Inputs
- [Input](https://uiarc.dev/components/input/markdown): A single line field with clear labels and useful states.
- [Textarea](https://uiarc.dev/components/textarea/markdown): A multiline field for notes, descriptions, and longer text.
- [Password field](https://uiarc.dev/components/password-field/markdown): Capture sensitive text with a visible reveal control.
- [Password strength](https://uiarc.dev/components/password-strength/markdown): Show how strong a new password is while it is typed.
- [Search field](https://uiarc.dev/components/search-field/markdown): A recognizable search entry point with clear affordances.
- [Expanding search](https://uiarc.dev/components/expanding-search/markdown): An icon that morphs into a search field with results beneath it.
- [Inline edit](https://uiarc.dev/components/inline-edit/markdown): Rename in place: the text becomes a field without moving.
- [Number field](https://uiarc.dev/components/number-field/markdown): Enter a bounded number with clear increment controls.
- [Money input](https://uiarc.dev/components/money-input/markdown): A currency field with live grouping, stable width, rolling digits, and minor-unit output.
- [Phone input](https://uiarc.dev/components/phone-input/markdown): A phone field with a country picker, formatting as you type, and E.164 output.
- [Scrub input](https://uiarc.dev/components/scrub-input/markdown): A Figma-style number field: drag the label to scrub, or type values, units, and arithmetic.
- [Tag input](https://uiarc.dev/components/tag-input/markdown): Turn short text values into removable tags.
- [Mention input](https://uiarc.dev/components/mention-input/markdown): A textarea with @people and #channel mentions that act as single tokens, with suggestions at the caret.
- [Shortcut recorder](https://uiarc.dev/components/shortcut-recorder/markdown): Record key combinations into key caps, with conflict warnings, Kbd, and a searchable cheatsheet.
- [Select](https://uiarc.dev/components/select/markdown): A compact choice field with a keyboard friendly menu.
- [Combobox](https://uiarc.dev/components/combobox/markdown): Search and select from a list without leaving the field.
- [Multi-select](https://uiarc.dev/components/multi-select/markdown): Select several values while keeping the field readable.
- [Morph select](https://uiarc.dev/components/morph-select/markdown): A select whose trigger grows into the list, with a gliding highlight and type-ahead.
- [Chip group](https://uiarc.dev/components/chip-group/markdown): Filter by a few facets with chips that morph as you pick them.
- [Radio cards](https://uiarc.dev/components/radio-cards/markdown): Selectable option cards with a sliding selection ring, price and description slots, and radio keyboard behavior.
- [Billing toggle](https://uiarc.dev/components/billing-toggle/markdown): A monthly and yearly switch with a savings badge and prices that roll to the new amount.
- [Checkbox](https://uiarc.dev/components/checkbox/markdown): A binary choice with a precise, legible state.
- [Radio group](https://uiarc.dev/components/radio-group/markdown): Choose one option from a visible set.
- [Switch](https://uiarc.dev/components/switch/markdown): A tactile toggle for settings that take effect immediately.
- [Segmented control](https://uiarc.dev/components/segmented-control/markdown): Switch between a small set of related views.
- [Rating](https://uiarc.dev/components/rating/markdown): A simple, accessible way to capture a numeric opinion.
- [Toggle group](https://uiarc.dev/components/toggle-group/markdown): A row of icon or text toggles, single or multiple: one pressed fill glides between options, or each fades in on its own and neighbours join, as in a formatting toolbar.
- [Slider](https://uiarc.dev/components/slider/markdown): Pick a value or a range on a track that follows your finger.
- [Elastic slider](https://uiarc.dev/components/elastic-slider/markdown): A slider that stretches like rubber past its ends, with a swaying value tag and detents the thumb clicks into.
- [Range histogram slider](https://uiarc.dev/components/range-histogram-slider/markdown): A price range over a live histogram of the data, lighting the bars inside the range and settling on bar edges.
- [Ruler slider](https://uiarc.dev/components/ruler-slider/markdown): A tape of ticks that slides under a fixed needle, with momentum, snapping, and a rolling readout.
- [Calendar](https://uiarc.dev/components/calendar/markdown): Browse dates in a clear, compact month view.
- [Date picker](https://uiarc.dev/components/date-picker/markdown): Choose a date without losing context.
- [Date range picker](https://uiarc.dev/components/date-range-picker/markdown): A range picker that grows from its trigger into two months with presets and a stretching range highlight.
- [Time picker](https://uiarc.dev/components/time-picker/markdown): Choose a time with sensible keyboard behavior.
- [Color picker](https://uiarc.dev/components/color-picker/markdown): A swatch that grows into a picker with format morphing, eyedropper, saved swatches, and contrast readout.
- [Emoji picker](https://uiarc.dev/components/emoji-picker/markdown) (Pro): A full emoji picker with instant search, scroll-synced categories, skin tones, recently used emoji, and a virtualized, keyboard-navigable grid.
- [Rich text editor](https://uiarc.dev/components/rich-text-editor/markdown): A lightweight editor with markdown shortcuts, a floating toolbar, a slash menu, and HTML and markdown output.
- [Signature pad](https://uiarc.dev/components/signature-pad/markdown): Smooth ink that thins with speed, with undo, replay, and PNG or SVG export.
- [File dropzone](https://uiarc.dev/components/file-dropzone/markdown): A generous target for dropping one or more files.
- [Avatar upload](https://uiarc.dev/components/avatar-upload/markdown) (Pro): Click or drop a photo onto the avatar to crop it in place with drag, pinch and zoom. It uploads through a progress ring and settles, with clear errors and retry.
### Disclosure
- [Tabs](https://uiarc.dev/components/tabs/markdown): Switch between related content in the same context.
- [Breadcrumb](https://uiarc.dev/components/breadcrumb/markdown): Show where a page sits in a hierarchy.
- [Mega menu morph](https://uiarc.dev/components/mega-menu-morph/markdown) (Pro): A site header whose menus share one floating panel. Moving between sections morphs its size, slides the next menu in from that side and glides the caret under the new trigger, with hover intent, a safe triangle and an accordion sheet on narrow screens.
- [Table of contents progress](https://uiarc.dev/components/toc-progress/markdown) (Pro): A table of contents that reads along with you: a line bends through the nested headings, fills as you scroll, and carries a marker to the current section, with smooth jumps and a time-left countdown.
- [Scroll area](https://uiarc.dev/components/scroll-area/markdown): A native scroll container with thin ove