Skip to content
Back to search

ui-beats

Animated React components you own. 55 components built with TypeScript, Tailwind CSS and Motion. Copy, paste, or install with the shadcn CLI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nikhils4--ui-beats/badge.svg)](/listings/nikhils4--ui-beats)

HTML

<a href="/listings/nikhils4--ui-beats"><img src="/api/listings/nikhils4--ui-beats/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx shadcn@latest add https://uibeats.com/r/flip-card.json

The CLI writes the component into your project and installs the npm packages it needs. Every component page lists its own command, and the full index lives at [`/r/registry.json`](https://uibeats.com/r/registry.json).

Prefer to copy and paste? Every component page has the full source under **Installation → Manual**.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 197 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="https://uibeats.com/brand-mark.png" alt="UI Beats" width="72" height="72" />
  3. # UI Beats
  4. **Supercharge your UI.**
  5. Beautifully designed, animated React components you can copy, paste, or install with the shadcn CLI.
  6. [**Documentation**](https://uibeats.com/docs) · [**Components**](https://uibeats.com/docs/getting-started/introduction) · [**Blog**](https://uibeats.com/blogs)
  7. [![CI](https://github.com/nikhils4/ui-beats/actions/workflows/ci.yml/badge.svg)](https://github.com/nikhils4/ui-beats/actions/workflows/ci.yml)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE.md)
  9. [![Next.js](https://img.shields.io/badge/Next.js-16-black?logo=next.js)](https://nextjs.org)
  10. [![React](https://img.shields.io/badge/React-19-149eca?logo=react)](https://react.dev)
  11. [![Tailwind CSS](https://img.shields.io/badge/Tailwind-4-38bdf8?logo=tailwindcss)](https://tailwindcss.com)
  12. </div>
  13. ---
  14. ## What this is
  15. UI Beats is a collection of animated React components built with **TypeScript**, **Tailwind CSS** and **Motion**.
  16. It is **not** a package you install and import from. You own the code: add a component, then change whatever you like. No version pinning, no wrapper APIs, no waiting on a maintainer to expose a prop.
  17. ## Install a component
  18. ```bash
  19. npx shadcn@latest add https://uibeats.com/r/flip-card.json
  20. ```
  21. The CLI writes the component into your project and installs the npm packages it needs. Every component page lists its own command, and the full index lives at [`/r/registry.json`](https://uibeats.com/r/registry.json).
  22. Prefer to copy and paste? Every component page has the full source under **Installation → Manual**.
  23. ## Use it from your coding agent
  24. Most components get picked by whatever is writing the code. The MCP server puts the whole catalogue inside Claude Code, Cursor, Windsurf and anything else that speaks [MCP](https://modelcontextprotocol.io), so your agent can search for a component and read its real props instead of guessing.
  25. ```bash
  26. claude mcp add uibeats -- npx -y @uibeats/mcp
  27. ```
  28. It exposes four tools: `search_components`, `get_component`, `list_components` and `get_install_command`. See [`packages/mcp`](packages/mcp) or the [MCP docs](https://uibeats.com/docs/getting-started/mcp).
  29. For agents that only fetch URLs, the same content is served as plain text:
  30. | URL | What it is |
  31. | ---------------------------- | ------------------------------------------------------------ |
  32. | `/llms.txt` | Index of every component, linking to its markdown |
  33. | `/llms-full.txt` | Every component's props and full source, in one file |
  34. | `/docs/<category>/<name>.md` | Any component page as markdown, just add `.md` |
  35. | `/r/components.json` | The catalogue as JSON, with props and guidance. CORS is open |
  36. ## Tune before you copy
  37. Every component has a **playground** at `/playground/<category>/<name>`: the props table becomes a live control panel, the preview updates as you drag, and the snippet carries only what you actually changed. All 52 of them.
  38. The controls are derived from the same `props` array that renders the documentation table, so a control can never describe a prop the docs do not.
  39. Alongside it, **[Motion Studio](https://uibeats.com/motion-studio)**, a cubic-bezier and spring editor. Drag the curve or tune stiffness, damping and mass, watch it run on three properties at once, and copy the Motion `transition` or the CSS. Springs are integrated from the same damped-oscillator model Motion uses rather than approximated with a bezier, so the preview is the motion you will ship.
  40. ## Components
  41. 52 components across six categories:
  42. | Category | Components |
  43. | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  44. | **Animation** | Animated List, Bounce, Fade In, Fade In Unblur, Rotate In, Scale In, Smooth Reveal, Stagger List |
  45. | **Background** | Animated Beam, Aurora, Dot Pattern, Gradient Flow, Meteors, Orbiting Elements, Particles, Retro Grid, Sparkling Grid |
  46. | **Button** | Confetti Button, Loading Button, Magnetic Button, Rainbow Button, Ripple Button, Shimmer Button, Subscribe Button |
  47. | **Card** | Card Stack, Expandable Card, Flip Card, Glowing Card, Morphing Card, Tilt Card |
  48. | **Component** | Avatar Stack, Bento Grid, Border Beam, Comparison Slider, Dock, Liquid Tabs, Marquee, Progress Ring, Scratch to Reveal, Scroll Progress, Shimmer Effect, Terminal, Timeline |
  49. | **Text** | Flip Words, Gradient Text, Gravity Text Swap, Number Ticker, Scroll Reveal, Split Flap, Text Scramble, Text Shine, Text Writer |
  50. ### Motion you can switch off
  51. Every component honours `prefers-reduced-motion`. Not "most of them": the
  52. whole registry, checked in CI: `tests/reduced-motion.test.ts` fails the build
  53. if a component ships without consulting the preference, or reads it and then
  54. animates anyway.
  55. What that means per component is a judgement, not a switch. An entrance is
  56. settled from the first frame. A carousel stops advancing on its own but still
  57. moves when you press the button. Flip Card still turns, because the back face
  58. is the point; it just cuts instead of sweeping.
  59. ### Themed by your tokens, not ours
  60. Components read shadcn's own variables (`--card`, `--border`,
  61. `--muted-foreground`), so an installed component wears your palette. The few
  62. that need a colour shadcn does not define ship it with them: `cssVars` in the
  63. registry item, merged into your stylesheet by the CLI. See `config/tokens.ts`;
  64. the build fails on a component that reads a variable nothing defines.
  65. ## Local development
  66. Requires **Node 20.9+** and Yarn 4 (via Corepack).
  67. ```bash
  68. git clone https://github.com/nikhils4/ui-beats.git
  69. cd ui-beats
  70. corepack enable
  71. yarn install
  72. yarn dev
  73. ```
  74. The site runs at [http://localhost:3000](http://localhost:3000).
  75. ### Scripts
  76. | Script | What it does |
  77. | --------------------- | ------------------------------------------------------ |
  78. | `yarn dev` | Start the dev server |
  79. | `yarn build` | Build the registry, then the production site |
  80. | `yarn start` | Serve the production build |
  81. | `yarn lint` | ESLint (flat config) |
  82. | `yarn typecheck` | `tsc --noEmit` |
  83. | `yarn test` | Vitest unit tests |
  84. | `yarn test:e2e` | Playwright end-to-end tests against a production build |
  85. | `yarn test:visual` | Motion frame diffs against the committed baselines |
  86. | `yarn format` | Prettier |
  87. | `yarn registry:build` | Regenerate `public/r/` from the component source |
  88. | `yarn new:component` | Scaffold a component and wire it into every registry |
  89. ## How it fits together
  90. ```bash
  91. yarn new:component --name flip-clock --category component
  92. ```
  93. That writes the four files below, registers them in all three maps, and leaves
  94. a stub that compiles and passes the suite. The rest of this section is what it
  95. does, for when you need to do it by hand.
  96. Adding a component means adding **four files**. The sidebar, the docs page, the sitemap, the command menu and the shadcn registry entry are all derived from them; there is no central list to keep in sync.
  97. ```
  98. components/demo/<category>/<name>.tsx the component itself
  99. components/usage/<category>/<name>.usage.tsx a runnable example
  100. content/docs/<category>/<name>.content.ts title, description, props table
  101. content/docs/index.ts add the config to the array
  102. components/website/component-preview.tsx one line in the lazy preview map
  103. ```
  104. Optionally a fifth, to give it a playground:
  105. ```
  106. components/playground/<category>/<name>.playground.tsx renders it from live values
  107. components/website/playground-harnesses.tsx one line in the lazy harness map
  108. ```
  109. Everything else is generated:
  110. - **`lib/registry.ts`** joins each config with its source on disk and derives the npm dependency list from the component's own `import` statements.
  111. - **`lib/playground.ts`** turns the documented props table into controls: a string-literal union becomes a select, a `number` becomes a range with a bounded scale, a hex-defaulted colour prop becomes a swatch.
  112. - **`lib/agent-docs.ts`** renders the same registry data as markdown for `/llms.txt`, `/llms-full.txt` and the per-component `.md` routes.
  113. - **`config/side-nav.ts`** builds the sidebar from the same array.
  114. - **`scripts/build-registry.ts`** emits `public/r/*.json` for the shadcn CLI, plus `components.json` for the MCP server.
  115. - **`app/docs/[category]/[component]/page.tsx`** statically generates one page per component, with real per-page metadata.
  116. ### Stack
  117. | Area | Choice |
  118. | ------------ | -------------------------------------------------------- |
  119. | Framework | Next.js 16 (App Router, React 19) |
  120. | Styling | Tailwind CSS v4 (CSS-first theme, no JS config) |
  121. | Animation | Motion |
  122. | Content | MDX via `next-mdx-remote`, frontmatter via `gray-matter` |
  123. | Highlighting | Shiki, at build time |
  124. | Distribution | shadcn registry, MCP server, `llms.txt` |
  125. | Testing | Vitest + Testing Library, Playwright |
  126. ## Contributing
  127. Contributions are welcome; see [CONTRIBUTING.md](CONTRIBUTING.md) and the [contribute guide](https://uibeats.com/docs/getting-started/contribute). Contributors are credited on their component's docs page.
  128. ### Attribution
  129. Every component says where it came from. The `credits` field on each component's config drives the Credits block on its docs page, the `author` field in its registry JSON, and the `author` in its structured data.
  130. Eighteen components (Tilt Card, Text Scramble, Magnetic Button, Stagger List, Dock, Marquee, Number Ticker, Scroll Reveal, Orbiting Elements, Animated Beam, Animated List, Border Beam, Card Stack, Liquid Tabs, Retro Grid, Ripple Button, Scratch to Reveal and Split Flap) were written with [Claude Code](https://claude.com/claude-code) and are credited as such rather than presented as community contributions. They are reviewed and maintained here like any other component.
  131. <a href="https://github.com/nikhils4/ui-beats/graphs/contributors">
  132. <img src="https://contrib.rocks/image?repo=nikhils4/ui-beats" alt="Contributors" />
  133. </a>
  134. ## Security
  135. Found a vulnerability? Please follow [SECURITY.md](SECURITY.md) rather than opening a public issue.
  136. ## License
  137. [MIT](LICENSE.md) © [Nikhil Singh](https://nikhils4.vercel.app)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.