Estilos
Cómo targ-apps obtiene todo su CSS de Chroma-Style (tokens, utilidades generadas, prose, animaciones y twMerge) sin Tailwind ni paquetes de npm, y cómo se verificó que se ve igual.
El sitio se diseñó con clases utilitarias, tokens de shadcn y componentes cva. En targ-apps todo eso lo aporta Chroma-Style (@chroma/style 0.3.0), vendorizado en plugins/chroma-style/. No hay node_modules, ni Node, ni Tailwind, ni tw-animate-css, ni tailwind-merge: el CSS lo escribe el plugin de build chroma-style, que viene dentro del CLI chroma.
Piezas
| Pieza | Dónde | Qué hace |
|---|---|---|
| Plugin de runtime | plugins/chroma-style/ (copia de Chroma-Style/) | Tokens, twMerge y presets en el navegador (bootstrapStyle, cva) |
| Plugin de build | Dentro del CLI (chroma-style) | Escanea las clases y escribe assets/css/app.css; se configura en pluginOptions.chroma-style de chroma.json |
| CSS del sitio | src/styles/tokens.css, base.css, layout.css | Lo que no es genérico: --spacing, la fuente, el stack de secciones fijadas, .bg-grain, .grainient-container |
| Runtime | src/main.chr, src/lib/utils.chr | bootstrapStyle({ cva, cx, styles: false }) y cn() con twMerge |
chroma dev # genera el CSS en memoria, lo sirve en /assets/css/app.css y lo regenera al guardar un .chr, index.html o src/styles
chroma build # lo escribe minificado en dist/assets/css/app.cssYa no existen chroma-style.config.mjs, scripts/css.mjs, scripts/dev.mjs ni package.json.
Cómo se genera el CSS
El plugin lee estas opciones de chroma.json:
{
"pluginOptions": {
"chroma-style": {
"src": ["src", "index.html"],
"include": ["src/styles/tokens.css", "src/styles/base.css", "src/styles/layout.css"],
"colors": ["dark", "dark-foreground", "dark-muted", "dark-muted-foreground", "dark-border"]
}
}
}src escanea los .chr y el HTML buscando nombres de clase, include es el CSS propio del sitio (al final y sin capa) y colors registra las superficies oscuras (bg-dark, text-dark-foreground/85…). El resultado es un único archivo, assets/css/app.css.
Está ordenado por capas (@layer tokens, base, components, utilities) y seguido del CSS propio del sitio:
- tokens —
tokens.cssdel plugin (paleta, radios, tipografía; tema claro y oscuro) más los desrc/styles/tokens.cssy solo las variables--color-*de la paleta que alguna clase usa. - base — reset y estilos base del plugin, más la fuente
Grift Variable, la selección y el scroll del sitio. - components —
prose(la tipografía del blog) y solo si se usa. - utilities — las 857 clases que el generador reconoció en los
.chr(utilidades y sus variantessm:…2xl:,hover:,group-hover/…:,data-[…]:,aria-…:,has-[…]:,[&_svg]:,dark:…), ordenadas para que gane la que debe ganar. - keyframes y
@property— solomarquee,marquee-verticaly las variables internas--cs-*usadas (transformaciones, anillos, sombras, degradados). - CSS propio —
@font-face, el stack de secciones (.section,.slides-wrapper…) y.bg-grain.
Los nombres de clase de los .chr no se cambiaron: el generador entiende la misma gramática (gap-(--gap), w-[min(14.5rem,calc(100vw-2rem))], bg-primary/80, group-hover/visual:scale-105, data-horizontal:h-px…), que es lo que garantiza la paridad visual.
Decisión: un app.css generado en vez de los CSS del plugin
chroma build empaqueta el JS que importa main.chr (index.js y tw.js entran en bundle.js) y import.meta.url apunta a bundle.js, no al plugin, así que injectStyles() no encontraría las hojas. Por eso el CSS lo produce el plugin de build, se enlaza desde index.html (/assets/css/app.css) y chroma build lo escribe en dist/ junto con assets/ y public/. bootstrapStyle se llama con styles: false para no duplicar hojas. El <html> lleva data-theme="light": el sitio es claro y no debe cambiar con prefers-color-scheme (las secciones oscuras usan .bg-dark y el footer .dark).
Tokens del sitio
La paleta del sitio es la de Chroma-Style (los nombres coinciden con shadcn: --background, --primary, --muted-foreground, --radius…). Lo propio está en src/styles/tokens.css:
| Token | Valor | Por qué |
|---|---|---|
--spacing | 0.5rem | Unidad de p-4, gap-6, top-28… El sitio ya la tenía así (el doble que el valor por defecto, 0.25rem); se conserva para que las medidas no cambien |
--font-sans, --font-heading | "Grift Variable", sans-serif | La fuente variable de assets/ |
--dark, --dark-foreground, --dark-muted, --dark-muted-foreground, --dark-border | hsl(…) | Superficies siempre oscuras (bg-dark, text-dark-foreground/85…), registradas como colores en pluginOptions.chroma-style.colors |
cn() y los componentes ui/*
src/lib/utils.chr ya no importa vendor/tailwind-merge.mjs; cn() es un clsx y twMerge de plugins/chroma-style/tw.js. twMerge traduce cada clase a las propiedades CSS que fija con la misma gramática del generador y descarta la anterior cuando una posterior cubre todas sus propiedades en la misma variante, de modo que cn(buttonVariants({ variant }), className) sigue permitiendo sobrescribir (rounded-lg pisa a rounded-md, px-2 no pisa a p-4). Los cva de button.chr, badge.chr… siguen siendo los del engine.
Verificación de paridad visual
Línea base fija: el sitio con Tailwind, capturado con scripts/capture.mjs (Firefox headless) en reference/baseline-tailwind/. Se capturaron los cuatro planes (reference/plans-chroma/*.json con el puerto de chroma preview) y se compararon píxel a píxel.
| Plan | Capturas | Idénticas (0 px) | Altura del documento | Línea base |
|---|---|---|---|---|
home-desktop (1440×900) | 20 | 16 | 17984 px | 17984 px |
home-mobile (390×844) | 13 | 11 | 21186 px | 21186 px |
blog | 6 | 6 | 2845 px y 3398 px | 2845 px y 3398 px |
ui-states | 2 | 0 (solo cambia una franja animada) | — | — |
Sin errores de página en ninguna captura. Las 8 capturas con diferencias están en zonas que cambian por sí solas entre dos ejecuciones del mismo sitio, o dependen de la red:
- la portada con el shader (
home-1440-00-hero, y el fondo del hero ennav-hover-link); - el fondo en vídeo del CTA (
home-1440-17yhome-1440-18, diferencia máxima de canal 11 y 28) y la banda superior dehome-390-01(máximo 4); - el marquee de servicios, que avanza con el tiempo (
home-390-00-hero, y la franja de ~140×33 px ennav-products-open/nav-hover-link); - la tarjeta de GitHub «PanOS» (
home-1440-10), que se rellena con una petición de red: la línea base se capturó antes de que llegara.
En el resto de cada captura la diferencia es exactamente 0 píxeles, incluidos los menús del navbar abiertos y con hover.
Además se comparó el CSS regla a regla: de las 792 reglas que Tailwind generó para clases presentes en los .chr, 791 tienen exactamente las mismas declaraciones que las del generador. La restante (border-dashed) fija el estilo de borde sin pasar por una variable interna. Dos diferencias son de forma, no de valor: rounded-* y max-w-9xl/10xl usan var(--radius-*)/var(--container-*) (mismo valor calculado) y los degradados/colores con opacidad usan color-mix(in oklab, …) y in oklab sin la guarda @supports (navegadores modernos).
Tamaño
| Tamaño | gzip | |
|---|---|---|
app.css con Tailwind (línea base, sin minificar) | 291,8 KB | 32,9 KB |
app.css de Chroma-Style, sin minificar | 119,2 KB | — |
app.css de Chroma-Style, minificado (el de chroma build) | 95,2 KB | 16,3 KB |
De los 95 KB minificados, unos 23 KB son tokens, reset y prose; el resto, utilidades con variantes y el CSS propio del sitio.
Lo que ya no está
@import "tailwindcss",@plugin "@tailwindcss/typography",@import "tw-animate-css",@source,@custom-variant,@themey@apply: se sustituyeron por el generador,prose.cssyanimate.css.- Las utilidades
scroll-fade-*yshimmer-*deshadcn.cssy las variables--color-1…5, que ningún.chrusaba. vendor/tailwind-merge.mjs.
Para añadir una clase basta escribirla en un .chr: con chroma dev en marcha se regenera sola. Las clases que se construyen por concatenación no se ven al escanear: escribe el nombre completo o añádelo a safelist en las opciones de chroma-style. Referencia de la gramática: Utilidades y generador.
Paridad del generador nativo
El generador que antes era un script de Node (tools/build.mjs) ahora es Rust dentro del CLI. Sobre este mismo sitio encuentra las 857 clases y emite las 867 reglas, y el app.css es idéntico byte a byte al del generador anterior, tanto minificado como sin minificar (prueba style_parity en Chroma-Compiler). Las capturas contra la línea base dan 36 de 41 idénticas; las 5 distintas son las mismas zonas animadas de la tabla de arriba, y las alturas de página no cambian (17984 px y 21186 px).