Visão geral

Os tokens primitivos são o vocabulário cru da KDS. Eles não têm opinião sobre uso: um --color-blue-600 é apenas um azul específico, não um "primary". Um --radius-lg são 8 pixels, sem papel atribuído. A semântica vem na camada de cima.

O que vive aqui

Seis grupos, cada um com sua própria página:

Por que primitivos vêm primeiro

Quando a marca evolui — uma nova cor entra, o azul fica mais saturado, o radius aumenta — a alteração acontece aqui. Semânticos e tokens de chart referenciam primitivos via var(--color-<token>), então a mudança cascateia automaticamente.

Esse é o trade-off importante: ter primitivos ricos significa que você nunca está preso a um único tom. Ter primitivos em namespace Tailwind nativo significa que bg-blue-600 simplesmente funciona.

Quando você toca primitivos

Quase nunca em componentes — esse é o ponto. As exceções são:

• Marketing e ilustração que precisam de uma cor específica fora da paleta semântica.
• Utilitários estruturais (gap, padding) onde a escala geométrica é o token: p-4, gap-6.
• Adicionar um novo valor ao sistema — só acontece aqui.

Naming agnóstico

Todos os tokens primitivos usam o namespace nativo do Tailwind v4. Isso tem duas consequências práticas:

1. Utilitários como bg-amber-500, text-slate-700, rounded-2xl, shadow-md aparecem automaticamente — sem bridge code.
2. Os primitivos sobrescrevem os defaults do Tailwind. Editar --color-blue-600 em colors.css afeta todo lugar que usa blue-600, em qualquer tema.