umbral_ · guía de estilo

umbral_

Sistema de diseño y guía editorial de Umbral, un laboratorio de datos independiente y de código abierto que publica sobre desapariciones, delito y gasto público en México.

v1.1.0 · 69 reglas · contenido CC BY 4.0, código MIT.

Por dónde empezar

Principios Los cinco principios y cómo funciona la cadena normativa
Color · demostración Los dos modos, los tokens, la matriz de contraste generada
Anatomía de una gráfica El marco que lleva toda gráfica
Terminología Vocabulario controlado y vinculante
Una gráfica real El sistema funcionando sobre un dato real
Checklist Lo que hay que verificar antes de publicar

La idea

Un valor o una regla se enuncia en un solo lugar, y todo lo demás se genera desde ahí.

rules/rules.yaml  +  tokens/src/*.tokens.json      ← aquí se decide
        ↓ build
tokens/build/*  ·  rules/rules.json                ← generado, nunca a mano
        ↓ consumido por
guide/  ·  este sitio  ·  packages/  ·  skills/  ·  umbral-lint

Existe por lo que encontró la auditoría de julio de 2026: la marca v1.0 era buena y estaba bien aplicada, y aun así el 44% del texto del sitio principal no alcanzaba el contraste mínimo. Casi ningún defecto era descuido — eran instrucciones que se siguieron al pie de la letra, desde documentos que se contradecían entre sí.

Consumirlo desde otro repositorio

curl -O https://raw.githubusercontent.com/umbralmx/umbral-style-guide/v1.1.0/tokens/build/tokens.css
pip install umbral-viz
npm install @umbralmx/umbral-plot

Fija la versión. Nunca apuntes a main: un cambio de token entraría sin aviso.