kmshihab7878/claude-code-setup

react-bits

Catalog + task router for React Bits — 130 open-source animated, interactive, fully customizable React components (DavidHDev/react-bits, 38k★).

Voir la source
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

React Bits — Animated Component Catalog

What it is

React Bits (github.com/DavidHDev/react-bits, 38k★, MIT + Commons Clause, reactbits.dev) — 130 animated, interactive, fully customizable React components for building memorable websites. Four source variants per component: JS-CSS, JS-TW, TS-CSS, TS-TW.

Not a runtime npm dependency — components are copied into the user's project via shadcn-style CLI (like shadcn/ui, magicui, aceternity-ui). Each component owns its imports.

Install pattern

bash
# Primary: shadcn CLI (preferred)
npx shadcn@latest add @react-bits/<ComponentName>-<VARIANT>

# Variants:
#   -JS-CSS     → plain CSS, JavaScript
#   -JS-TW      → Tailwind CSS, JavaScript
#   -TS-CSS     → plain CSS, TypeScript
#   -TS-TW      → Tailwind CSS, TypeScript  (recommended for modern projects)

# Examples:
npx shadcn@latest add @react-bits/BlurText-TS-TW
npx shadcn@latest add @react-bits/Galaxy-TS-TW
npx shadcn@latest add @react-bits/Dock-TS-TW

# Alternate: jsrepo
# Alternate: copy source manually from reactbits.dev/<category>/<Component>

Pick TS-TW unless the user's project is JS-only or CSS-first. After install, check component's import block for required peer deps.

Dependency map (install only what each component needs)

Dep familyRequired fornpm install
motion (Framer Motion v12)Most text + ui animationsnpm i motion
gsap + @gsap/reactScroll-based text effects (ScrollFloat, ScrollVelocity, SplitText variants)npm i gsap @gsap/react
three + @react-three/fiber + @react-three/drei + @react-three/postprocessing3D scenes (Ballpit, ModelViewer, FluidGlass, Galaxy, Prism, PrismaticBurst)npm i three @react-three/fiber @react-three/drei @react-three/postprocessing
@react-three/rapierPhysics 3D (Ballpit, Antigravity)npm i @react-three/rapier
oglLightweight WebGL backgrounds (Balatro, Beams, Dither, DotField, many others)npm i ogl
matter-js2D physics (FallingText)npm i matter-js
meshlineLine-based 3D (Threads, Ribbons)npm i meshline
lenisSmooth scroll integrationsnpm i lenis
postprocessingShader bloom/glow (some backgrounds)npm i postprocessing
@use-gesture/reactGesture-driven interactions (TiltedCard, Carousel)npm i @use-gesture/react
react-confettiConfetti overlaysnpm i react-confetti

Default stack for 80% of cases: motion + gsap + Tailwind. Add three/ogl/rapier per-component when a 3D/shader background is used.

Full catalog (130 components)

Text Animations (23) — reactbits.dev/text-animations/<Name>

ASCIIText, BlurText, CircularText, CountUp, CurvedLoop, DecryptedText, FallingText, FuzzyText, GlitchText, GradientText, RotatingText, ScrambledText, ScrollFloat, ScrollReveal, ScrollVelocity, ShinyText, Shuffle, SplitText, TextCursor, TextPressure, TextType, TrueFocus, VariableProximity

Animations (29) — reactbits.dev/animations/<Name>

AnimatedContent, Antigravity, BlobCursor, ClickSpark, Crosshair, Cubes, ElectricBorder, FadeContent, GhostCursor, GlareHover, GradualBlur, ImageTrail, LaserFlow, LogoLoop, MagicRings, Magnet, MagnetLines, MetaBalls, MetallicPaint, Noise, OrbitImages, PixelTrail, PixelTransition, Ribbons, ShapeBlur, SplashCursor, StarBorder, StickerPeel, TargetCursor

Backgrounds (42) — reactbits.dev/backgrounds/<Name>

Aurora, Balatro, Ballpit, Beams, ColorBends, DarkVeil, Dither, DotField, DotGrid, EvilEye, FaultyTerminal, FloatingLines, Galaxy, GradientBlinds, Grainient, GridDistortion, GridMotion, GridScan, Hyperspeed, Iridescence, LetterGlitch, Lightning, LightPillar, LightRays, LineWaves, LiquidChrome, LiquidEther, Orb, Particles, PixelBlast, PixelSnow, Plasma, PlasmaWave, Prism, PrismaticBurst, Radar, RippleGrid, ShapeGrid, Silk, SoftAurora, Threads, Waves

Components (36) — reactbits.dev/components/<Name>

AnimatedList, BorderGlow, BounceCards, BubbleMenu, CardNav, CardSwap, Carousel, ChromaGrid, CircularGallery, Counter, DecayCard, Dock, DomeGallery, ElasticSlider, FlowingMenu, FluidGlass, FlyingPosters, Folder, GlassIcons, GlassSurface, GooeyNav, InfiniteMenu, Lanyard, MagicBento, Masonry, ModelViewer, PillNav, PixelCard, ProfileCard, ReflectiveCard, ScrollStack, SpotlightCard, Stack, StaggeredMenu, Stepper, TiltedCard

Design brief → component routing

