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()ycolor-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/jsañ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.
01 Instala
Terminalsh pnpm add @angela-ui/angela02 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";03 Usa HTML con clases
src/pages/index.astroastro --- import Layout from '../layouts/Layout.astro'; --- <Layout> <button class="button" type="button">Guardar</button> </Layout>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 */ }
App Router: el layout raíz carga el CSS, el tema y el JS; las páginas usan los componentes de React.
01 Instala
Terminalsh pnpm add @angela-ui/angela @angela-ui/react02 Estilos, tema y JS en el layout raíz
<ThemeScript /> pone el esquema de color y aplica el tema guardado antes de hidratar. <Angela /> activa el JS en el cliente: escucha en el documento, así cubre también lo que se monte al navegar.
app/layout.tsxtsx import '@angela-ui/angela/css'; import './globals.css'; import { Angela, ThemeScript } from '@angela-ui/react'; export default function RootLayout({ children }: { children: React.ReactNode }) { return ( <html lang="es"> <head> <ThemeScript /> </head> <body> {children} <Angela /> </body> </html> ); }¿Usas Tailwind v4?
Con Tailwind v4, importa angela desde globals.css y quita el import de angela del layout.
app/globals.csscss @import "tailwindcss"; @import "@angela-ui/angela/css"; @import "@angela-ui/angela/tailwind.css";03 Usa los componentes
Funcionan en Server Components. Los tipos de JSX (commandfor, command…) vienen incluidos con el paquete de React.
app/page.tsxtsx import { Button } from '@angela-ui/react'; export default function Page() { return <Button>Guardar</Button>; }04 Ponle tu color
app/globals.csscss :root { --angela-brand-h: 160; /* tono de marca, 0–360 */ --angela-brand-c: 0.15; /* croma, 0–0.2 */ }
Una SPA: el tema va en el index.html (React no lo ejecuta antes de pintar) y el resto en main.tsx.
01 Instala
Terminalsh pnpm add @angela-ui/angela @angela-ui/react02 El tema, en el <head>
Sin servidor, React no puede poner el script antes de pintar: va directamente en el HTML.
index.htmlhtml <head> <meta charset="UTF-8" /> <meta name="color-scheme" content="light dark"> <script>try{document.querySelector('meta[name="color-scheme"]').content=localStorage.getItem("color-scheme")??"light dark"}catch(e){}</script> </head>03 Estilos y JS al arrancar
src/main.tsxtsx import '@angela-ui/angela/css'; import './index.css'; import { angela } from '@angela-ui/angela/js'; import { createRoot } from 'react-dom/client'; import App from './App'; createRoot(document.getElementById('root')!).render(<App />); angela();¿Usas Tailwind v4?
Con Tailwind v4, importa angela desde index.css y quita el import de angela de main.tsx.
src/index.csscss @import "tailwindcss"; @import "@angela-ui/angela/css"; @import "@angela-ui/angela/tailwind.css";04 Usa los componentes
src/App.tsxtsx import { Button } from '@angela-ui/react'; export default function App() { return <Button>Guardar</Button>; }05 Ponle tu color
src/index.csscss :root { --angela-brand-h: 160; /* tono de marca, 0–360 */ --angela-brand-c: 0.15; /* croma, 0–0.2 */ }
El tema va en el index.html; los estilos y el JS, en main.ts. En las plantillas usas HTML con clases.
01 Instala
Terminalsh pnpm add @angela-ui/angela02 El tema, en el <head>
index.htmlhtml <head> <meta charset="UTF-8" /> <meta name="color-scheme" content="light dark"> <script>try{document.querySelector('meta[name="color-scheme"]').content=localStorage.getItem("color-scheme")??"light dark"}catch(e){}</script> </head>03 Estilos y JS al arrancar
src/main.tsts import '@angela-ui/angela/css'; import './style.css'; import { angela } from '@angela-ui/angela/js'; import { createApp } from 'vue'; import App from './App.vue'; createApp(App).mount('#app'); angela();¿Usas Tailwind v4?
Con Tailwind v4, importa angela desde style.css y quita el import de angela de main.ts.
src/style.csscss @import "tailwindcss"; @import "@angela-ui/angela/css"; @import "@angela-ui/angela/tailwind.css";04 Usa HTML con clases
src/App.vuevue <template> <button class="button" type="button">Guardar</button> </template>05 Ponle tu color
src/style.csscss :root { --angela-brand-h: 160; /* tono de marca, 0–360 */ --angela-brand-c: 0.15; /* croma, 0–0.2 */ }
Sin framework: un index.html, un main.js y tu CSS.
01 Instala
Terminalsh pnpm add @angela-ui/angela02 La página
El tema va en el <head>; el JS se carga como módulo al final.
index.htmlhtml <!doctype html> <html lang="es"> <head> <meta charset="UTF-8" /> <meta name="color-scheme" content="light dark"> <script>try{document.querySelector('meta[name="color-scheme"]').content=localStorage.getItem("color-scheme")??"light dark"}catch(e){}</script> </head> <body> <button class="button" type="button">Guardar</button> <script type="module" src="/main.js"></script> </body> </html>03 Estilos y JS
main.jsjs import '@angela-ui/angela/css'; import './style.css'; import { angela } from '@angela-ui/angela/js'; angela();¿Usas Tailwind v4?
Con Tailwind v4, importa angela desde style.css y quita el import de angela de main.js.
style.csscss @import "tailwindcss"; @import "@angela-ui/angela/css"; @import "@angela-ui/angela/tailwind.css";04 Ponle tu color
style.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.