Guía · 5 minutos

De cero a tu primer efecto.

Esta librería reúne 287 componentes de código abierto de React Bits, Magic UI, Eldora UI y Fancy Components, con demos en vivo, playground y buenas prácticas. Así se instalan y así se usan bien.

  1. 01

    Crea el proyecto

    React + TypeScript con Vite. Todos los componentes funcionan también en Next.js.

    Terminal
    npm create vite@latest mi-web -- --template react-ts
    cd mi-web && npm install
  2. 02

    Añade Tailwind CSS

    Los componentes vienen en la variante TypeScript + Tailwind.

    Terminal
    npm install tailwindcss @tailwindcss/vite
    
    // vite.config.ts
    import tailwindcss from "@tailwindcss/vite";
    export default defineConfig({ plugins: [react(), tailwindcss()] });
    
    /* src/index.css */
    @import "tailwindcss";
  3. 03

    Inicializa shadcn (una vez)

    El CLI de shadcn descarga el componente y sus dependencias por ti.

    Terminal
    npx shadcn@latest init
  4. 04

    Añade un efecto

    Copia el comando desde la ficha de cualquier efecto. Por ejemplo, Aurora:

    Terminal
    npx shadcn@latest add https://reactbits.dev/r/Aurora-TS-TW
  5. 05

    Úsalo

    Importa y colócalo en un contenedor con tamaño. Los fondos ocupan el 100 % de su padre.

    Hero.tsx
    import Aurora from "./components/Aurora/Aurora";
    
    export default function Hero() {
      return (
        <section style={{ position: "relative", height: "100vh" }}>
          <Aurora colorStops={["#8B7BFF", "#3DE7FF", "#2B1CFF"]} />
          <h1 style={{ position: "absolute", inset: 0 }}>Hola</h1>
        </section>
      );
    }

Glosario sin tecnicismos.

Componente
Una pieza reutilizable de interfaz (un botón, un fondo, un texto animado). La importas y la colocas como si fuera una etiqueta HTML.
Props
Los ajustes de un componente: color, velocidad, texto… Es lo que cambias en el playground de cada efecto.
npm
El gestor de paquetes de JavaScript. “npm install gsap” descarga la librería gsap en tu proyecto.
Tailwind CSS
Una forma de dar estilos con clases cortas (p. ej. “text-white p-4”). Casi todos los componentes la usan.
shadcn CLI
La herramienta que copia un componente dentro de tu proyecto con un solo comando, junto a sus dependencias.
WebGL / shader
Dibujo en la tarjeta gráfica. Permite fondos y efectos imposibles con CSS, pero consume más: úsalos con cabeza.
Licencia MIT
Puedes usar, modificar y copiar el código, también en proyectos comerciales, manteniendo el aviso de autoría.
Commons Clause
Añadido a MIT de algunas librerías: puedes usarlas en tus webs y productos, pero no vender ni redistribuir los componentes en sí.

5 reglas para que no se atasque.

01

Carga bajo demanda

Envuelve los efectos pesados en React.lazy + Suspense. Tu página inicial no debe pagar por un shader que está al final.

02

Monta solo lo visible

Usa IntersectionObserver para montar el efecto al entrar en pantalla y desmontarlo al salir. El navegador limita los contextos WebGL (~16).

03

Un protagonista

Un fondo WebGL por pantalla. Combínalo con efectos de texto (DOM/CSS), que son baratos.

04

Móvil primero

En móvil reduce resolución (dpr ≤ 1.5), partículas y efectos de cursor (no hay cursor).

05

Respeta al usuario

Con prefers-reduced-motion, pausa animaciones continuas y ofrece una versión estática.

Explorar la librería →