CDAG Wireframes v1 · 00 · Design System Reference · 04 MAY 2026

Design System

Escala de grises — fase wireframe · Sistema atómico de componentes

10
Tokens de color
2
Tipografías
18
Átomos
12
Moléculas
6
Organismos
01

Tokens de Color

Variables CSS de escala de grises. NUNCA usar hex directamente en plantillas — siempre var(--token).
Paleta completa — Grayscale Wireframe
--ink
#0a0a0a
--ink-2
#262626
--ink-3
#525252
--ink-4
#737373
--ink-5
#a3a3a3
--line
#d4d4d4
--line-2
#e5e5e5
--hatch
#ececea
--paper-2
#f4f4f0
--paper
#fafaf7
--white
#ffffff
Tokens de anotación (solo para el layer de wireframe, no para el sitio): --note #1455c8 · --note-bg #eaf1fb · --warn #b45309
Escala tipográfica — tokens de tipo
Token CSS Tamaño Line-height Peso Familia Uso
.t-display48px1.05800InterHero principal, portada
.t-h140px1.1800InterTítulo de página
.t-h232px1.15700InterTítulos de sección
.t-h324px1.2700InterSub-secciones
.t-h420px1.25600InterBloques, cards feature
.t-h518px1.3600InterLabels de componente
.t-body-l18px1.55400InterLead paragraph
.t-body16px1.5400InterCuerpo de texto
.t-body-s14px1.45400InterMeta, caption, aide
.t-cap12px1.35600InterEtiqueta uppercase
.t-mono12pxnormal400IBM Plex MonoCódigo, rutas, meta técnica
.t-eyebrow11px1.2700InterEyebrow de sección, mega nav
Variables de familia: --display = Inter · --body = Inter · --mono = IBM Plex Mono
Utilidades de color: .muted → color: var(--ink-4) · .strong → font-weight: 700
02

Tipografía

Muestra real de cada clase tipográfica. Aplicar directamente como clase HTML.
.t-display
48px · 800 · -0.02em
Atletismo Guatemalteco
.t-h1
40px · 800 · -0.01em
Federación Nacional de Atletismo
.t-h2
32px · 700 · -0.01em
Últimas Noticias
.t-h3
24px · 700
Resultados del torneo
.t-h4
20px · 600
Selección nacional
.t-h5
18px · 600
29 de marzo 2026
.t-body-l
18px · 400 · 1.55
La Confederación Deportiva Autónoma de Guatemala es el ente rector del deporte federado en el territorio nacional, siendo su misión promover, fomentar y coordinar la práctica del deporte en sus distintas disciplinas.
.t-body
16px · 400 · 1.5
El atletismo guatemalteco ha destacado en los Juegos Centroamericanos y del Caribe con múltiples medallas de oro, plata y bronce a lo largo de su historia federativa de más de 60 años.
.t-body-s
14px · 400 · 1.45
ATLETISMO · 28 ABR 2026 · Publicado por Departamento de Prensa
.t-cap
12px · 600 · uppercase
Etiqueta Uppercase
.t-mono
IBM Plex Mono · 12px
TEMPLATE · archive-category.php · WP_Query · posts_per_page=12
.t-eyebrow
11px · 700 · 0.12em
Sección · Subsección
.muted aplica color: var(--ink-4). Combinar con cualquier clase tipográfica. Ej: <p class="t-body-s muted">
03

Botones

Átomos de acción. Todas las variantes de .btn. Hover invierte colores. Siempre texto uppercase.
.btn
Primario (default)
default hover disabled
bg: var(--ink) · color: var(--white) · border: var(--ink) · hover invierte · disabled opacity 0.4
.btn.btn--secondary
Secundario
default hover
bg: transparent · border: var(--ink) · hover: bg var(--ink) color var(--white)
.btn.btn--ghost
Ghost / texto
default hover
Sin borde visible · padding left/right 0 · hover: underline. Ideal para "Ver todo" en section heads.
.btn.btn--sm
Pequeño
padding: 6px 12px · font-size: 11px. Usar en cards, tablas, breadcrumbs.
.btn.btn--lg
Grande
padding: 14px 24px · font-size: 14px. Usar en CTAs hero y page-hero.
.btn.btn--full
Ancho completo
width: 100% · justify-content: center. Para formularios y modals.
.btn.btn--icon
Ícono cuadrado
padding: 8px · aspect-ratio: 1. Siempre incluir aria-label. Usar con SVG 16×16.
04

