Sistema de diseño · Higinio Sosa
Celeste Clásica
Sistema de marca light-first, sereno y confiable, para todos los productos de software de Higinio Sosa: web apps, dashboards, landing pages y móvil. La elegancia viene del orden y el aire, no de la decoración.
Claridad primero
El contenido siempre por encima de la decoración.
Calma visual
Superficies claras, whitespace generoso, contraste solo donde importa.
Un acento a la vez
El azul acero guía la acción; nunca compite consigo mismo.
Consistencia sobre novedad
Mismos tokens en todos los productos; cero valores mágicos.
Movimiento con propósito
La animación explica — aparece, cambia, desaparece — nunca decora sola.
Regla de oro
Los componentes consumen solo tokens semánticos (--surface, --accent, --link…), nunca hex directos. El cambio de tema es un atributo, no un refactor.
Fundamentos
Voz y contenido
Una consultora seria pero cálida — "banca privada boutique", no "startup ruidosa".
| Regla | Sí | No |
|---|---|---|
| Idioma: español LatAm neutro, de "tú" | Guarda tus cambios | Guarde usted los cambios |
| Sentence case en todo | Eliminar cuenta | Eliminar Cuenta / ELIMINAR |
| Botones imperativos de 1–3 palabras | Guardar | Guardando los cambios ahora |
| Errores accionables | El correo no tiene un formato válido. Revísalo. | Error |
| Sin exclamaciones ni emoji | Cuenta creada | ¡Cuenta creada! 🎉 |
| Voz en segunda persona | Tus proyectos | Nuestros proyectos para ti |
Fundamentos
Colores
Un solo acento — azul acero #7192ba — sobre neutrales grisáceo-azulados derivados de la tinta #31343e. Haz clic en cualquier muestra para copiar su variable.
Primario — Azul acero
Neutrales — Gris azulado
Semánticos — ramp de 3 tonos
Cada estado tiene el sólido (-500), el fondo suave (-100) y el tono de texto AA sobre ese fondo (-text).
Aliases semánticos
Los componentes consumen solo esta capa — así el cambio de tema es un cambio de atributo.
| Alias | Valor (light) | Rol |
|---|
Regla AA del acento
primary-500 sobre blanco da ~3:1 — válido solo para componentes UI (rellenos, bordes, focus). Para texto (links, botones ghost) usa --link = primary-700 (~6:1). primary-300 jamás como texto.
Proporción 60-30-10
Un solo botón primario visible por pantalla; el resto secundarios o ghost. Fondos siempre planos: sin gradientes, texturas ni patrones. El acento pierde poder si supera el 10 %.
Fundamentos
Tipografía
Tres familias con roles estrictos. Escala 1.25 (tercera mayor) desde 16 px.
Fraunces
Display 600–700 · solo h1–h2, cifras hero y marketing. Nunca UI ni párrafos.
Public Sans
Body/UI 400–600 · párrafos, botones, formularios, h3–h6. Todo lo demás.
IBM Plex Mono
Mono 400–500 · datos numéricos, código, IDs, montos en tablas.
Escala
Tracking: -0.02em en display ≥31px · 0 en body · +0.04em en labels uppercase. Longitud de línea máx. 65ch. Números en tablas con tabular-nums. Mínimo absoluto 12 px.
Fundamentos
Espaciado
Escala base 4 px — cero valores mágicos. El número del token = px ÷ 4.
Aliases de uso
| Alias | Valor | Uso |
|---|---|---|
| --card-padding | 24px | Padding de tarjetas (16px en móvil) |
| --section-gap | 64px | Separación entre secciones |
| --form-gap | 20px | Gap entre campos de formulario |
| --button-padding-md | 12px 20px | Botón md (sm: 8px 14px) |
| --control-height-* | 36 / 44 / 52 | Alturas de controles sm / md / lg |
| --gutter | 24px | Gutter del grid de 12 columnas (16px móvil) |
Fundamentos
Bordes, radios y focus
Bordes de 1 px, radios generosos y un focus siempre visible — la geometría que sostiene la calma de la marca.
Radios
Borde por defecto 1px solid var(--border). Focus ring global de teclado: 2px var(--primary-500) con offset 2px vía :focus-visible — el click de ratón no lo dispara. Único uso de transparencia: overlay de modal y ring de focus. No hay blur ni glassmorphism en Celeste Clásica.
Fundamentos
Elevación
Sombras frías teñidas con la tinta rgba(49,52,62,…), nunca negro puro. Máximo 3 niveles de elevación visibles por pantalla. Sin resplandor de acento: el glow es exclusivo de Nocturna Eléctrica.
Niveles
reposo · sin sombra
shadow-xs/sm · inputs, tarjetas
shadow-md · hover, dropdowns
shadow-lg/xl · modales, diálogos
Sombras
Fundamentos
Iconografía
Set sustituto: Lucide — trazo 1.5–2 px, esquinas redondeadas, geométrico. Si existe un set propio de marca, reemplazar.
- Los iconos se insertan inline como SVG para heredar currentColor.
- Tamaños: 14 px inline con texto pequeño · 16–18 px inputs y chevrons · 20 px botones y toolbars · 40 px empty states (en primary-300 decorativo).
- Sin emoji; sin Unicode-como-icono (excepto el / tipográfico de breadcrumbs).
Fundamentos
Marca / wordmark
No hay logo ni imágenes de marca. Donde un mockup necesite logotipo se renderiza «Higinio» (o el nombre del producto) en --font-display (Fraunces) — nunca se dibuja un logo aproximado.
- El wordmark es texto, no un icono: --font-display (Fraunces 600–700), nunca en UI ni párrafos.
- Sentence case siempre: «Higinio», nunca «HIGINIO» ni «higinio».
- Color --text-primary (tinta); primary-300 jamás como texto, tampoco en el wordmark.
- No se genera ilustración ni isotipo para no inventar assets: se usan placeholders y se piden los materiales reales.
Biblioteca
Componentes
Los 35 componentes del sistema, renderizados en vivo con las clases del framework celeste-clasica.css. Cada bloque incluye su código de uso.
Botones
Alturas 36 / 44 / 52 px · radius md · peso 600 · un solo primario visible por pantalla. Ghost y outline usan --link (AA), no primary-500.
Ver código
<button class="btn btn--primary">Guardar cambios</button>
<button class="btn btn--secondary">Cancelar</button>
<button class="btn btn--outline">Exportar</button>
<button class="btn btn--ghost">Ver detalles</button>
<button class="btn btn--danger">Eliminar cuenta</button>
<!-- Tamaños: btn--sm · (md por defecto) · btn--lg -->
<button class="btn btn--primary btn--lg">Grande</button>
IconButton
Botón cuadrado solo-icono para toolbars y chrome. Default ghost. Siempre con aria-label.
Ver código
<button class="icon-btn icon-btn--ghost" aria-label="Buscar">
<svg>…icono 18px…</svg>
</button>
<!-- Variantes: --ghost (default) · --secondary · --primary
Tamaños: --sm 32px · (md 40px) · --lg 48px -->
Spinner
Trazo 2.5, rotación 0.8 s linear. Si la carga dura <300 ms, no mostrar spinner. Blanco dentro de botones primarios.
Ver código
<svg class="spinner" viewBox="0 0 24 24" fill="none">
<circle cx="12" cy="12" r="9" stroke="currentColor" stroke-width="2.5"/>
<path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor"
stroke-width="2.5" stroke-linecap="round"/>
</svg>
Input
Altura 44 px · label siempre visible (nunca placeholder como label) · focus con borde --accent + ring · obligatorio con .field--required (asterisco --danger + required/aria-required).
Ver código
<div class="field">
<label class="field__label" for="correo">Correo electrónico</label>
<input class="input" id="correo" type="email" placeholder="tu@correo.com">
<span class="field__help">Nunca compartiremos tu correo.</span>
</div>
<!-- Obligatorio: .field--required en el .field + required/aria-required en el input -->
<div class="field field--required">
<label class="field__label" for="nombre">Nombre completo</label>
<input class="input" id="nombre" required aria-required="true">
</div>
<!-- Estados: input--error (+ .field__error) · input--success · disabled
Icono leading: envolver en .input-icon -->
Textarea
Min-height 96 px · resize: vertical · contador opcional alineado a la derecha.
Ver código
<div class="field">
<label class="field__label" for="desc">Descripción</label>
<textarea class="textarea" id="desc" maxlength="200"></textarea>
<span class="textarea-counter">0 / 200</span>
</div>
Select
Trigger igual que input + chevron 16 px que rota al abrir. Menú con shadow-lg y opción seleccionada en --accent-soft.
Ver código
<div class="select-wrap">
<select class="select">
<option>Ciudad de México (GMT-6)</option>
<option>Bogotá (GMT-5)</option>
</select>
</div>
SegmentedControl
2–4 opciones mutuamente excluyentes. Indicador blanco con shadow-xs. Para más de 4 opciones, usar Select.
Ver código
<div class="segmented" role="radiogroup" aria-label="Vista">
<input type="radio" name="vista" id="lista" checked><label for="lista">Lista</label>
<input type="radio" name="vista" id="tablero"><label for="tablero">Tablero</label>
</div>
<!-- Compacto: añadir segmented--sm -->
Slider
Track 6 px con porción rellena en --accent · thumb blanco 18 px con borde de acento que escala 1.15 al presionar.
Ver código
<div class="slider-row">
<span class="slider-label">Límite de gasto</span>
<span class="slider-value">$ 350</span>
</div>
<input class="slider" type="range" min="0" max="1000" value="350">
<!-- JS: actualizar --slider-fill = ((v-min)/(max-min))*100 + '%' -->
Checkbox y Radio
20 px · borde 2 px · check que se dibuja con ease-spring · label clicable con gap 10 px · estado indeterminate (guion) para «seleccionar todo» parcial.
Ver código
<label class="checkbox">
<input type="checkbox" checked>
<span class="checkbox__box">
<svg viewBox="0 0 24 24"><path d="M20 6 9 17l-5-5"/></svg>
</span>
Recibir novedades
</label>
<label class="radio">
<input type="radio" name="plan" checked>
<span class="radio__dot"></span>
Plan mensual
</label>
<!-- Indeterminate: propiedad del DOM, no atributo HTML -->
<!-- checkbox.indeterminate = true (guion horizontal) -->
Switch
Track 44×24 px · thumb 20 px que desliza 20 px en 200 ms ease-spring.
Ver código
<label class="switch">
<input type="checkbox" checked>
<span class="switch__track"></span>
Notificaciones
</label>
Badge y Tag
Fondo suave semántico (*-100) + texto --*-text (AA garantizado). Estado nunca solo con color: color + icono + texto.
Ver código
<span class="badge badge--success">
<svg>…icono…</svg>Activo
</span>
<!-- Tonos: (neutral) · --success · --warning · --danger · --info -->
<span class="tag">diseño
<button class="tag__close" aria-label="Quitar etiqueta">
<svg>…x…</svg>
</button>
</span>
Avatar
Fallback automático a iniciales sobre chip primary-100. Dot de presencia: 28 % del diámetro con anillo de superficie.
Ver código
<span class="avatar avatar--lg">
<span class="avatar__initials">HS</span>
<i class="avatar__dot avatar__dot--online"></i>
</span>
<!-- Tamaños: --sm 28 · (md 36) · --lg 48 · --xl 64
Presencia: --online · --busy · --away · (offline) -->
AvatarGroup
Stack de avatares solapados (-8px) con anillo 2 px de --surface que los separa · avatar-group__more para el +N de overflow.
Ver código
<div class="avatar-group">
<span class="avatar"><span class="avatar__initials">HS</span></span>
<span class="avatar"><span class="avatar__initials">MG</span></span>
<span class="avatar"><span class="avatar__initials">AL</span></span>
<span class="avatar"><span class="avatar__initials">RD</span></span>
<span class="avatar-group__more">+3</span>
</div>
<!-- Solape -8px · cada avatar con anillo 2px de --surface -->
Divider
Regla hairline 1 px --border · variante con label centrado (patrón "o continúa con") · vertical para flex.
Ver código
<hr class="divider">
<div class="divider--label" role="separator">o continúa con</div>
<span class="divider--vertical" role="separator"></span>
Accordion
Altura animada con grid-template-rows 0fr→1fr (sin reflow) · chevron rota 180° · aria-expanded.
Ver código
<div class="accordion">
<div class="accordion__item is-open">
<button class="accordion__header" aria-expanded="true">
Pregunta <svg>…chevron…</svg>
</button>
<div class="accordion__panel"><div>
<div class="accordion__content">Respuesta</div>
</div></div>
</div>
</div>
<!-- JS: alternar .is-open en .accordion__item + aria-expanded -->
Tooltip
Delay 400 ms · fade + translateY(4→0) · máx. 1 línea; si necesita más, usar popover. Pasa el cursor por los botones.
Ver código
<button class="btn btn--secondary" data-tooltip="Duplica el proyecto">
Duplicar
</button>
<!-- Solo CSS: atributo data-tooltip. Fondo se invierte en dark. -->
Alert
Banner inline y persistente (vs Toast, transitorio). Icono *-500 + texto --*-text sobre fondo *-100. role="status".
Nueva versión disponible
La versión 2.4 incluye exportación a PDF. Actualiza cuando quieras.
Pago confirmado
El recibo se envió a tu correo.
Tu plan expira en 5 días
Renueva antes del 12 de julio para no perder acceso.
No se pudo guardar el formulario
Revisa los campos marcados en rojo e inténtalo de nuevo.
Ver código
<div class="alert alert--warning" role="status">
<svg>…icono…</svg>
<div>
<p class="alert__title">Tu plan expira en 5 días</p>
<p class="alert__body">Renueva antes del 12 de julio.</p>
</div>
<button class="alert__close" aria-label="Cerrar aviso">…x…</button>
</div>
<!-- Tonos: --info · --success · --warning · --danger -->
Toast
Top-right (desktop) · 360 px · borde izquierdo 3 px semántico · auto-dismiss 5 s pausable con hover · máx. 3 apilados.
Ver código
<div class="toast-stack" role="status" aria-live="polite">
<div class="toast toast--success">
<svg>…icono…</svg>
<div>
<p class="toast__title">Cambios guardados</p>
<p class="toast__body">El proyecto se actualizó.</p>
</div>
<button class="icon-btn icon-btn--ghost icon-btn--sm" aria-label="Cerrar">…x…</button>
</div>
</div>
Progress y ProgressRing
Solo progreso determinado — para carga indeterminada usar Skeleton. Width / dashoffset animan 250 ms.
Ver código
<div class="progress-row">
<span class="progress-label">Almacenamiento</span>
<span class="progress-value">68%</span>
</div>
<div class="progress">
<div class="progress__bar" style="width:68%"
role="progressbar" aria-valuenow="68"
aria-valuemin="0" aria-valuemax="100"></div>
</div>
<!-- Tonos de barra: (accent) · --success · --warning · --danger -->
Modal
role="dialog" · aria-modal · aria-labelledby + aria-describedby · al abrir el foco entra al panel, queda atrapado (Tab/Shift+Tab ciclan) y vuelve al disparador al cerrar · Esc y click en overlay cierran, salvo flujos destructivos (el de confirmación no cierra por overlay).
Ver código
<div class="modal" id="miModal" role="dialog" aria-modal="true"
aria-labelledby="miModalTitulo" aria-describedby="miModalDesc">
<!-- overlay sin data-modal-close en flujos destructivos -->
<div class="modal__overlay" data-modal-close></div>
<div class="modal__panel" tabindex="-1">
<div class="modal__header">
<h4 class="modal__title" id="miModalTitulo">¿Eliminar proyecto?</h4>
<button class="icon-btn icon-btn--ghost" data-modal-close aria-label="Cerrar">…x…</button>
</div>
<p id="miModalDesc">Esta acción no se puede deshacer.</p>
<div class="modal__footer">
<button class="btn btn--secondary" data-modal-close>Cancelar</button>
<button class="btn btn--danger">Eliminar</button>
</div>
</div>
</div>
<!-- Panel ancho: modal__panel--lg (640px) -->
<!-- JS: al abrir guarda el disparador y enfoca el panel; Tab/Shift+Tab
atrapados dentro; al cerrar (Esc, ×, Cancelar) el foco vuelve al disparador -->
Tabla
Header uppercase +0.04em · filas 52 px · numéricos a la derecha con tabular-nums. Variantes: .table--zebra · .table--sticky (header fijo) · columna ordenable con aria-sort · selección con .row--selected y «seleccionar todo» indeterminate.
| Cliente | Estado | ||
|---|---|---|---|
| Constructora Delta | Activo | $ 48,200.00 | |
| Grupo Andrade | Pendiente | $ 9,850.00 | |
| Studio Nébula | Activo | $ 132,400.00 | |
| Farmacias Luna | Vencido | $ 1,120.00 |
Ver código
<table class="table table--zebra table--sticky">
<thead>
<tr>
<th class="col-select" scope="col">
<label class="checkbox"><input type="checkbox" aria-label="Seleccionar todo">
<span class="checkbox__box"><svg>…check…</svg></span></label>
</th>
<th scope="col">Cliente</th>
<th class="num" scope="col" aria-sort="none">
<button class="th-sort th-sort--num" data-sort="monto">
Monto<svg class="sort-icon" aria-hidden="true">…</svg></button>
</th>
</tr>
</thead>
<tbody>
<tr class="row--selected">
<td class="col-select"><label class="checkbox"><input type="checkbox" checked
aria-label="Seleccionar Grupo Andrade">…</label></td>
<td>Grupo Andrade</td><td class="num" data-monto="9850">$ 9,850.00</td>
</tr>
</tbody>
</table>
<!-- JS: click en .th-sort alterna aria-sort asc/desc y reordena tbody;
el checkbox del header pasa a indeterminate con selección parcial -->
Stat
KPI único, componer dentro de Card. Valor en mono text-3xl · delta con flecha en tonos --*-text · count-up al entrar en viewport.
Ver código
<div class="card">
<div class="stat">
<span class="stat__label"><svg>…</svg>Ingresos del mes</span>
<div class="stat__row">
<span class="stat__value">$ 128,400</span>
<span class="stat__delta stat__delta--up"><svg>…</svg>+12.4%</span>
</div>
</div>
</div>
<!-- Delta: --up (success-text) · --down (danger-text) · neutro (text-muted) -->
Pagination
1-indexado, bajo una tabla · trunca con elipsis a partir de 7 páginas · página activa como chip sólido con aria-current="page".
Ver código
<ul class="pagination" aria-label="Paginación">
<li><button class="pagination__btn" aria-label="Anterior">…‹…</button></li>
<li><button class="pagination__btn">1</button></li>
<li><span class="pagination__ellipsis">…</span></li>
<li><button class="pagination__btn is-active" aria-current="page">5</button></li>
<li><button class="pagination__btn">6</button></li>
<li><button class="pagination__btn" aria-label="Siguiente">…›…</button></li>
</ul>
Skeleton y EmptyState
Shimmer 1.4 s en loop, radius igual al contenido que reemplaza. Un estado vacío siempre invita a actuar.
Aún no tienes proyectos
Crea tu primer proyecto para empezar a organizar tu trabajo.
Ver código
<div class="skeleton" style="height:10px;width:85%"></div>
<div class="skeleton skeleton--circle" style="width:40px;height:40px"></div>
<div class="empty-state">
<svg>…icono 40px…</svg>
<p class="empty-state__title">Aún no tienes proyectos</p>
<p class="empty-state__desc">Crea tu primer proyecto para empezar.</p>
<button class="btn btn--primary">Crear proyecto</button>
</div>
Card, Link y Code
Tarjeta con padding 24 px y shadow-sm; la interactiva sube 2 px al hover. Link con subrayado que crece. Code inline en mono.
Tarjeta estática
Contenido en reposo con borde --border y shadow-sm.
Tarjeta interactiva
Pasa el cursor: sube 2 px con shadow-md. Consulta la guía de motion.
Ver código
<div class="card">…</div>
<div class="card card--interactive">…</div>
<a class="link" href="#">Enlace con subrayado animado</a>
<span class="code">--accent</span>
Combobox y búsqueda
role="combobox" · aria-expanded + aria-controls + aria-activedescendant · lista role="listbox", opciones role="option" · ↑/↓ mueven, Enter elige, Esc cierra, Home/End a extremos. La búsqueda se limpia con la ×.
Ver código
<div class="combobox">
<input class="combobox__input" type="text" role="combobox"
aria-expanded="false" aria-controls="lista" aria-autocomplete="list"
aria-activedescendant="opt-0" autocomplete="off">
<ul class="combobox__list" id="lista" role="listbox" aria-label="Ciudades">
<li class="combobox__option is-active" role="option" id="opt-0"
aria-selected="false">Guadalajara</li>
<li class="combobox__option" role="option" id="opt-1"
aria-selected="true">Monterrey
<svg class="combobox__check">…check…</svg></li>
</ul>
</div>
<div class="search">
<svg class="search__icon" aria-hidden="true">…lupa…</svg>
<input class="search__input" type="search" placeholder="Buscar…">
<button class="search__clear" aria-label="Limpiar">…x…</button>
</div>
Drawer / Sheet
role="dialog" · aria-modal · foco atrapado y devuelto al disparador (patrón del Modal) · overscroll-behavior: contain · entra deslizando desde el borde y sale más corto · Esc y click en overlay cierran. Variantes --right (default), --left, --bottom.
Ver código
<div class="drawer drawer--right" id="miDrawer" role="dialog"
aria-modal="true" aria-labelledby="miDrawerTitulo">
<div class="drawer__overlay" data-drawer-close></div>
<div class="drawer__panel" tabindex="-1">
<div class="drawer__header">
<h4 class="drawer__title" id="miDrawerTitulo">Filtrar proyectos</h4>
<button class="icon-btn icon-btn--ghost" data-drawer-close aria-label="Cerrar">…x…</button>
</div>
<!-- campos… -->
<div class="drawer__footer">
<button class="btn btn--secondary" data-drawer-close>Cancelar</button>
<button class="btn btn--primary" data-drawer-close>Aplicar</button>
</div>
</div>
</div>
Popover
Se abre por click (no hover, a diferencia del tooltip) y lleva contenido interactivo · trigger aria-haspopup="dialog" + aria-expanded · panel role="dialog" · aparece desde el trigger (fade + scale 0.96→1) · Esc y click fuera cierran.
Plan Estudio
Incluye 12 tableros, 3 integraciones y respaldo diario. Puedes cambiar de plan cuando quieras.
Ver comparación de planesVer código
<div class="popover">
<button class="btn btn--secondary popover__trigger"
aria-haspopup="dialog" aria-expanded="false"
aria-controls="pop">Detalles del plan</button>
<div class="popover__panel" id="pop" role="dialog"
aria-label="Detalles del plan" tabindex="-1">
<p>Contenido con <a class="link" href="#">un enlace</a>.</p>
</div>
</div>
ButtonGroup
Botones adyacentes con bordes compartidos (radius solo en los extremos, bordes internos colapsados) · role="group" + aria-label · usa los .btn existentes. Para un único-seleccionado, usa SegmentedControl.
Ver código
<div class="btn-group" role="group" aria-label="Navegación de semana">
<button class="btn btn--secondary">Anterior</button>
<button class="btn btn--secondary">Hoy</button>
<button class="btn btn--secondary">Siguiente</button>
</div>
DatePicker
Input + calendario en popover · rejilla role="grid", encabezados role="columnheader" con aria-label completo, días role="gridcell" con aria-label de la fecha entera y aria-selected · las flechas mueven entre días · el input abre el calendario (click), Esc cierra y el foco entra al calendario · hoy marcado y un día seleccionado.
Ver código
<div class="datepicker">
<input class="datepicker__input" type="text" readonly
aria-haspopup="dialog" aria-expanded="false" aria-controls="cal">
<svg class="datepicker__icon" aria-hidden="true">…calendario…</svg>
<div class="datepicker__calendar" id="cal" role="dialog"
aria-label="Elegir fecha" tabindex="-1">
<div class="calendar">
<div class="calendar__header">
<button aria-label="Mes anterior">…</button>
<span class="calendar__title">julio 2026</span>
<button aria-label="Mes siguiente">…</button>
</div>
<div class="calendar__weekdays" role="row">
<span class="calendar__weekday" role="columnheader"
aria-label="lunes">lu</span> …
</div>
<div class="calendar__grid" role="grid" aria-label="julio 2026">
<button class="calendar__day calendar__day--today" role="gridcell"
aria-label="viernes, 10 de julio de 2026"
aria-selected="false">10</button>
<button class="calendar__day calendar__day--selected" role="gridcell"
aria-label="viernes, 17 de julio de 2026"
aria-selected="true">17</button> …
</div>
</div>
</div>
</div>
FileUpload
Dropzone + lista · el input file real va oculto pero con label asociado y aria-describedby de formatos y tamaño · la zona describe la acción · estado .is-dragover al arrastrar · el error no se comunica solo por color (icono + texto) · el item que sube reusa la barra .progress.
Ver código
<div class="file-upload">
<input class="file-upload__input" type="file" multiple
aria-describedby="hint">
<label class="file-upload__label" for="…">
<svg aria-hidden="true">…subir…</svg>
<span class="file-upload__title">Arrastra archivos o elige</span>
<span class="file-upload__button">Elegir archivos</span>
<span class="file-upload__hint" id="hint">PDF, PNG o JPG · hasta 10 MB</span>
</label>
</div>
<ul class="file-upload__list">
<li class="file-upload__item">
<svg class="file-upload__icon">…</svg>
<div class="file-upload__meta">
<span class="file-upload__name">informe.pdf</span>
<span class="file-upload__size">2.4 MB · Subiendo 45%</span>
<div class="progress"><div class="progress__bar" style="width:45%"></div></div>
</div>
<button class="file-upload__remove" aria-label="Cancelar informe.pdf">×</button>
</li>
<li class="file-upload__item file-upload__item--error">
<svg class="file-upload__icon">…alerta…</svg>
<div class="file-upload__meta">
<span class="file-upload__name">video.mov</span>
<span class="file-upload__size">…alerta… Formato no admitido</span>
</div>
<button class="file-upload__remove" aria-label="Quitar video.mov">×</button>
</li>
</ul>
Stepper / Wizard
<ol> · aria-current="step" en el paso actual · el completo muestra un check (no solo color), el próximo muestra su número · estados --complete/--current/--upcoming · .step__connector entre pasos · variante --vertical.
- Cuenta
- Perfil
- 3 Facturación
- 4 Confirmar
- Borrador guardado
- 2 Revisión del equipo
- 3 Publicación
Ver código
<ol class="stepper" aria-label="Progreso de configuración">
<li class="step step--complete">
<span class="step__connector" aria-hidden="true"></span>
<span class="step__marker">…check…</span>
<span class="step__label">Cuenta</span>
</li>
<li class="step step--current" aria-current="step">
<span class="step__connector" aria-hidden="true"></span>
<span class="step__marker">3</span>
<span class="step__label">Facturación</span>
</li>
<li class="step step--upcoming">
<span class="step__marker">4</span>
<span class="step__label">Confirmar</span>
</li>
</ol>
<!-- Vertical: añade la clase --vertical al <ol> -->
<ol class="stepper stepper--vertical">…</ol>
Kbd
Tecla en <kbd> con borde, sombra sutil de tinta y tipografía mono · tamaño pequeño, mínimo 20px · combos con "+" entre teclas.
Inline en el texto: abre la paleta con ⌘ K y guarda con Ctrl S.
Ver código
<kbd class="kbd">Esc</kbd>
<!-- Combo: "+" literal entre teclas -->
<span class="kbd-combo">
<kbd class="kbd">⌘</kbd> + <kbd class="kbd">K</kbd>
</span>
Sistema
Motion
Solo transform y opacity. La salida siempre ~20 % más corta que la entrada. Distancias de 4–8 px: nada "vuela" por la pantalla.
| Token | Valor | Uso |
|---|---|---|
| --duration-instant | 100ms | Press, toggle |
| --duration-fast | 150ms | Hover, focus, color |
| --duration-base | 200ms | Dropdowns, tooltips, switches |
| --duration-slow | 250ms | Modales, toasts |
| --duration-page | 320ms | Transiciones de página |
Easings (pasa el cursor)
- Stagger en listas: 30 ms por ítem, máximo 6 ítems.
- Si la carga dura <300 ms, no mostrar spinner (evita parpadeo).
- prefers-reduced-motion colapsa toda animación a 0.01 ms.
Sistema
Accesibilidad
WCAG AA mínimo: 4.5:1 texto normal, 3:1 texto grande y componentes UI. Touch targets de 44×44 px. Estado nunca comunicado solo con color.
| Combinación | Contraste | Veredicto |
|---|---|---|
| neutral-800 sobre blanco | 12.42:1 | AAA |
| Blanco sobre primary-500 | 3.22:1 | Solo texto ≥18px o UI |
| --link (primary-700) sobre blanco | 5.94:1 | AA texto normal |
| primary-300 sobre blanco | 1.91:1 | Nunca como texto |
| Tonos --*-text sobre *-100 | 4.72–6.60:1 | AA garantizado |
- Focus visible siempre: ring global de teclado vía :focus-visible con especificidad cero (:where()).
- IconButton siempre con aria-label · Progress con role="progressbar" · Alert con role="status" · Pagination con aria-current="page".
- Labels de formulario siempre visibles — el placeholder nunca sustituye al label.
Sistema
Tokens y descarga
El sistema completo vive en dist/celeste-clasica/: celeste-clasica.css (framework completo), tokens.css (solo variables), tailwind.css (@theme para Tailwind v4) y tokens.json (W3C DTCG 2025.10, interoperable con Figma / Tokens Studio / Style Dictionary).
Variables CSS
:root {
/* Primario */
--primary-50: #f2f6fa; --primary-100: #dfe9f2; --primary-200: #c3d5e6;
--primary-300: #a0c0d4; --primary-400: #87a8c7; --primary-500: #7192ba;
--primary-600: #5d7ba3; --primary-700: #4d6588; --primary-800: #40536e;
--primary-900: #31343e;
/* Neutrales */
--neutral-0: #ffffff; --neutral-50: #f7f8fa; --neutral-100: #eef0f3;
--neutral-200: #dcdfe5; --neutral-300: #b8bdc7; --neutral-400: #8a8f9c;
--neutral-500: #666b78; --neutral-600: #4d5160; --neutral-700: #3d414e;
--neutral-800: #31343e; --neutral-900: #22242b;
/* Semánticos (ramp de 3) */
--success-500: #3d9970; --success-100: #e2f3ec; --success-text: #2b6e50;
--warning-500: #c9922e; --warning-100: #faf1de; --warning-text: #8a651c;
--danger-500: #c04d4d; --danger-100: #f9e7e7; --danger-text: #8f3232;
--info-500: #7192ba; --info-100: #dfe9f2; --info-text: #4d6588;
/* Aliases (los componentes consumen SOLO esto) */
--bg: var(--neutral-50); --surface: var(--neutral-0); --surface-alt: var(--neutral-100);
--border: var(--neutral-200); --border-strong: var(--neutral-300);
--text-primary: var(--neutral-800); --text-secondary: var(--neutral-600);
--text-muted: var(--neutral-500); --text-disabled: var(--neutral-400);
--text-on-primary: #ffffff; --text-on-primary-solid: var(--primary-700);
--accent: var(--primary-500); --accent-hover: var(--primary-600);
--accent-active: var(--primary-700); --accent-soft: var(--primary-50);
--accent-soft-strong: var(--primary-100); --link: var(--primary-700);
/* Tipografía */
--font-display: "Fraunces", Georgia, serif;
--font-body: "Public Sans", system-ui, -apple-system, sans-serif;
--font-mono: "IBM Plex Mono", ui-monospace, monospace;
--text-xs: .75rem; --text-sm: .875rem; --text-base: 1rem; --text-lg: 1.125rem;
--text-xl: 1.25rem; --text-2xl: 1.5625rem; --text-3xl: 1.9375rem;
--text-4xl: 2.4375rem; --text-5xl: 3.0625rem;
--tracking-display: -0.02em; --tracking-label: 0.04em; --measure: 65ch;
/* Espaciado (base 4px) */
--space-1: 4px; --space-2: 8px; --space-3: 12px; --space-4: 16px;
--space-5: 20px; --space-6: 24px; --space-8: 32px; --space-10: 40px;
--space-12: 48px; --space-16: 64px; --space-20: 80px; --space-24: 96px;
--control-height-sm: 36px; --control-height-md: 44px; --control-height-lg: 52px;
/* Radios y sombras */
--radius-sm: 6px; --radius-md: 10px; --radius-lg: 14px;
--radius-xl: 20px; --radius-full: 9999px;
--shadow-xs: 0 1px 2px rgba(49,52,62,.06);
--shadow-sm: 0 1px 3px rgba(49,52,62,.08), 0 1px 2px rgba(49,52,62,.05);
--shadow-md: 0 4px 8px rgba(49,52,62,.09), 0 2px 4px rgba(49,52,62,.05);
--shadow-lg: 0 12px 24px rgba(49,52,62,.12), 0 4px 8px rgba(49,52,62,.06);
--shadow-xl: 0 24px 48px rgba(49,52,62,.16);
--ring: 0 0 0 3px rgba(113,146,186,.25);
/* Motion */
--duration-instant: 100ms; --duration-fast: 150ms; --duration-base: 200ms;
--duration-slow: 250ms; --duration-page: 320ms;
--ease-out: cubic-bezier(0.2, 0, 0, 1);
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
--ease-spring: cubic-bezier(0.34, 1.4, 0.64, 1);
}
Tailwind CSS v4 — bloque @theme
@import "tailwindcss";
@theme {
/* Colores → genera bg-primary-500, text-neutral-800, border-primary-200… */
--color-primary-50: #f2f6fa; --color-primary-100: #dfe9f2;
--color-primary-200: #c3d5e6; --color-primary-300: #a0c0d4;
--color-primary-400: #87a8c7; --color-primary-500: #7192ba;
--color-primary-600: #5d7ba3; --color-primary-700: #4d6588;
--color-primary-800: #40536e; --color-primary-900: #31343e;
--color-neutral-50: #f7f8fa; --color-neutral-100: #eef0f3;
--color-neutral-200: #dcdfe5; --color-neutral-300: #b8bdc7;
--color-neutral-400: #8a8f9c; --color-neutral-500: #666b78;
--color-neutral-600: #4d5160; --color-neutral-700: #3d414e;
--color-neutral-800: #31343e; --color-neutral-900: #22242b;
--color-success: #3d9970; --color-success-soft: #e2f3ec; --color-success-strong: #2b6e50;
--color-warning: #c9922e; --color-warning-soft: #faf1de; --color-warning-strong: #8a651c;
--color-danger: #c04d4d; --color-danger-soft: #f9e7e7; --color-danger-strong: #8f3232;
--color-info: #7192ba; --color-info-soft: #dfe9f2; --color-info-strong: #4d6588;
/* Tipografía → font-display, font-body, font-mono */
--font-display: "Fraunces", Georgia, serif;
--font-body: "Public Sans", system-ui, sans-serif;
--font-mono: "IBM Plex Mono", ui-monospace, monospace;
/* Radios → rounded-sm/md/lg/xl */
--radius-sm: 6px; --radius-md: 10px; --radius-lg: 14px; --radius-xl: 20px;
/* Sombras → shadow-xs…shadow-xl (teñidas de tinta) */
--shadow-xs: 0 1px 2px rgba(49,52,62,.06);
--shadow-sm: 0 1px 3px rgba(49,52,62,.08), 0 1px 2px rgba(49,52,62,.05);
--shadow-md: 0 4px 8px rgba(49,52,62,.09), 0 2px 4px rgba(49,52,62,.05);
--shadow-lg: 0 12px 24px rgba(49,52,62,.12), 0 4px 8px rgba(49,52,62,.06);
--shadow-xl: 0 24px 48px rgba(49,52,62,.16);
/* Easings → ease-out-cc, ease-in-cc, ease-in-out-cc, ease-spring */
--ease-out-cc: cubic-bezier(0.2, 0, 0, 1);
--ease-in-cc: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out-cc: cubic-bezier(0.65, 0, 0.35, 1);
--ease-spring: cubic-bezier(0.34, 1.4, 0.64, 1);
}
Cómo consumirlo en un proyecto nuevo
1) Instala @higinio/design-css (e importa @higinio/design-css/celeste/framework.css) o copia dist/celeste-clasica/celeste-clasica.css (o solo tokens.css) e impórtalo antes de tus estilos, o pega el bloque @theme en tu CSS de Tailwind v4. 2) Aplica .celeste-reset al body. 3) Consume solo aliases semánticos. 4) Alterna data-theme en <html> para light/dark.
Sistema
Instalación
El sistema se distribuye como paquete npm (@higinio/design-css) y también como archivos sueltos en dist/celeste-clasica/. Instálalo o cópialos, y elige qué importar según tu stack (A/B/C). En todas: light por defecto; <html data-theme="dark"> activa el modo oscuro, y los componentes consumen solo aliases semánticos, nunca hex.
Instalar desde npm (recomendado)
Un solo paquete con los dos sistemas en subrutas /celeste/ y /nocturna/. Instálalo y usa las vías A/B/C apuntando a la subruta, en vez de a un archivo copiado.
npm i @higinio/design-css
/* framework completo (vía A) */
@import "@higinio/design-css/celeste/framework.css";
/* o solo tokens (vía B) */
@import "@higinio/design-css/celeste/tokens.css";
/* o Tailwind v4 (vía C) */
@import "@higinio/design-css/celeste/tailwind.css";
A · CSS drop-in (framework completo)
Para cualquier proyecto — HTML plano o cualquier framework. Trae variables + clases de componentes listas (tipo Bootstrap) y ya importa las fuentes. Aplica .celeste-reset al <body>.
<link rel="stylesheet" href="/estilos/celeste-clasica.css">
<body class="celeste-reset">
<button class="btn btn--primary">Guardar</button>
<div class="card">…</div>
</body>
B · Solo tokens
Si diseñas tus propios componentes: solo las variables, sin clases.
@import "./tokens.css";
.mi-panel {
background: var(--surface);
color: var(--text-primary);
border: 1px solid var(--border);
}
C · Tailwind v4
Tailwind v4 se configura por CSS. El tailwind.css ya incluye @import "tailwindcss", los tokens y el bloque @theme — úsalo como tu hoja de entrada (mantén tokens.css a su lado, que es lo que importa).
# 1) instala Tailwind v4
npm i tailwindcss @tailwindcss/postcss
# 2) copia tailwind.css + tokens.css a tu carpeta de CSS
# y usa tailwind.css como entrada. Ya tienes utilidades:
<div class="bg-primary-500 text-neutral-0">…</div>
D · Pipelines de tokens
Para Figma, Tokens Studio o Style Dictionary: importa tokens.json (formato estándar W3C DTCG 2025.10).
Con Claude no copias nada
Invoca la skill celeste-clasica-design o conecta el MCP (sección siguiente) y construye consumiendo tokens, componentes y reglas del sistema, con validación automática.
Sistema
MCP
El paquete @higinio/design-mcp expone ambos sistemas de diseño — Celeste Clásica y Nocturna Eléctrica — a cualquier IDE o cliente compatible con Model Context Protocol: tokens, componentes, reglas duras y validación de código. Complementa a las skills de Claude, no las reemplaza: misma fuente de verdad, accesible también fuera del entorno de Claude.
Las 8 tools
| Tool | Qué hace |
|---|---|
| list_design_systems | Lista los sistemas de diseño disponibles. |
| get_token | Devuelve el valor resuelto de un token o alias de un sistema. |
| search_tokens | Busca tokens por nombre, categoría o valor. |
| list_components | Lista los componentes documentados de un sistema. |
| get_component_spec | Devuelve la especificación completa de un componente: estados, medidas, variantes. |
| get_rules | Devuelve las reglas duras (no negociables) del sistema. |
| validate_code | Audita CSS/HTML contra las reglas del sistema — hex directos, contraste, aliases. |
| generate_snippet | Genera un snippet de componente listo para usar, con los aliases correctos. |
Conectar (remoto)
Añade el servidor a tu .mcp.json:
{
"mcpServers": {
"design": {
"type": "http",
"url": "https://design-mcp.higiniolab.tech/mcp",
"headers": { "Authorization": "Bearer <tu-token>" }
}
}
}
Ejemplo
Consultar un token de este sistema:
get_token(system="celeste", name="--accent")
→ "#7192ba"
Auditar código antes de integrarlo:
validate_code(system="celeste", code="…")
→ { ok: false, issues: ["hex directo #7192ba en línea 12 — usa var(--accent)"] }
MCP y skills, misma fuente de verdad
Usa las skills dentro de Claude; el MCP para IDEs y clientes MCP externos. Ambos leen DESIGN-celeste-clasica.md.