llms.txt
Compare with other sites' llms.txt files →# shadcn.io
> shadcn.io is a registry of shadcn/ui-style components, blocks, examples, templates and icons for React, Vue, Svelte and Solid, written in TypeScript and styled with Tailwind CSS v4. React components run on Base UI, Radix UI, React Aria and Ark UI, Base UI being the default; Vue, Svelte and Solid run on Ark UI. Code installs with the shadcn CLI, or an AI agent adds it through the shadcn.io MCP server.
shadcn.io is an independent project, not the official shadcn/ui by @shadcn (https://ui.shadcn.com). It follows shadcn/ui's model and uses the same CLI and theme tokens, so its components work in a shadcn/ui project, and the code lands in your project for you to edit. Every component is accessible (built on headless libraries that follow the WAI-ARIA patterns for focus, keyboard and screen readers), works in light and dark and in your theme, and supports right-to-left layouts.
What's on the site:
- 175 components for React, on each of its four UI libraries, and 169 for Vue, Svelte and Solid, on Ark UI.
- 11 utilities and 35 React hooks.
- 6,231 blocks (page sections: heroes, pricing tables, dashboards, settings pages and more) in 56 categories.
- 1,103 examples in 53 galleries.
- 174 charts on TanStack Charts for every framework; React also has the Recharts originals.
- 35 animated buttons, 97 text effects, 100 backgrounds and 100 shaders.
- 14 premium templates (complete Next.js sites) and 215 open-source templates from the community.
- 294k icons from 222 icon libraries.
- 500 DESIGN.md files for AI agents, each an interpretation of a real brand's design language.
- 498 free tools that run in the browser.
What's free and what's Pro:
- Without an account: every page, every live demo, the tools and the DESIGN.md files.
- With a free account (Google or GitHub): the code and install command of every component, utility, hook, example and chart; the icons; and the free animated pieces (9 of the 35 animated buttons, 10 of the 97 text effects, 10 of the 100 backgrounds and 19 of the 100 shaders).
- With Pro: every block, the 14 premium templates, the MCP server (22 tools) and every animated piece. Three licenses, each monthly, yearly or lifetime:
- Individual: $49 a month, $389 a year or $899 once; one seat, for personal and open-source projects.
- Team: $99 a month, $789 a year or $1,899 once; up to 5 seats, commercial use included.
- Organization: $199 a month, $1,589 a year or $3,899 once; unlimited seats, commercial use included.
How code gets into a project:
- React: with the shadcn CLI. Each component's page shows its command. To install by name, register the registry in `components.json` and put your token (on your dashboard, https://www.shadcn.io/dashboard/account) in `SHADCNIO_TOKEN` in `.env.local`:
```json
{ "registries": {"@shadcnio":{"headers":{"Authorization":"Bearer ${SHADCNIO_TOKEN}"},"url":"https://www.shadcn.io/r/{name}.json"}} }
```
Then `npx shadcn@latest add @shadcnio/button` installs Base UI's version; `@shadcnio/radix/button`, `@shadcnio/aria/button` and `@shadcnio/ark/button` install Radix UI's, React Aria's and Ark UI's.
- Vue, Svelte and Solid: each component's page lists its packages and the files to copy.
- Any framework, with Pro: connect the MCP server (https://www.shadcn.io/api/mcp, your token as `?token=`) to Claude Code, Cursor, VS Code or any of 38 clients, then ask your agent for a component, a block or an icon. It reads your project's framework and UI library and installs the right version.
Docs pages are also served as Markdown, at their URL plus `.md` (https://www.shadcn.io/ui/button.md); the links below to components, utilities, hooks, charts, the animated pieces and the MCP docs point to those.
## Get started and guides
- [Installation](https://www.shadcn.io/ui/installation.md): Set up any React app for the shadcn.io registry: one init with our preset, then one command per component. Vue, Svelte and Solid have their own CLIs.
- [Next.js](https://www.shadcn.io/ui/installation/nextjs.md): Add shadcn.io components to Next.js: create an app with our preset in one command, or run init in the one you have, then add components.
- [Vite](https://www.shadcn.io/ui/installation/vite.md): Set up shadcn.io in a Vite and React app: the template with our preset, or Tailwind CSS v4 and the @ alias in an app you have, then init.
- [React Router](https://www.shadcn.io/ui/installation/react-router.md): Set up shadcn.io in a React Router 7 app: create one with our preset, or run init in yours. Components import from ~/components/ui, as its alias says.
- [TanStack Start](https://www.shadcn.io/ui/installation/tanstack.md): Set up shadcn.io in TanStack Start: create an app with our preset, or run init in yours, then use the components in file routes and server functions.
- [TanStack Router](https://www.shadcn.io/ui/installation/tanstack-router.md): Set up shadcn.io in a TanStack Router single-page app: create it with file routes and Tailwind CSS, check the @ alias, then run init with our preset.
- [Astro](https://www.shadcn.io/ui/installation/astro.md): Set up shadcn.io in Astro with the React integration: create a site with our preset or run init in yours, then hydrate components as islands.
- [Laravel](https://www.shadcn.io/ui/installation/laravel.md): Add shadcn.io components to Laravel's React starter kit: run init with our preset from the app's root, keep the kit's pages working, and add components.
- [Remix](https://www.shadcn.io/ui/installation/remix.md): Remix v2 is now React Router 7. Start new apps there, upgrade a Remix app first, or set up Tailwind CSS v4 and init in a Remix app you keep.
- [Gatsby](https://www.shadcn.io/ui/installation/gatsby.md): Use shadcn.io components in a Gatsby site: move it to Tailwind CSS v4 with PostCSS, alias @/ in webpack, check React, then run init and add components.
- [Manual setup](https://www.shadcn.io/ui/installation/manual.md): Set up shadcn.io in any React project by hand: Tailwind CSS v4, the @ alias for TypeScript and your bundler, the packages, then init or copy files.
- [Why AI coding tools love shadcn/ui](https://www.shadcn.io/ui/why-ai-coding-tools-love-shadcn-ui.md): Coding agents edit what they can read. How copy-in components, a registry and an MCP server make Cursor, Claude Code and Copilot accurate with UI.
- [Form](https://www.shadcn.io/ui/form.md): Build validated React forms: React Hook Form or TanStack Form holds the values, a Zod schema checks them, and Field draws each label, hint and error.
- [Data Table](https://www.shadcn.io/ui/data-table.md): Build a React data table on TanStack Table v9 and our Table: columns, pagination, sorting, filters, column visibility, row selection and expandable rows.
- [Typography](https://www.shadcn.io/ui/typography.md): Style headings, paragraphs, lists, quotes and tables with Tailwind classes on native elements, and Prose for Markdown or CMS HTML you can't add classes to.
- [Markdown](https://www.shadcn.io/ui/markdown.md): Render model replies, READMEs and CMS Markdown in React with TanStack Markdown, styled by Prose, with fenced code in a Code Block and safe streaming.
- [AI SDK](https://www.shadcn.io/ui/ai-sdk.md): Build a streaming chat on the Vercel AI SDK 7: a route with streamText, useChat in the browser, and each message part drawn with our components.
- [TanStack AI](https://www.shadcn.io/ui/tanstack-ai.md): Build a streaming chat on TanStack AI: a route with chat(), useChat in React, and each text, thinking and tool-call part drawn with our components.
## Components
- [All components](https://www.shadcn.io/ui.md): 175 components for React on Base UI, each also on Radix UI, React Aria and Ark UI.
- [React components on Radix UI](https://www.shadcn.io/ui/radix): the same 175 components, built on Radix UI.
- [React components on React Aria](https://www.shadcn.io/ui/aria): the same 175 components, built on React Aria.
- [React components on Ark UI](https://www.shadcn.io/ui/ark): the same 175 components, built on Ark UI.
- [Vue components](https://www.shadcn.io/ui/vue): 169 components for Vue, built on Ark UI.
- [Svelte components](https://www.shadcn.io/ui/svelte): 169 components for Svelte, built on Ark UI.
- [Solid components](https://www.shadcn.io/ui/solid): 169 components for Solid, built on Ark UI.
- [3D Card](https://www.shadcn.io/ui/card-3d.md): A card that turns toward the pointer while its layers rise to their own depths. For React with Base UI, when a flat card should feel like an object.
- [3D Marquee](https://www.shadcn.io/ui/marquee-3d.md): A grid of images laid back at an angle, its columns scrolling without end. For React with Base UI, behind a hero heading or a gallery teaser.
- [3D Pin](https://www.shadcn.io/ui/pin-3d.md): A card that leans back on hover as a pin of light rises from it to a label. For React with Base UI, to point at one featured project or place.
- [Accordion](https://www.shadcn.io/ui/accordion.md): Open one section in a stack and leave the rest closed. For React with Base UI, when an FAQ or a settings block should not show every answer at once.
- [Action Bar](https://www.shadcn.io/ui/action-bar.md): Show bulk actions while rows are selected, and hide them when the selection clears. For React with Base UI, instead of a toolbar that never leaves.
- [Agent](https://www.shadcn.io/ui/agent.md): An agent's setup on one card: its name and model, its instructions, and tools that open into their schemas. For React with Base UI, before it runs.
- [Alert](https://www.shadcn.io/ui/alert.md): Keep a success, warning, or failure on the page until you clear it. For React with Base UI, when the reader may need the message after looking away.
- [Alert Dialog](https://www.shadcn.io/ui/alert-dialog.md): Stop the page until the reader confirms or cancels a destructive step. For React with Base UI, when a click outside should not skip the choice.
- [Anatomy](https://www.shadcn.io/ui/anatomy.md): Label each part of a component on a diagram instead of a screenshot. For React with Base UI, when docs need to name the root, trigger, and content.
- [Android](https://www.shadcn.io/ui/android.md): An Android phone drawn around a screenshot, a video or a live screen. For React with Base UI, in your theme's neutral colors, light and dark.
- [Angle Slider](https://www.shadcn.io/ui/angle-slider.md): Pick an angle in degrees with a thumb on a circular dial. For React with Base UI, when a rotation or a gradient wraps around and a track would hide it.
- [Animated Beam](https://www.shadcn.io/ui/animated-beam.md): A line between two elements with a light running along it. For React with Base UI, to show data moving from one part of a diagram to the next.
- [Animated Cursor](https://www.shadcn.io/ui/animated-cursor.md): A dot that replaces the pointer inside one area, with a label that trails behind it. For React with Base UI, on a hero, a canvas or a portfolio piece.
- [Animated Testimonials](https://www.shadcn.io/ui/animated-testimonials.md): Customer quotes beside a stack of tilted photos, each quote coming in word by word. For React with Base UI, when a few strong quotes beat a grid.
- [Animated Tooltip](https://www.shadcn.io/ui/animated-tooltip.md): A row of overlapping avatars whose name tooltip swings toward the pointer. For React with Base UI, on a team page, a contributor list or a reviewer row.
- [Announcement](https://www.shadcn.io/ui/announcement.md): Place one line of product news above the page, beside a badge. For React with Base UI, when a release or an outage should not look like a form error.
- [Artifact](https://www.shadcn.io/ui/artifact.md): The panel beside the chat for what the model made: a file, a document. For React with Base UI, with a title, actions with tooltips and a close button.
- [Aspect Ratio](https://www.shadcn.io/ui/aspect-ratio.md): Hold an image or a video to a fixed shape while it loads. For React with Base UI, when a widescreen or portrait frame should not jump the page.
- [Attachment](https://www.shadcn.io/ui/attachment.md): Show a file on a message as a chip with its name and thumbnail. For React with Base UI, when the chip tracks upload progress and the picker is separate.
- [Audio Player](https://www.shadcn.io/ui/audio-player.md): Generated speech or any audio file, under a row of controls of your own. For React with Base UI: play, seek, time, mute and volume.
- [Autocomplete](https://www.shadcn.io/ui/autocomplete.md): Filter suggestions as someone types, and keep a value that isn't in the list. For React with Base UI, when a guess helps but free text is also valid.
- [Avatar](https://www.shadcn.io/ui/avatar.md): A round profile photo that falls back to initials, plus a status dot or a group stack. For React with Base UI, wherever the screen names a person.
- [Badge](https://www.shadcn.io/ui/badge.md): Mark a status, a count, or a category without a full sentence beside the title. For React with Base UI, when the label must stay short and on one line.
- [Bottom Navigation](https://www.shadcn.io/ui/bottom-navigation.md): A bottom bar on a phone for the three to five sections people use most. For React with Base UI, when a sidebar would take over the layout.
- [Breadcrumb](https://www.shadcn.io/ui/breadcrumb.md): Show where the page sits with a short trail of parent links that ends in plain text. For React with Base UI, when people should step back up a level.
- [Bubble](https://www.shadcn.io/ui/bubble.md): A colored box for a short reply, with a side, a group, or a reaction. For React with Base UI, when the view is the thread and not a full message row.
- [Button](https://www.shadcn.io/ui/button.md): Save, send, or follow a link from a control that does not stay pressed. For React with Base UI, when the next step is a single action on the page.
- [Button Group](https://www.shadcn.io/ui/button-group.md): Join related actions in a row or stack that shares one border, with no button left selected. For React with Base UI, on a toolbar of separate presses.
- [Calendar](https://www.shadcn.io/ui/calendar.md): Choose one day, several days, or a range without opening a popover first. For React with Base UI, when the month should stay on the page as people pick.
- [Canvas](https://www.shadcn.io/ui/canvas.md): A node editor for agent workflows: cards wired by curved edges, dragged, connected and zoomed. For React with Base UI, no flow library to install.
- [Card](https://www.shadcn.io/ui/card.md): Group a title, supporting text, and actions around one subject, from a login to a featured event. For React with Base UI, when the block stands alone.
- [Carousel](https://www.shadcn.io/ui/carousel.md): Step through slides with previous and next controls, for a gallery or a short onboarding. For React with Base UI, when the slides won't all fit.
- [Chain of Thought](https://www.shadcn.io/ui/chain-of-thought.md): A summary line that expands into the steps an agent took. For React with Base UI, Trace lines with a Code Block and Badges, and no component of its own.
- [Chart](https://www.shadcn.io/ui/chart.md): Share series colors, a tooltip, and a legend across Recharts graphs. For React with Base UI, when the chart should match the rest of the interface.
- [Chat](https://www.shadcn.io/ui/chat.md): A chat thread that keeps the reader's place while an agent's reply streams. For React with Base UI, Messages in a Message Scroller above an Input Group.
- [Checkbox](https://www.shadcn.io/ui/checkbox.md): A yes or no for terms, filters, and row picks that applies when the form is submitted. In React with Base UI, clicking the label toggles the box too.
- [Checkpoint](https://www.shadcn.io/ui/checkpoint.md): A point in the chat the reader can return to. For React with Base UI, a separator Marker after a turn with a Restore Button, no component of its own.
- [Circular Progress](https://www.shadcn.io/ui/circular-progress.md): Show a known amount of work as a ring where a full-width bar won't fit. For React with Base UI, in a button, an avatar, or a tight table cell.
- [Circular Slider](https://www.shadcn.io/ui/circular-slider.md): Turn a ring to set a hue, a heading, or a rotation instead of dragging a thumb on a track. For React with Base UI, the value comes back as an angle.
- [Clipboard](https://www.shadcn.io/ui/clipboard.md): Copy a share link, a token, or an install command, and show a copied state. For React with Base UI, when people shouldn't have to retype the value.
- [Code Block](https://www.shadcn.io/ui/code-block.md): Show code, terminal output, logs, and diffs with a header, line numbers, and a copy button. For React with Base UI, when the text must be exact.
- [Code Editor](https://www.shadcn.io/ui/code-editor.md): An editable code box with syntax highlighting, Tab indents and line numbers. For React with Base UI, when readers should change the code.
- [Collapsible](https://www.shadcn.io/ui/collapsible.md): Hide one section behind a button until someone opens it. For a single show-more in React with Base UI, like extra details under a summary.
- [Color Picker](https://www.shadcn.io/ui/color-picker.md): Pick a color with hue and opacity sliders, or type a hex if you know it. For React with Base UI, when people should see the color as they change it.
- [Combobox](https://www.shadcn.io/ui/combobox.md): Filter a long list from a text field, like countries or timezones. For React with Base UI, when a closed menu would take too long to scan.
- [Command](https://www.shadcn.io/ui/command.md): Filter a palette or jump menu as people type, instead of reading every action. For React with Base UI, to run a command rather than store a form value.
- [Commit](https://www.shadcn.io/ui/commit.md): A commit an agent made, with its message, hash, author and the files it changed. For React with Base UI, when a coding agent reports its work.
- [Comparison](https://www.shadcn.io/ui/comparison.md): Two layers in one frame and a divider to drag between them: before and after, raw and edited. For React with Base UI, by pointer, touch or key.
- [Confirmation](https://www.shadcn.io/ui/confirmation.md): A yes or no the agent asks for before a tool runs. For React with Base UI, an outline Item with Deny and Approve Buttons, and no component of its own.
- [Context](https://www.shadcn.io/ui/context.md): How much of the model's context window is in use. For React with Base UI, a Hover Card with a Progress bar on a Button, and no component of its own.
- [Context Menu](https://www.shadcn.io/ui/context-menu.md): Actions for the item under the pointer, opened with a right-click or a long press. For React with Base UI, when a button on every row won't fit.
- [Credit Card](https://www.shadcn.io/ui/credit-card.md): A payment card drawn in CSS that turns to its back on hover or tap. For React with Base UI, to preview the card a reader types at checkout.
- [Cursor](https://www.shadcn.io/ui/cursor.md): A pointer with a name tag and an optional message, for where a collaborator is on the page. For React with Base UI; it shows others, not your mouse.
- [Data List](https://www.shadcn.io/ui/data-list.md): Labels and values for one record, such as a profile or an invoice. For React with Base UI, when people read down a detail page, not across a table.
- [Date Input](https://www.shadcn.io/ui/date-input.md): Segmented month, day, and year fields for a date people already know, typed part by part. For React with Base UI, when a calendar would be in the way.
- [Date Picker](https://www.shadcn.io/ui/date-picker.md): A button that opens a calendar so people pick a day, a range, or a time. For React with Base UI, when a date typed from memory is easy to get wrong.
- [Dialog](https://www.shadcn.io/ui/dialog.md): A window over the page for a short task, with focus trapped until people finish or cancel. For React with Base UI, Escape returns focus to the opener.
- [Direction](https://www.shadcn.io/ui/direction.md): Set one region left to right or right to left without flipping the rest of the page