Versión 1 — {{YEAR}}

Dátil — Brand Guide

Una guía corta para mantener Dátil reconocible. Tono cálido, papel, tinta sobria, un acento púrpura. Pensado para durar — no para seguir tendencias.

Marca

El símbolo (estrella en proporción cuadrada) acompaña al texto «Dátil». No alterar proporciones ni añadir efectos. Una sola forma — el color cambia según el producto.

Dátil

Marca matriz, neutra. IBM Plex Sans 700.

Familia de productos — color por línea

Cada producto adopta un color líder. La forma del logo es la misma; el color comunica la línea.

Identidad & Confianza

Teal, #1FB8C6

Firmas electrónicas, autenticación, certificados.

POS & Retail

Púrpura, #5B3F8F

Punto de venta, comercio físico, productos de retail.

Facturación & Contabilidad

Forest, #36603E

Facturación electrónica, libros contables, reportes.

Variantes utilitarias

Para casos donde el color de marca no aplica: prensa monocromática, fondos oscuros, marcas de agua.

Ink (mono, papel)

Ink, #241F18

Impresión, prensa, fax, monocromático sobre claro.

Paper (mono, oscuro)

Paper, #FBFAF6

Sobre fondos oscuros, marcas de agua, presentaciones nocturnas.

Color

El acento púrpura es el único color brillante. Todo lo demás es tierra cálida y tinta sobria. La paleta se sostiene en una superficie tipo papel — no en blanco puro.

Acento

Accent

#5B3F8F

Botones primarios, enlaces, énfasis

Accent, deep

#3F2566

Estado pressed / hover oscuro

Accent, tint

#5B3F8F18

Selección, fondo de chip activo

Superficie

Paper

#F5EFE2

Fondo principal de la página

Surface

#FBFAF6

Tarjetas, paneles elevados

Paper, hover

#ECE3D0

Filas / botones secundarios

Paper, line

#E0D7C5

Bordes, separadores

Tinta

Tinta cálida, nunca negro puro. Cuatro pesos según jerarquía.

Ink

#241F18

Títulos, énfasis, etiquetas fuertes

Body

#494535

Prosa de lectura — el peso default

Ink, mute

#6B6457

Texto secundario, navegación lateral

Ink, faint

#9C9586

Pistas, metadatos, separadores

Combinaciones texto — fondo

Siempre estas parejas. No mezclar otras combinaciones — la tabla es el contrato del sistema.

Fondo	Título	Cuerpo	Secundario	Pista / faint
Surface, canvas (`#FBFAF6`)	Ink	Body	Ink, mute	Ink, faint
Paper, panel (`#FAF5EB`)	Ink	Body	Ink, mute	Ink, faint
Paper, hover, table head, hover band (`#ECE3D0`)	Ink	Body	Ink, mute	—
Accent, tint, selección, highlight	Accent, deep, texto único permitido sobre el tint
Accent, botón / pill sólido	#FFFFFF, solo blanco sobre accent sólido
Slab, code block (`#1F1B12`)	Default `--n-150`, syntax via `--tok-*`

Tierra — acentos de soporte

Reservados para señalización funcional o categorías. Nunca en CTA principales.

Forest

#36603E

Éxito, validado

Moss

#5E8055

Estado positivo

Ochre

#B8852C

Advertencia, pendiente

Rust, Sienna

#A8523A

Énfasis cálido

Rose

#A75561

Error, destructivo

Steel

#62789A

Información neutral

Teal

#3D7878

Utilidad, datos

Plum

#6E4673

Acento alterno al púrpura

Tipografía

Familia única para los próximos años: IBM Plex Sans (cuerpo) + IBM Plex Mono (código y datos). Diseñadas juntas, métricas coordinadas, licencia OFL gratuita y permanente, 9 años en producción institucional.

Plex Sans — cuerpo

IBM Plex Sans, 600 / 500 / 400

Validación de comprobantes electrónicos.

SRI y SUNAT en una sola llamada. Stateless, observable, predecible.

Latín extendido + cirílico + griego + árabe + devanagari. Cobertura completa para expansión en Latinoamérica y más allá.

Plex Mono — código y datos

IBM Plex Mono, 500 / 400

curl https://api.datil.tax/v1/validations

{ "valid": true, "country": "ec", "checks": { "format": true } }

Por qué Plex (vs. los descartados)

Inter, default de Vercel, Linear, OpenAI, Anthropic console y todo producto AI 2022+. Máxima ubicuidad, mínima diferenciación. Evitada deliberadamente.
Mono como body (estilo Linear-pre-redesign / sri-crawl), distintivo y técnico, pero fatigoso a partir de 200 palabras y hostil para audiencias no-developer. Bueno para herramientas internas, riesgoso para superficies comerciales.
Geist, candidato fuerte; descartado solo por antigüedad (1 año vs 9 de Plex). Plan B si Plex no se sostiene tras 2–3 semanas en producción.
Söhne / GT America, excelentes pero pagados (~USD 600+ web), descartados por restricción de licencia.

Implementación

CSS

@import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap');

body { font-family: 'IBM Plex Sans', system-ui, sans-serif; }
code { font-family: 'IBM Plex Mono', ui-monospace, monospace; }

Espacio y radios

Escala de cuatro pasos. Compresión deliberada — el ritmo se sostiene con contraste de tamaño, no con espacio en blanco.

Radios discretos: 2, 3, 4, 6, 8. Nada redondo — la marca prefiere ángulos vivos.

Voz

Industrial, directa, sin marketing. Como un manual de operación: pocas palabras, todas cargadas. Español de Ecuador o Perú según la audiencia, sin neutralización.

Sí

Frases cortas. Una idea por oración.
Datos antes que adjetivos.
Ejemplos concretos.
Decir «no» cuando algo no aplica.

No

«Potente», «innovador», «revolucionario».
Listas de capacidades sin pruebas.
Disclaimers de tres párrafos.
Emojis en producto.

Convenciones de documentación API

Reglas comunes para todas las páginas de docs de productos Datil. Reusable a través del mismo style.css.

Separadores en texto

Caso	Separador	Ejemplo
Pareja título — contexto	Em-dash `—`	`document.tax_status — estado fiscal`
Lista de valores	Coma `,`	`EC, PE`
Namespace / breadcrumb	Slash `/`	`Dátil / API de validación`
Punto medio `·`	No usar	Decorativo. Reemplazar por em-dash o coma.

Encabezados de campo

Los <h4> que documentan un grupo de campos usan dos líneas: el código del campo arriba, una descripción humana en .subtitle abajo. La descripción nunca va inline con un separador. Esto permite que el encabezado se ajuste limpiamente en columnas estrechas.

`document.tax_status`Estado fiscal

<h4><code>document.tax_status</code><span class="subtitle">Estado fiscal</span></h4>

Indicador de campo requerido

Italic, muted, sin pill. Lee como una nota al margen, no como una alarma.

xml requerido

Método HTTP + path

Prefijo monoespaciado al <h2> del endpoint. Sin pill, sin flecha, sin etiqueta decorativa.

POST /v1/validations

Validar un documento

Don'ts rápidos

No fondo blanco puro. Siempre --paper o --surface.
No degradados, ni sombras grandes.
No el púrpura sobre los acentos tierra (chocan).
No iconografía blanda (curvas redondas, soft-shadows).
No mezclar más de dos colores tierra en una misma vista.
No el punto medio · como separador. Em-dash o coma.
No pills mayúsculas para etiquetas funcionales (requerido, opcional). Italic muted.
No flechas decorativas (▸ POST) ni numeración ornamental (§01).