Pills y Badges

Etiquetas de estado, categorías y contadores. Siempre texto uppercase 10px.
Variantes base
Pill
Atletismo Fútbol Voleibol
.pill default: border var(--ink) · bg white
.pill--solid bg: var(--ink) · color: white
.pill--ghost border: var(--line) · color: var(--ink-3)
Estados de convocatoria
Status pills
Abierta Cerrada Pendiente
.pill--status-open bg: var(--ink) — convocatoria activa
.pill--status-closed tachado — cerrada
.pill--status-pending hatch diagonal — en revisión
Contadores
Badge
3 12 634 Noticias 24
.badge mono 10px · min-width 18px · bg var(--ink) · border-radius 9px
Combinaciones típicas
Pills en contexto
Crítica Alta Media Baja
Atletismo Natación +3 más
Prioridades en index. Taxonomías en cards de noticias.
05

Inputs y Formularios

Todos los controles de formulario. border-radius: 0 en todos. Focus: outline 2px var(--ink).
Input de texto
.input
Este campo es obligatorio
Default: border var(--ink-5) · Focus: outline 2px var(--ink) · Error: border 2px var(--ink) + .field__error
Select dropdown
.select
Mismos estilos que .input. Apariencia nativa del browser. En WordPress usar en filtros de WP_Query.
Área de texto
.textarea
resize: vertical (default browser). Mismo estilo que .input. Mínimo 4 rows.
Búsqueda con botón
.search-input
SVG lupa posición absolute left 12px · input flex:1 padding-left:38px · button bg var(--ink) border-left var(--line)
Checkbox y Radio
.check
accent-color: var(--ink) · gap: 8px · font-size: 13px
Campo completo con label, hint y error
.field — anatomía completa
Tal como aparece en tu documento de identidad
Recibirás la confirmación aquí Por favor ingresa un correo válido
.field flex-col gap-6px · .field__label 12px 600 · .field__hint 11px var(--ink-4) · .field--error .input border 2px var(--ink) · .field__error 11px bold
07

Tabs

Navegación por pestañas. Border-bottom activo 2px var(--ink). Sin JavaScript mínimo — el estado .is-active lo controla WP/PHP.
Tabs básicas — .tabs
Cuatro opciones
Contenido del tab activo se renderiza aquí.
.is-active → color var(--ink) · border-bottom-color var(--ink) · margin-bottom -1px (solapa con borde del contenedor)
Tabs con contadores
Tabs + .badge
Badge inactivo usa bg var(--ink-4). Badge activo usa bg var(--ink).
Tabs como filtro de estado
Convocatorias
Usar con parámetro ?estado= en WP_Query. El PHP añade .is-active según el GET param.
08

Cards

Todas las variantes de tarjeta. Hover: transform translateY(-2px) + box-shadow 4px 4px 0 var(--ink).
.card
Card estándar
16:10 · featured image
04 MAY 2026 · ATLETISMO

Selección Nacional clasifica a Juegos Centroamericanos 2026

Los representantes guatemaltecos aseguraron su participación tras los clasificatorios regionales disputados en Panamá.

Atletismo Nacional
Estructura: .card__media → .card__body → .card__meta + .card__title + .card__excerpt + pills
.card.card--compact
Card compacta
16:10
03 MAY 2026·VOLEIBOL

Torneo Nacional de Voleibol — Zona Metropolitana

card__title font-size: 15px. Sin excerpt. Para grids de 4+ columnas.
.card.card--feature
Card destacada
16:9 · feature image
01 MAY 2026·INSTITUCIONAL

CDAG celebra 90 años de apoyo al deporte federado guatemalteco

