Skip to content
Skills Library
Programming · Building & coding

21st-dev

/21st-dev

Install and use 21st.dev components — the largest shadcn/ui-compatible registry of React + Tailwind + Framer Motion components (Magic UI, Aceternity UI, originui, eldoraui, kokonutui, Skiper UI, etc.). Use when the user wants Awwwards-tier homepage polish, animated heroes, marquees, bento grids, scroll reveals, pricing cards, testimonials, FAQ accordions, or any high-quality landing-page block. Stack: Next.js + Tailwind 4 + React 19 + framer-motion.

Author
S3YED ↗
Repository
appie-kit ↗
Licence
MIT
Last repository change
26.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
25
Deprecation

No signals detected. Repository changed on 26.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Install and use 21st.dev components — the largest shadcn/ui-compatible registry of React + Tailwind + Framer Motion components (Magic UI, Aceternity UI, originui, eldoraui, kokonutui, Skiper UI, etc.). Use when the user wants Awwwards-tier homepage polish, animated heroes, marquees, bento grids, scroll reveals, pricing cards, testimonials, FAQ accordions, or any high-quality landing-page block. Stack: Next.js + Tailwind 4 + React 19 + framer-motion.

Original author description

Install and use 21st.dev components — the largest shadcn/ui-compatible registry of React + Tailwind + Framer Motion components (Magic UI, Aceternity UI, originui, eldoraui, kokonutui, Skiper UI, etc.). Use when the user wants Awwwards-tier homepage polish, animated heroes, marquees, bento grids, scroll reveals, pricing cards, testimonials, FAQ accordions, or any high-quality landing-page block. Stack: Next.js + Tailwind 4 + React 19 + framer-motion.

How it works

  1. Prerequisites
  2. One-time setup (per project)
  3. Adding a 21st.dev component
  4. Component catalogue — best for Weblyfe homepage
  5. Discovery workflow
  6. Magic MCP (optional — paid feature)
  7. Stack-specific notes for weblyfe-ai
  8. Smoke-test pattern
  9. Licensing
  10. Red flags
Original SKILL.md headings · 159 lines, 1,009 words
SKILL.md preview
---
name: 21st-dev
description: "Install and use 21st.dev components — the largest shadcn/ui-compatible registry of React + Tailwind + Framer Motion components (Magic UI, Aceternity UI, originui, eldoraui, kokonutui, Skiper UI, etc.). Use when the user wants Awwwards-tier homepage polish, animated heroes, marquees, bento grids, scroll reveals, pricing cards, testimonials, FAQ accordions, or any high-quality landing-page block. Stack: Next.js + Tailwind 4 + React 19 + framer-motion."
---

# 21st.dev

21st.dev is the "npm for design engineers" — an open-source community registry (MIT) of high-quality React + Tailwind components, blocks, and hooks. It is shadcn-compatible: every component is installed with the standard `npx shadcn@latest add` CLI, just pointed at a 21st.dev URL.

## Prerequisites

- Node 18+ and `npx`
- A Next.js / Vite / React Router / Astro project
- Tailwind CSS v3 or v4 (Tailwind 4 requires shadcn CLI v4+, March 2026 or newer)
- React 18 or 19
- shadcn initialized once (writes `components.json`, `src/lib/utils.ts`, `src/components/ui/button.tsx`, and shadcn theme tokens into `globals.css`)

## One-time setup (per project)

```bash
# Initialize shadcn — creates components.json, ui/, lib/utils.ts, theme tokens
cd <project-root>
npx --yes shadcn@latest init -d --force
```

`-d` uses defaults (Next.js template, base-nova preset). `--force` overwrites any prior config.

Important — **the init step rewrites `--background`, `--foreground`, `--primary`, `--accent` in `globals.css` to neutral oklch values**. If your project already has brand colors mapped to those CSS variables (Weblyfe does — emerald + gold + snow), you must restore the brand mappings immediately after init:

