Primeros pasos

Uso en código

Guía de consumo del Design System vía CDN. Prefijo de clases kds-. Compatible con HTML plano, React, Next u otro framework.

CDN · v1.0 HTML · CSS · JS

Instalación rápida

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>
AssetURL
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

Qué incluye el CSS

  • Fuentes Archivo (display) e Inter (cuerpo), vía Google Fonts.
  • Tokens de diseño como variables CSS --kds-* (color, tipografía, espacio, radius, elevación, botón, motion).
  • Estilos de componentes con clases .kds-* y atributos data-*.
  • Temas de servicio y superficie (data-service, data-surface).

Si solo necesitas las variables (sin componentes), puedes cargar tokens.css por separado.

Qué inicializa el JS

keralty.min.js expone window.KeraltyDS y llama KeraltyDS.init() al cargar el documento. Inicializa:

ComponenteSelectorAtributos / 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.

Temas: data-kds · data-service · data-surface

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>
AtributoValoresEfecto
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.

Tokens --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);
}
TokenRol
--kds-color-text-primaryTexto principal
--kds-color-text-secondaryTexto secundario
--kds-color-brand-greenVerde de marca / éxito
--kds-color-feedback-infoInfo (#0376BB)
--kds-color-feedback-warningAdvertencia (#B07400)
--kds-color-feedback-errorError
--kds-sf-actionColor de acción (servicio)
--kds-sf-on-actionTexto sobre acción
--kds-font-display / --kds-font-bodyArchivo / Inter
--kds-space-related … --kds-space-sectionEspaciado semántico
--kds-radius-label … --kds-radius-pillRadios
--kds-elevation-0 … --kds-elevation-2Sombras
--kds-button-m-heightAlto botón M (48px)
--kds-motion-shortDuración corta (160ms)

Íconos

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>
Buscar

Logos

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>
ArchivoURL
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

Página de arranque (HTML completo)

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>