Nueve décadas de historia, de federaciones, de atletas que han llevado el nombre de Guatemala al mundo entero. Una historia de esfuerzo y dedicación.

card__title font-size: 28px · card__media aspect-ratio 16/9. Para el post destacado en home y hubs.
.card.card--overlay
Card overlay
02 MAY 2026 · BOXEO

Campeón centroamericano de boxeo es recibido en CDAG

position:relative · .card__body position absolute inset bottom · gradient rgba(0,0,0,0.85). Imagen de fondo oscura.
.news-item
Ítem de lista noticia
03 MAY · ATLETISMO
Clasificatorio regional de atletismo — Guatemala sede 2026
02 MAY · NATACIÓN
Nadadores nacionales baten récord en piscina olímpica
01 MAY · FÚTBOL
Selección sub-17 avanza a semifinales del torneo UNCAF
grid 88px 1fr · thumbnail cuadrado aspect-ratio:1 · hover: title underline · border-bottom var(--line-2)
.fed-card
Card de Federación
Federación de Atletismo de Guatemala
Federación de Natación
Federación de Baloncesto
Logo circular 80px · flex-col centered · hover: shadow 4px 4px 0 var(--ink). Usar en grid-4 o grid-6.
.event-card
Card de Evento
15 MAY
09:00 HRS · CENAD ZONA 5
Clasificatorio Nacional de Atletismo 2026
Abierta
22 JUN
08:00 HRS · CIUDAD DE GUATEMALA
Torneo Nacional de Voleibol — Etapa Regional
Pendiente
grid 80px 1fr auto · date bg var(--ink) bloque · fecha strong 28px · hover border-color var(--ink)
.dl-card
Card de Descarga
PDF
Ley Nacional del Deporte, la Educación Física y la Recreación
Decreto 76-97 · 2.4 MB · Actualizado 2025
PDF
Memoria de Labores CDAG 2024
Informe anual · 8.1 MB · PDF
grid 40px 1fr auto · icon 40×48px con borde · hover border-color var(--ink). Para documentos y leyes.
09

Layout

Grillas, contenedores y estructura de página. Base 8px spacing scale.
Grillas de columnas — .grid-N
.grid.grid-2 — 2 columnas igual ancho
col 1
col 2
.grid.grid-3 — 3 columnas
col 1
col 2
col 3
.grid.grid-4 — 4 columnas
col 1
col 2
col 3
col 4
.grid.grid-6 — 6 columnas
1
2
3
4
5
6
Todas las grillas: gap: 24px · .grid-12 también disponible para layouts de 12 columnas.
Combinaciones comunes: grid grid-2 para magazine · grid grid-3 para cards · grid grid-4 para federaciones.
Contenedores — .container
.container — max-width: 1248px · margin: 0 auto · padding: 0 32px
.container.container--narrow — max-width: 760px · para texto editorial
Siempre anidar dentro de una sección de color de fondo. --container: 1248px.
Secciones y Spacing — .section
.section — padding: 64px 0
.section--tight — padding: 32px 0
Spacing scale (8px): --s1:4px · --s2:8px · --s3:12px · --s4:16px · --s5:24px · --s6:32px · --s7:48px · --s8:64px · --s9:80px · --s10:96px
Hero de página — .page-hero
Deportes › Federaciones

Federación Nacional de Atletismo

La Federación de Atletismo de Guatemala, fundada en 1952, es el organismo rector del atletismo federado en el territorio nacional, afiliada a World Athletics y al Comité Olímpico Guatemalteco.

bg: var(--paper-2) · border-bottom 1px var(--line) · padding 48px 0 56px · eyebrow mono 12px · h1 48px 800 · p max-width 720px
Encabezado de sección — .section-head

Últimas Noticias

Ver todo →

Federaciones Nacionales

29 federaciones →
flex space-between align-end · border-bottom 2px var(--ink) · margin-bottom 24px · link: mono 12px color var(--ink-3)
10

Componentes Globales

