Primeros pasos
Guía de consumo del Design System vía CDN. Prefijo de clases
kds-. Compatible con HTML plano, React, Next u otro framework.
URLs públicas absolutas (listas para pegar). Tras un deploy, añade
?v= con un valor nuevo (fecha, hash o versión) para forzar
la actualización de caché del navegador o del CDN.
El valor de ?v= cambia con cada release; los ejemplos de esta
guía usan ?v=1.0.0 solo como plantilla.
<link rel="stylesheet" href="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty.min.css?v=1.0.0"> <script src="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty.min.js?v=1.0.0" defer></script>
| Asset | URL |
|---|---|
| CSS minificado | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty.min.css?v=11841ba4 |
| JS | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty.min.js?v=11841ba4 |
| Tokens CSS | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/tokens.css?v=11841ba4 |
| Tokens JSON | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/tokens.json?v=11841ba4 |
| Sprite de íconos | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty-icons.svg?v=11841ba4 |
| Logo positivo SVG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-positivo.svg |
| Logo negativo SVG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-negativo.svg |
| Logo positivo PNG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-positivo.png |
| Logo negativo PNG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-negativo.png |
--kds-* (color, tipografía, espacio, radius, elevación, botón, motion)..kds-* y atributos data-*.data-service, data-surface).
Si solo necesitas las variables (sin componentes), puedes cargar
tokens.css por separado.
keralty.min.js expone window.KeraltyDS y llama
KeraltyDS.init() al cargar el documento. Inicializa:
| Componente | Selector | Atributos / contrato |
|---|---|---|
| Acordeón | .kds-accordion |
Ítem .kds-accordion__item con data-open;
disparador .kds-accordion__trigger + aria-expanded.
Contenedor opcional data-exclusive="false" para varios abiertos.
|
| Pestañas | .kds-tabs |
Tabs .kds-tabs__tab con aria-selected y
aria-controls. Alcance opcional
[data-kds-tabs]; paneles [role="tabpanel"].
|
| Diálogos | <dialog> |
Abrir: data-kds-dialog-open="id" en un botón.
Cerrar: data-kds-dialog-close dentro del diálogo.
|
El resto de componentes es CSS + markup; no requieren JS del kit.
Pon data-kds en <body> (o en un contenedor raíz)
para tipografía y color base. El color de acción lo define el servicio;
la inversión Clara/Oscura, la superficie.
<body data-kds data-service="laboratorio-clinico" data-surface="clara"> <button class="kds-btn" data-variant="primary" data-size="m">Agendar</button> </body>
| Atributo | Valores | Efecto |
|---|---|---|
data-kds |
(presencia) | Activa tipografía, color de texto y box-sizing del sistema. |
data-service |
institucional ·
banco-sangre ·
laboratorio-clinico ·
unidad-genomica ·
patologia
|
Define --kds-sf-action y estados hover/pressed. |
data-surface |
clara · oscura |
Invierte superficies, bordes y variantes secondary/tertiary. |
--kds-*
Usa las variables en tu CSS. Están incluidas en
keralty.min.css; también publicamos
tokens.css y tokens.json en el CDN.
.mi-bloque {
color: var(--kds-color-text-primary);
background: var(--kds-color-surface-subtle);
border-radius: var(--kds-radius-component);
padding: var(--kds-space-card-padding);
box-shadow: var(--kds-elevation-1);
}
| Token | Rol |
|---|---|
--kds-color-text-primary | Texto principal |
--kds-color-text-secondary | Texto secundario |
--kds-color-brand-green | Verde de marca / éxito |
--kds-color-feedback-info | Info (#0376BB) |
--kds-color-feedback-warning | Advertencia (#B07400) |
--kds-color-feedback-error | Error |
--kds-sf-action | Color de acción (servicio) |
--kds-sf-on-action | Texto sobre acción |
--kds-font-display / --kds-font-body | Archivo / Inter |
--kds-space-related … --kds-space-section | Espaciado semántico |
--kds-radius-label … --kds-radius-pill | Radios |
--kds-elevation-0 … --kds-elevation-2 | Sombras |
--kds-button-m-height | Alto botón M (48px) |
--kds-motion-short | Duración corta (160ms) |
Sprite SVG en el CDN. Ejemplo completo; ver también la página Ícono.
<svg class="kds-icon" width="20" height="20" aria-hidden="true"> <use href="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty-icons.svg#kds-icon-search"></use> </svg>
Archivos oficiales (positivo / negativo, SVG y PNG). Mantén el ratio 8,34
(height: auto, sin forzar alto y ancho a la vez).
No hay listado de directorio en el CDN: usa las URLs absolutas de cada archivo.
<a class="kds-logo" href="/" aria-label="Laboratorio Keralty, inicio">
<img
src="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-positivo.svg"
alt=""
width="1134"
height="136"
style="height:40px;width:auto;max-width:100%"
/>
</a>
| Archivo | URL |
|---|---|
| Positivo SVG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-positivo.svg |
| Negativo SVG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-negativo.svg |
| Positivo PNG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-positivo.png |
| Negativo PNG | https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-negativo.png |
Guarda este archivo localmente; funciona con las URLs públicas del CDN.
<!doctype html>
<html lang="es">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Demo · Laboratorio Keralty</title>
<link rel="stylesheet" href="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty.min.css?v=1.0.0" />
</head>
<body data-kds data-service="institucional" data-surface="clara">
<header class="kds-header" data-config="institutional" style="display:flex;align-items:center;gap:16px;padding:16px 24px">
<a class="kds-logo" href="/" aria-label="Laboratorio Keralty, inicio">
<img
src="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/logos/laboratorio-keralty-horizontal-positivo.svg"
alt=""
width="1134"
height="136"
style="height:40px;width:auto;max-width:100%"
/>
</a>
<button class="kds-btn" data-variant="primary" data-size="m">
<svg class="kds-icon" width="20" height="20" aria-hidden="true">
<use href="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty-icons.svg#kds-icon-calendar-month"></use>
</svg>
Agendar cita
</button>
</header>
<main style="padding:24px;max-width:720px">
<div class="kds-toast" data-tone="success" role="status">
<span class="kds-toast__body">Listo para empezar con el CDN de Keralty.</span>
</div>
</main>
<script src="https://cdn.keralty.antpack.co/laboratorio/cdn/keralty/v1.0/keralty.min.js?v=1.0.0" defer></script>
</body>
</html>