Targ Apps Docs

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

PiezaDóndeQué hace
Plugin de runtimeplugins/chroma-style/ (copia de Chroma-Style/)Tokens, twMerge y presets en el navegador (bootstrapStyle, cva)
Plugin de buildDentro del CLI (chroma-style)Escanea las clases y escribe assets/css/app.css; se configura en pluginOptions.chroma-style de chroma.json
CSS del sitiosrc/styles/tokens.css, base.css, layout.cssLo que no es genérico: --spacing, la fuente, el stack de secciones fijadas, .bg-grain, .grainient-container
Runtimesrc/main.chr, src/lib/utils.chrbootstrapStyle({ 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.css

Ya 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:

  1. tokens — tokens.css del plugin (paleta, radios, tipografía; tema claro y oscuro) más los de src/styles/tokens.css y solo las variables --color-* de la paleta que alguna clase usa.
  2. base — reset y estilos base del plugin, más la fuente Grift Variable, la selección y el scroll del sitio.
  3. components — prose (la tipografía del blog) y solo si se usa.
  4. utilities — las 857 clases que el generador reconoció en los .chr (utilidades y sus variantes sm:…2xl:, hover:, group-hover/…:, data-[…]:, aria-…:, has-[…]:, [&_svg]:, dark:…), ordenadas para que gane la que debe ganar.
  5. keyframes y @property — solo marquee, marquee-vertical y las variables internas --cs-* usadas (transformaciones, anillos, sombras, degradados).
  6. 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:

TokenValorPor qué
--spacing0.5remUnidad 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-serifLa fuente variable de assets/
--dark, --dark-foreground, --dark-muted, --dark-muted-foreground, --dark-borderhsl(…)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.

PlanCapturasIdénticas (0 px)Altura del documentoLínea base
home-desktop (1440×900)201617984 px17984 px
home-mobile (390×844)131121186 px21186 px
blog662845 px y 3398 px2845 px y 3398 px
ui-states20 (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 en nav-hover-link);
  • el fondo en vídeo del CTA (home-1440-17 y home-1440-18, diferencia máxima de canal 11 y 28) y la banda superior de home-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 en nav-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ñogzip
app.css con Tailwind (línea base, sin minificar)291,8 KB32,9 KB
app.css de Chroma-Style, sin minificar119,2 KB—
app.css de Chroma-Style, minificado (el de chroma build)95,2 KB16,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, @theme y @apply: se sustituyeron por el generador, prose.css y animate.css.
  • Las utilidades scroll-fade-* y shimmer-* de shadcn.css y las variables --color-1…5, que ningún .chr usaba.
  • 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).

On this page