React components and blocks with motion. Search docs, props and shadcn install commands.
Model Context Protocol (MCP) Server: dev.uiarc/arc
The MCP server dev.uiarc/arc provides access to React components and blocks that use motion. It also supports searching documentation, including details for props and the commands needed to install shadcn.
🛠️ Key Features
React components and blocks with motion
Documentation search
Props lookup
shadcn installation commands
🚀 Use Cases
Find React component or block documentation related to motion
Retrieve prop details for component usage
Obtain shadcn install commands referenced in the docs
List Arc components and blocks with name, description, tier, and links. Filter by category (Actions, Inputs, Disclosure, Feedback, Data, Text, Special, Blocks), tag, tier (free or pro), or kind (component or block).
Parameters4
category
string
optional
One of: Actions, Inputs, Disclosure, Feedback, Data, Text, Special, Blocks
Get full documentation for one Arc component or block: when to use it, when not to (with the better alternative), usage and extra examples, props, keyboard, accessibility, motion, responsive behavior, performance, keywords, related items, and the install command. structuredContent.api carries the same fields as JSON. With an Arc Pro token (Authorization header), Pro items also include their full source files in structuredContent.files.
Parameters2
id
string
required
Component or block id, e.g. button, date-picker, or signup-form
kind
string
optional
Only needed when an id exists as both
Raw schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Component or block id, e.g. button, date-picker, or signup-form"
},
"kind": {
"type": "string",
"enum": [
"component",
"block"
],
"description": "Only needed when an id exists as both"
}
},
"required": [
"id"
],
"additionalProperties": false
}
get_install_command
Get the shadcn CLI command that installs one or more Arc components or blocks, including shared foundation tokens and Arc dependencies, plus setup notes. Free items always; Pro items (@uiarc-pro registry) when the connection carries an Arc Pro token.
Get one Arc skill file as markdown: rules for building with Arc. Free skills: SKILL (entry point: workflow, principles, never-do list, and quick decisions); INSTRUCTIONS (short always-on rules for agents.md, claude.md, or cursor rules); checklist (the review loop to run before finishing, with grep sweeps); components (choosing the right component or block by job, with ids); composition (page containers, dashboards, marketing sections, states, react correctness); copy (sentence case, no eyebrows or em dashes, verbs on buttons, honest claims); design (color, type, surfaces, concentric radii, spacing, and icons); motion (motion tokens, spring choice, patterns with code, reduced motion); accessibility (focus without rings, semantics, keyboard, and announcements); responsive (widths to check, overflow, tables, and touch targets); example-settings (a worked account settings page); example-pricing (a worked pricing section with plans, comparison, and faq); example-dashboard (a worked analytics overview with kpis, chart, and table). Pro skills (arc-pro, full-page-generation, page-composition, design-system-generation, refactor-to-arc, motion-recommendations, responsive-optimization, accessibility-audit) are returned in full when the connection carries an Arc Pro token (otherwise signed-in Pro members download them at /api/skills and this tool returns where).
Arc is a library of React components and blocks with motion built in. Every item is plain source you own: CSS modules on a small set of design tokens, Motion for animation, keyboard support, and a reduced motion path for every animation. Install anything with the shadcn CLI or copy the files by hand. It works in Next.js and Vite, with or without Tailwind. This repository holds the free, open source part: 121 components and 22 blocks, plus the design and motion tokens they share. Every one of them has a live preview at uiarc.dev.
Showcase
A few favorites, recorded live from uiarc.dev. Items marked Pro are part of Arc Pro and are not in this repository; everything else installs from here for free.
Cover flowPro A depth rail of photos you can throw, with soft grounded shadows and a quiet reflection.
Donut chart Arcs morph between datasets while the total rolls into the center.
Billing toggle Monthly and yearly prices roll into each other, savings included.
Orbit logosPro Integrations orbit your product mark. Filter them by category.
Wallet stackPro Fan a stack of cards and lift one out to see its activity.
Line chart Switch the range and the line redraws against the previous period.
Number field Bounded steppers that say so when you reach the limit.
Activity ringsPro Daily goals sweep, count up and trace a second lap past 100%.
React 19 with TypeScript. The source compiles under strict, noUncheckedIndexedAccess and verbatimModuleSyntax, and needs lib ES2023 or newer (a few items use findLast)
Next.js (App Router) or Vite
motion for animation. Some items also use lucide-react or a Radix UI primitive; the CLI installs whatever an item needs.
The @/* import alias (Next.js and shadcn set it up by default)
No Tailwind is required. Arc styles are CSS modules that read CSS variables.
With the shadcn CLI
Register the @uiarc namespace once in components.json:
Install the design tokens once per app with npx shadcn@latest add @uiarc/arc-foundation, then import them at the root of your app. Components only pull in the motion presets (arc-motion-tokens) and never reinstall foundation.css, so you can also keep the tokens in your own theme package.
tsx
// app/layout.tsx (Next.js) or src/main.tsx (Vite)import"@/components/arc/foundation.css";
Setting up a new project
Next.js
bash
npx create-next-app@latest my-app
cd my-app
npx shadcn@latest init
Install the shared packages: npm install motion lucide-react.
Copy registry/foundation.css, registry/motion-tokens.ts and lib/motion-tokens.ts from this repository into the same paths under your @/ root, and import the CSS once at the root.
Copy the item's folder from registry/components/<id>/ or registry/blocks/<id>/, keeping the path. Copied files keep this repository's layout and import each other through @/; the CLI install above rewrites that for you. Its public/r/<id>.json file lists every file and npm package it needs.
Each page on uiarc.dev also has a Manual tab with the exact files.
Usage
The CLI puts every file in an arc/ folder under the components alias in your components.json, for example components/arc/button/button.tsx, or src/components/arc/… in a src/ project or monorepo package. Arc files import each other with relative paths, so any alias setup works; move the arc/ folder as a whole if you want it elsewhere. Use them like any local component:
The code is yours: edit it, rename it, move it. There is no runtime package to keep in sync.
Theming
Components read semantic tokens, never raw colors. Change a token in foundation.css (components/arc/foundation.css after a CLI install) and every component follows, in both themes.
Dark mode: set data-theme="dark" on <html>. Dark values are tuned separately, not inverted.
Accent: set data-accent on <html> to neutral, violet, blue, green, amber, orange, coral or rose.
Motion: springs and durations live in lib/motion-tokens.ts (components/arc/lib/motion-tokens.ts after a CLI install). Every animation respects prefers-reduced-motion.
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.
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.
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.
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.
Three full screen SaaS heroes: a live dashboard rising from the bottom edge over a drifting mesh, a workflow graph that routes sample events node by node, and editorial type over a mesh gradient.
An email signup framed by a stack of past issues; subscribing drops the next issue, addressed to you, onto the front.
npx shadcn@latest add @uiarc/newsletter-signup
AI tools
Arc is built to be used from AI coding tools.
MCP server:https://uiarc.dev/api/mcp (Streamable HTTP, no key needed for free items). Search, read docs and fetch source from Claude Code, Cursor, VS Code or Codex.
bash
claude mcp add --transport http arc https://uiarc.dev/api/mcp
Arc files import each other through the @/* alias. Map it to your project root in tsconfig.json (and in vite.config.ts for Vite). See Setting up a new project.
Components render without styles or colors
Import the tokens once at the root: import "@/registry/foundation.css";. If the file is missing, run npx shadcn@latest add @uiarc/arc-foundation.
The CLI says @uiarc is an unknown registry
Add the registries entry to components.json (see With the shadcn CLI), or install from the full URL: npx shadcn@latest add https://uiarc.dev/r/<id>.json.
Dark mode does not switch
Arc follows the data-theme attribute on <html>, not the dark class. Set data-theme="dark" before the page paints to avoid a flash of the light theme.
Links and images: using next/link, next/image or your own components
Components render a plain <a> and <img>, so they work in Vite, Remix, Astro or plain React. To route them through Next.js, or through your own Link (for example a locale-aware one), wrap the app once with ArcProvider. It installs with the components that use it.
link receives href plus anchor attributes, and image receives src, alt, width and height or fill, sizes and priority, the same props next/image takes.
A few blocks are Next.js page examples and still import next/image or next/link directly: changelog-feed, site-header, newsletter-signup. In another framework, replace Image with <img> (or ArcImage from arc-provider) and Link with <a>.
Animations do not play
Arc honors the reduced motion setting of your operating system and swaps movement for simple fades. Turn it off to see the full motion, and make sure motion is installed.
The CLI asks to overwrite foundation.css
Only arc-foundation writes foundation.css; components and blocks depend on arc-motion-tokens instead. If you re-run add @uiarc/arc-foundation after customizing your tokens, answer no to keep your file, or keep your overrides in a separate stylesheet loaded after it.
How releases work
New free components and blocks ship regularly, a few at a time. Each release updates this repository, the @uiarc registry and the changelog together, so the code here always matches what the CLI installs. Watch or star the repository to hear about new items.
Repository layout
text
registry/foundation.css design tokens, light and dark themes
registry/motion-tokens.ts motion presets
lib/motion-tokens.ts motion presets, shared path
lib/ small shared helpers
registry/components/<id>/ components
registry/blocks/<id>/ blocks
registry.json shadcn registry index
public/r/<id>.json prebuilt registry items, one per component or block
Arc Pro
Arc Pro adds 233 more components and blocks on top of this library: galleries like the Cover flow above, wallet and finance surfaces, richer charts, and complete product screens. They follow the same rules as everything here: plain source you own, both themes, keyboard support and a reduced motion path.
Source for every Pro component and block, installed with the same shadcn CLI through a personal token, or through the MCP server
Every new Pro release, plus fixes and updates to the pieces you already have
Yearly, or one payment for lifetime access. See pricing
Everything in this repository stays free and MIT licensed.