Match the user's ask to the minimum component set. Don't spray — pick ONE per role (one hero background, one headline text animation, one primary CTA treatment).

Hero-section patterns

IntentBackgroundHeadlineSupporting
AI / dev tool, luminousAurora, Galaxy, Silk, PlasmaBlurText, ShinyText, GradientTextSplashCursor, ClickSpark
SaaS analytics, architecturalBeams, DotField, DotGrid, DitherSplitText, TextType, ScrollRevealGradualBlur frame
Editorial / typographic herono bg / SoftAurora / GrainientTextPressure, VariableProximity, ScrambledTextminimal
Consumer / energeticBalatro, Iridescence, PrismaticBurst, LiquidChromeGlitchText, RotatingText, TextTypeImageTrail, PixelTrail
Developer CLI / brutalistFaultyTerminal, LetterGlitch, GridScan, HyperspeedDecryptedText, ScrambledText, ASCIITextCrosshair cursor
3D product showcaseParticles, Ballpit, PrismBlurText, ShinyTextModelViewer, FluidGlass

UI element patterns

NeedComponent
macOS-style launcher dockDock
Portfolio card stack / deckCardSwap, Stack, BounceCards, FlyingPosters
Feature grid w/ glowMagicBento, SpotlightCard, BorderGlow
3D-feeling hover cardTiltedCard, DecayCard, ReflectiveCard
Image gallery (circular)CircularGallery, DomeGallery, InfiniteMenu
Masonry / pinterest gridMasonry
Pricing tier pickerElasticSlider, Stepper
Multi-step onboardingStepper, AnimatedList
NavigationCardNav, PillNav, StaggeredMenu, BubbleMenu, FlowingMenu, GooeyNav
Team / profileProfileCard, GlassIcons, GlassSurface
Number counter (KPI)CountUp, Counter
Scroll-linked timelineScrollStack, ScrollFloat, ScrollReveal, ScrollVelocity
Marquee / logo stripLogoLoop
Cursor (custom)SplashCursor, TargetCursor, GhostCursor, BlobCursor, TextCursor, Crosshair

When NOT to use react-bits

  • Design systems for enterprise dashboards → use the interface-design skill + plain Tailwind primitives; animations should be restrained.
  • Brand-first design language (tokens, palette, typography scales) → use hue first to generate the design system, then layer react-bits components INTO it.
  • Accessibility-critical flows — several components use canvas/WebGL and lack ARIA semantics. For forms, tables, a11y-required UI, stick to shadcn/ui primitives and only sprinkle react-bits for hero/marketing surfaces.
  • SSR-sensitive pages — some three.js / OGL / face-api components need client-only rendering. Wrap in 'use client' (Next.js App Router) or lazy-import with ssr: false.

Integration checklist

When the user adds a react-bits component:

  1. Pick the right variant: TS-TW for modern stacks; JS-CSS only if the project is JS + CSS modules.
  2. Run `npx shadcn@latest add @react-bits/<Component>-<VARIANT>` — the CLI writes source into the project's components dir.
  3. Check the component's import block and install the listed peer deps (see dependency map above).
  4. For three.js / OGL / face-api components in Next.js: mark the parent as 'use client' or lazy-load with next/dynamic({ ssr: false }).
  5. Respect `prefers-reduced-motion` — most components animate by default; add a wrapper that disables motion for a11y-sensitive users.
  6. Performance-test 3D/shader components on target devices. Stack 2+ canvas backgrounds at your own risk — each one costs GPU.

Relationship to other skills

  • hue — generates brand-specific design language (tokens, hero-stage presets). Run hue FIRST for a new brand, then pick react-bits components that fit the brand's declared hero preset.
  • impeccable-design / impeccable-audit / impeccable-polish — craft layer for UI. Use react-bits components as primitives; impeccable-* for spacing/typography/polish.
  • interface-design — dashboards, admin panels. React-bits is generally NOT the right choice here; the interface-design skill steers toward restrained Tailwind primitives.
  • frontend-design, aidesigner-frontend — generative UI. Can reference react-bits components in their output.
  • baseline-ui — animation-duration and a11y sanity checks. Run AFTER adding a react-bits component.
  • fixing-motion-performance — when the canvas backgrounds tank Lighthouse.

Rules for Claude

  1. When the user describes a visual brief, propose the minimum set of components from the tables above. Don't stack 3 animated backgrounds.
  2. Always cite the exact component name and the npx shadcn@latest add @react-bits/<Name>-TS-TW command.
  3. Flag required peer deps so the user doesn't hit an install and then immediately hit a missing-module error.
  4. For Next.js projects, always mention the 'use client' / ssr: false caveat for three/OGL/face-api components.
  5. When a brand-first design is in progress (user is running hue or an interface-design flow), let that skill lead; react-bits is a component source, not a design authority.
  6. Link to reactbits.dev/<category>/<Component> for live previews — always more useful than a text description.

Source

  • Repo: https://github.com/DavidHDev/react-bits
  • Docs / live previews: https://reactbits.dev
  • Vue port: https://vue-bits.dev
  • License: MIT + Commons Clause (free for personal and commercial use)
  • Last catalog sync: 2026-04-16 (130 components enumerated from src/content/{TextAnimations,Animations,Backgrounds,Components}/)
du même dépôt

Autres Skills

Tous les Skills