```css
:root {
  /* Keep brand vars */
  --brand-emerald: #247459;
  --brand-gold: #DFB771;
  --brand-snow: #F6FEFC;
  /* ... */

  /* Re-map shadcn slots to brand */
  --background: var(--brand-snow);
  --foreground: var(--brand-green-goblin);
  --primary: var(--brand-emerald);
  --accent: var(--brand-gold);
  /* keep the rest of shadcn's tokens (card, popover, secondary, border, ring, etc.) */
}
```

Also restore `--font-sans` if you use a custom font variable (shadcn replaces it with `var(--font-sans)`):

```css
@theme inline {
  --font-sans: var(--font-rethink), system-ui, sans-serif;
  --font-heading: var(--font-rethink), system-ui, sans-serif;
}
```

## Adding a 21st.dev component

Browse https://21st.dev → pick a component → click "Code" / copy the install URL. Then:

```bash
npx --yes shadcn@latest add "https://21st.dev/r/<author>/<component>" --yes
```

The CLI:
1. Creates `src/components/ui/<component>.tsx`
2. Installs npm dependencies (e.g. framer-motion, @radix-ui/*)
3. Patches `globals.css` with any required `@theme` keyframes / variables

Import with the alias:

```tsx
import { Marquee } from "@/components/ui/marquee";
```

## Component catalogue — best for Weblyfe homepage

Browse the full registry at https://21st.dev. Here are the picks most relevant to the Appie hero + TIPS structure:

| Use case | Component | Registry path |
|---|---|---|
| Hero with animated avatar + gradient | `magicui/animated-hero` | `https://21st.dev/r/magicui/animated-hero` |
| Hero with text shimmer + spotlight | `aceternity/spotlight` | `https://21st.dev/r/aceternity/spotlight` |
| Sticky scroll narrative (the TIPS reveal) | `aceternity/sticky-scroll-reveal` | `https://21st.dev/r/aceternity/sticky-scroll-reveal` |
| Logo / partner marquee strip | `magicui/marquee` | `https://21st.dev/r/magicui/marquee` |
| Customer-case bento grid | `aceternity/bento-grid` | `https://21st.dev/r/aceternity/bento-grid` |
| 3D card hover (case-study cards) | `aceternity/3d-card` | `https://21st.dev/r/aceternity/3d-card` |
| Pricing tier cards | `originui/pricing` (search `pricing-section`) | `https://21st.dev/community/components/s/pricing-section` |
| Testimonial marquee | `magicui/testimonial-marquee` | `https://21st.dev/r/magicui/testimonials` |
| Animated FAQ accordion | `kokonutui/faq-accordion` | `https://21st.dev/community/components/s/faq` |
| Animated number counter (KPIs) | `magicui/number-ticker` | `https://21st.dev/r/magicui/number-ticker` |
| Globe / world-map (Bangkok ↔ NL trust) | `magicui/globe` | `https://21st.dev/r/magicui/globe` |
| Particle / dot background | `magicui/particles` | `https://21st.dev/r/magicui/particles` |
| Animated beam (network diagram) | `magicui/animated-beam` | `https://21st.dev/r/magicui/animated-beam` |
| Border beam glow effect | `magicui/border-beam` | `https://21st.dev/r/magicui/border-beam` |

Many authors publish multiple variants (e.g. magicui has hero-pill, hero-video-dialog, hero-section). Always preview on 21st.dev before installing.

## Discovery workflow

1. Open https://21st.dev/s/<keyword> (e.g. `/s/hero`, `/s/pricing`, `/s/testimonial`)
2. Filter by Popular or Featured
3. Click a card → preview the live demo
4. Click "Code" → copy the `npx shadcn@latest add` URL
5. Paste into terminal in project root

For semantic search across the registry, the **Magic Console** (https://21st.dev/magic/console) offers free semantic component search and SVG icon search. Generation features (auto-creating bespoke variants) require the $20/month Pro plan but are not needed for installing existing components.

## Magic MCP (optional — paid feature)

For prompt-driven component generation inside Claude Code:

```bash
npx --yes @21st-dev/cli@latest install claude --api-key <KEY>
```

API keys come from https://21st.dev/magic/console. The MCP exposes `/ui` for prompt-to-component generation. **This is not required** — the free `npx shadcn add <url>` flow gives you every published component on the registry.

## Stack-specific notes for weblyfe-ai

- **Tailwind 4**: Already wired. shadcn v4 CLI (March 2026+) handles `@theme inline` and `@custom-variant dark` automatically.
- **Next.js 16 + React 19**: Fully supported. shadcn writes Server-Component-safe code by default.
- **framer-motion 12**: Already installed; many 21st.dev components depend on it and will reuse the existing version rather than re-installing.
- **Brand preservation**: After every `shadcn add`, scan `globals.css` for newly-added `--background` / `--primary` overrides and re-map to brand vars if needed. The CLI usually only appends `@theme` rules and keyframes (safe), but `init` is the one to watch.
- **Path aliases**: Components land in `src/components/ui/*.tsx` and import via `@/components/ui/*` and `@/lib/utils`. Already set up in `tsconfig.json`.
- **Dark mode**: shadcn writes a `.dark` block. We currently do not use dark mode on <project-domain> — leave the block in place but do not toggle the class.

## Smoke-test pattern

Always verify a new install with a throwaway page before integrating into the homepage:

```tsx
// src/app/labs/<component-name>/page.tsx
import { NewComponent } from "@/components/ui/new-component";

export default function Lab() {
  return (
    <main className="min-h-screen container py-24">
      <NewComponent />
    </main>
  );
}
```

Then `npm run build` to confirm it compiles end-to-end. Once verified, port the component into the real homepage section and delete the lab page (or keep `/labs/*` as a private gallery).

## Licensing

21st.dev itself is MIT. Individual components inherit each author's license — check the component page footer. Most are MIT/Apache and safe for commercial use. Aceternity UI, Magic UI, originui, kokonutui are all MIT.

## Red flags

- Some components depend on heavy 3D libs (three, @react-three/fiber, ogl). Check the `dependencies` block on the 21st.dev component page before installing — the CLI will pull them in silently.
- A few authors ship components that import paid Aceternity Pro assets. The free preview will install but render placeholder text. Read the component page carefully.
- If a component references `cn` from `@/lib/utils` and your project uses a different alias, edit the import after install.

## References

- Registry: https://21st.dev
- GitHub: https://github.com/serafimcloud/21st (MIT)
- Magic MCP (paid): https://github.com/21st-dev/magic-mcp
- shadcn v4 changelog: https://ui.shadcn.com/docs/changelog/2026-03-cli-v4
- Tailwind 4 + shadcn: https://ui.shadcn.com/docs/tailwind-v4

Versions

RepositoryScoreLicence
This page · S3YED/appie-kit100MIT
S3YED/appie-kit100MIT

Database snapshot: 13.11.2026 · package version 4f3e2336eae0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100aceternity-ui
    Aceternity UI is a collection of animated React components (3D cards, spotlight, background beams, moving borders, wavy backgrounds) built with Tailwind CSS and the motion library, installed into your project as source through the shadcn CLI. Use when someone asks for "animated…
  • 95aceternity-ui
    100+ animated React components (Aceternity UI) for Next.js with Tailwind. Use for hero sections, parallax, 3D effects, or encountering animation, shadcn CLI integration errors.
  • 100oms-uitripled
    Installs React 19 and Next.js 16 UI components, blocks, and pages from the uitripled shadcn-compatible registry (the react-shadcn variant). Use when composing landing pages, dashboards, or UI from 171 animated Framer Motion components via "npx shadcn@latest add…
  • 100cortexcn
    Build UI with Cortexcn, the React and Tailwind CSS registry at ui.cortexcn.dev. Use when the user mentions Cortexcn or @cortexcn, asks for a component, page block, or chart in a project that uses Cortexcn, or wants to find, install, compose, or theme Cortexcn items.
  • 100framer-motion
    Framer Motion performance optimization guidelines. This skill should be used when writing, reviewing, or refactoring React animations with Framer Motion to ensure optimal performance patterns. Triggers on tasks involving motion components, animations, gestures, layout…
  • 95animated-component-libraries
    Pre-built animated React component collections combining Magic UI (150+ TypeScript/Tailwind/Motion components) and React Bits (90+ minimal-dependency animated components). Use this skill when building landing pages, marketing sites, dashboards, or interactive UIs requiring…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.