Inyectados por wireframe.js en todos los prototipos. Usar los slots #wf-header-slot y #wf-footer-slot.
Header global — #wf-header-slot
.wf-header
Información PúblicaTransparenciaConvocatoriasSuscríbete
Contacto
CDAG
Inicio Quiénes Somos ∨ Deportes ∨ Servicios ∨ Instalaciones ∨ Prensa ∨
Sticky top:0 z-index:60 · Barra utilitaria: bg var(--ink) 32px · Main: bg var(--white) border-bottom ink 80px
Compact al scroll (top > 40px): altura reduce a 60px, logo a 40px
Hover en items con data-mega activa mega menú · Click ícono lupa abre .wf-searchbar
Mega menú — .wf-megamenu
Dropdown de sección
DEPORTES · Federaciones (29)
Ajedrez Atletismo Baloncesto Béisbol Boxeo Ciclismo…
position absolute top:100% · display:none → .is-open display:block · grid 12 cols · Activa al mouseenter en .wf-nav__item.has-mega
Search drawer — .wf-searchbar
Buscador deslizante
SUGERENCIAS · Atletismo · Olímpicos · Convocatorias 2026
position absolute top:100% · bg var(--ink) · display:none → .is-open · autofocus al abrir · Esc para cerrar
Drawer móvil — .wf-drawer
Menú hamburguesa <1024px
MENÚ
Inicio
Deportes
Prensa
Convocatorias
position fixed right:0 · width:320px · transform translateX(100%) → .is-open translateX(0) · Overlay semitransparente
FAB stack — .wf-fab-stack
Botones flotantes
WhatsApp — siempre visible Volver arriba — visible al scroll >600px
position:fixed right:24px bottom:24px · wf-fab 48px redondo · WhatsApp siempre visible · .is-visible muestra el botón top
Footer — #wf-footer-slot
.wf-footer
CDAG

Confederación Deportiva Autónoma de Guatemala. 90 años promoviendo el deporte federado nacional.

Institucional

  • Quiénes Somos
  • Comité Ejecutivo
  • Leyes

Deporte

  • Federaciones
  • Asociaciones
  • Instalaciones

Transparencia

  • Información Pública
  • Presupuesto
  • Decretos

Contacto

  • Escríbenos
  • Boletín
  • Zona 9, Ciudad de Guatemala
© 2026 CDAG · Confederación Deportiva Autónoma de Guatemala Términos · Privacidad · Acceso a la Información
bg var(--ink) · grid 2fr 1fr 1fr 1fr 1fr · margin-top: 96px · Legal border-top rgba white 0.15 · font-family mono 10px
11

Interacción y Estados

Mapa de todos los estados posibles por componente. Los estados hover/focus se implementan con CSS :hover/:focus. Active, disabled y error requieren clases o atributos HTML.
Tabla de estados por componente
Componente Default Hover Focus Active / Seleccionado Disabled Error Loading Vacío
.btn bg ink · color white bg white · color ink outline 2px ink :active — scale 0.98 [disabled] opacity 0.4 n/a .btn--loading pulse opacity n/a
.btn--secondary transparent · border ink bg ink · color white outline 2px ink :active scale 0.98 opacity 0.4 n/a n/a n/a
.input border ink-5 border ink-3 outline 2px ink n/a [disabled] opacity 0.5 .field--error border 2px ink n/a placeholder color ink-5
.select border ink-5 border ink-3 outline 2px ink n/a [disabled] opacity 0.5 mismo que .input error n/a n/a
.card border line · bg white border ink · translateY(-2px) shadow 4px 4px ink outline 2px ink n/a n/a n/a .skeleton bg anim .empty placeholder
.tabs a/.tabs button color ink-4 · border-b transparent color ink outline 2px ink .is-active color ink · border-b 2px ink n/a n/a n/a n/a
.pager a border line · color ink-3 border ink · color ink outline 2px ink .is-current bg ink · color white n/a n/a n/a n/a
.fed-card border line · bg white border ink · shadow · translateY(-2px) outline 2px ink n/a n/a n/a .skeleton en logo n/a
.event-card border line border ink outline 2px ink n/a n/a n/a n/a n/a
Loading state — .skeleton
Esqueleto de carga
.skeleton: gradient animado 200% bg-size · bg var(--paper-2) → var(--line-2) → var(--paper-2) · animation: skeleton 1.6s infinite. Aplicar a cualquier placeholder rectangular.
Estado vacío — .empty
Sin resultados
Sin resultados

