Accesible · Nativo · Adaptable

Componentes que son HTML.

angela da estilo y comportamiento a los elementos nativos de la web —<button>,<dialog>, popover, <details>, formularios— con modo claro y oscuro automático, contraste AA garantizado y una paleta que cambias con dos números.

Principios

  • 01

    La plataforma primero

    Si existe un elemento nativo, se usa. Sin wrappers ni Shadow DOM: el marcado que escribes es el que llega al navegador.

  • 02

    Accesible por defecto

    Contraste WCAG AA verificado para cualquier tono, foco visible, objetivos táctiles grandes, alto contraste y movimiento reducido.

  • 03

    Claro y oscuro

    Sigue al sistema con light-dark() y color-scheme. Un selector opcional permite fijarlo.

  • 04

    Paleta adaptable

    Toda la paleta se deriva en OKLCH de un tono y un croma por rol. Cambia dos variables y todo se recalcula.

  • 05

    Funciona en cualquier proyecto

    Astro, Next, Vue o HTML plano. Todo vive en capas de cascada: tu CSS siempre gana.

  • 06

    JS opcional

    El CSS funciona solo. @angela-ui/angela/js añade validación accesible, pestañas y tema, y carga polyfills solo si faltan.

Empezar

Elige tu framework: cada paso dice en qué archivo va el código. La idea es la misma en todos —el CSS una vez, el tema en el <head> antes de pintar y el JS opcional al arrancar—; lo que cambia es dónde vive cada cosa.

Todo va en el layout: el CSS, el tema y el JS, una sola vez para todas las páginas.

  1. 01 Instala

    Terminalsh
    pnpm add @angela-ui/angela
  2. 02 Estilos, tema y JS en el layout

    El script del <head> aplica el tema guardado antes de pintar, así no hay destello. El JS es opcional: validación accesible, pestañas, diálogos y tema.

    src/layouts/Layout.astroastro
    ---
    import '@angela-ui/angela/css';
    import '../styles/global.css';
    import { themeInlineScript } from '@angela-ui/angela/js/theme';
    ---
    
    <html lang="es">
      <head>
        <meta charset="utf-8" />
        <meta name="color-scheme" content="light dark" />
        <script is:inline set:html={themeInlineScript} />
      </head>
      <body>
        <slot />
        <script>
          import { angela } from '@angela-ui/angela/js';
          angela();
        </script>
      </body>
    </html>
    ¿Usas Tailwind v4?

    Con Tailwind v4, importa angela desde tu CSS global y quita el import del layout.

    src/styles/global.csscss
    @import "tailwindcss";
    @import "@angela-ui/angela/css";
    @import "@angela-ui/angela/tailwind.css";
  3. 03 Usa HTML con clases

    src/pages/index.astroastro
    ---
    import Layout from '../layouts/Layout.astro';
    ---
    
    <Layout>
      <button class="button" type="button">Guardar</button>
    </Layout>
  4. 04 Ponle tu color

    src/styles/global.csscss
    :root {
      --angela-brand-h: 160;   /* tono de marca, 0–360 */
      --angela-brand-c: 0.15;  /* croma, 0–0.2 */
    }

Pruébalo en vivo

En la guía de diseño puedes mover el tono y el croma, ver los componentes en claro y oscuro a la vez y copiar el CSS resultante.