No encontramos contenido con los filtros seleccionados. Intenta con términos diferentes o elimina los filtros activos.

.empty: text-center · padding 64px 32px · border 1px dashed var(--line) · bg var(--paper-2). SVG opacity 0.4.
12

Sistema de Anotaciones

El sistema de pines azules que conecta wireframes con especificaciones WordPress. Implementado en wireframe.js · setupAnnotations().
Atributos data-* disponibles
Atributo Tipo Descripción Ejemplo
data-annot string Nombre/título de la anotación (requerido) data-annot="Hero Principal"
data-annot-desc string Descripción detallada del componente data-annot-desc="Slider con 3 posts destacados"
data-annot-wp string Referencia de template o WP_Query data-annot-wp="WP_Query · posts_per_page=3 · sticky"
data-annot-pos enum Posición del pin numerado top-right · top-left · bottom-right · bottom-left · mid-right · mid-left
Snippet HTML — cómo annotate un componente
<!-- 1. El elemento necesita position:relative (la clase .has-annot lo hace) --> <section class="has-annot slider" data-annot="Hero Slider" data-annot-desc="Carousel de 3 noticias destacadas con auto-play 5s" data-annot-wp="WP_Query · sticky posts · posts_per_page=3" data-annot-pos="top-right" > <!-- contenido del slider --> </section> <!-- 2. El panel lateral necesita el div #wfAnnotList --> <div class="annot-panel"> <div class="annot-panel__head">Anotaciones</div> <div class="annot-panel__list" id="wfAnnotList"></div> </div> <!-- 3. wireframe.js auto-numera los pines e inyecta el panel -->
Demo vivo — componente annotated
Click en el pin azul para ver la interacción
16:9 · featured image
04 MAY 2026·INSTITUCIONAL

CDAG celebra 90 años impulsando el deporte guatemalteco

Nueve décadas de historia federativa y atletas que llevan a Guatemala al mundo.

Anotaciones · Panel
N
Card de Noticia Destacada
Card feature de la noticia principal. Aspect-ratio 16:9, título h2, excerpt y CTA primario.
WP_Query · posts_per_page=1
El wrapper .page-with-annots crea un grid de 2 columnas (contenido + panel) automáticamente.
.has-annot = position:relative (necesario para posicionar el pin).
El JS auto-numera todos los [data-annot] en orden de aparición en el DOM.
Click en pin → highlight del item en el panel · Click en panel → scroll + pulse animation del pin.

Sistema de Archivos

Estructura de assets y convenciones del proyecto.
Archivos del design system
output-claude-design/ ├── 00-sistema-componentes.html ← este archivo (Design System reference) ├── index.html ← índice del prototipo ├── 01-home.html … 29-terminos.html ← 29 plantillas wireframe └── assets/ ├── wireframe.css ← tokens + átomos + layout (variables CSS, clases base) ├── chrome.css ← header, footer, mega menu, FAB, drawer, lab helpers └── wireframe.js ← inyección del header/footer, setup de anotaciones, FAB
Convenciones para WordPress
Nomenclatura de clases
  • BEM: .block__element--modifier
  • Prefijo .wf- → componentes globales
  • Prefijo .t- → clases tipográficas
  • Prefijo .lab- → solo en design system
  • Prefijo .spec- → solo en design system
CSS Variables — restricción
  • NUNCA usar hex directamente
  • SIEMPRE var(--token) en estilos
  • Fase wireframe = escala de grises
  • Colors del sistema = reemplazar en fase UI
  • --note, --note-bg = solo wireframe layer
← Volver al Índice
CDAG Design System · Wireframe v1 · 04 MAY 2026 · Escala de grises · Sin color en fase wireframe
↑ Inicio