Gestion de design tokens con Claude Code: guia para UI consistente

Optimizando la gestion de design tokens con Claude Code

Los design tokens son un mecanismo para gestionar de forma centralizada las decisiones de diseno como colores, tipografia y espaciado. Con Claude Code, puedes construir eficientemente desde la definicion de tokens hasta la generacion de codigo.

Definicion de tokens

Diseno de tokens basado en JSON

> Define design tokens conforme a la especificacion del
> W3C Design Tokens Community Group.
> Incluye color, tipografia, espaciado y radio de borde.

{
  "color": {
    "primary": {
      "50": { "$value": "#eff6ff", "$type": "color" },
      "100": { "$value": "#dbeafe", "$type": "color" },
      "500": { "$value": "#3b82f6", "$type": "color" },
      "600": { "$value": "#2563eb", "$type": "color" },
      "700": { "$value": "#1d4ed8", "$type": "color" },
      "900": { "$value": "#1e3a8a", "$type": "color" }
    },
    "semantic": {
      "background": {
        "default": { "$value": "{color.primary.50}", "$type": "color" },
        "inverse": { "$value": "{color.primary.900}", "$type": "color" }
      },
      "text": {
        "default": { "$value": "#1a1a1a", "$type": "color" },
        "muted": { "$value": "#6b7280", "$type": "color" },
        "inverse": { "$value": "#ffffff", "$type": "color" }
      }
    }
  },
  "typography": {
    "fontSize": {
      "xs": { "$value": "0.75rem", "$type": "dimension" },
      "sm": { "$value": "0.875rem", "$type": "dimension" },
      "base": { "$value": "1rem", "$type": "dimension" },
      "lg": { "$value": "1.125rem", "$type": "dimension" },
      "xl": { "$value": "1.25rem", "$type": "dimension" },
      "2xl": { "$value": "1.5rem", "$type": "dimension" }
    },
    "fontWeight": {
      "normal": { "$value": "400", "$type": "fontWeight" },
      "medium": { "$value": "500", "$type": "fontWeight" },
      "bold": { "$value": "700", "$type": "fontWeight" }
    }
  },
  "spacing": {
    "1": { "$value": "0.25rem", "$type": "dimension" },
    "2": { "$value": "0.5rem", "$type": "dimension" },
    "4": { "$value": "1rem", "$type": "dimension" },
    "8": { "$value": "2rem", "$type": "dimension" },
    "16": { "$value": "4rem", "$type": "dimension" }
  },
  "radius": {
    "sm": { "$value": "0.25rem", "$type": "dimension" },
    "md": { "$value": "0.375rem", "$type": "dimension" },
    "lg": { "$value": "0.5rem", "$type": "dimension" },
    "full": { "$value": "9999px", "$type": "dimension" }
  }
}

Generacion de codigo con Style Dictionary

Salida multiplataforma

> Crea la configuracion de Style Dictionary.
> Genera salida para variables CSS, constantes TypeScript e iOS/Android.

// style-dictionary.config.js
import StyleDictionary from 'style-dictionary';

export default {
  source: ['tokens/**/*.json'],
  platforms: {
    css: {
      transformGroup: 'css',
      buildPath: 'dist/css/',
      files: [{
        destination: 'variables.css',
        format: 'css/variables',
        options: { outputReferences: true },
      }],
    },
    typescript: {
      transformGroup: 'js',
      buildPath: 'dist/ts/',
      files: [{
        destination: 'tokens.ts',
        format: 'javascript/es6',
      }],
    },
    ios: {
      transformGroup: 'ios-swift',
      buildPath: 'dist/ios/',
      files: [{
        destination: 'StyleDictionary.swift',
        format: 'ios-swift/class.swift',
      }],
    },
  },
};

Variables CSS generadas:

:root {
  --color-primary-500: #3b82f6;
  --color-primary-600: #2563eb;
  --color-semantic-text-default: #1a1a1a;
  --spacing-4: 1rem;
  --radius-md: 0.375rem;
}

Soporte de modo oscuro

Con tokens semanticos, el soporte de modo oscuro tambien es sencillo.

[data-theme="dark"] {
  --color-semantic-background-default: var(--color-primary-900);
  --color-semantic-text-default: #f3f4f6;
}

Integracion con Figma

Tambien puedes consultar con Claude Code sobre la sincronizacion entre Figma Variables y el JSON de design tokens. Es posible generar scripts de extraccion de tokens usando la API REST de Figma.

Resumen

Con Claude Code, puedes construir eficientemente desde la definicion de design tokens hasta la generacion de codigo con Style Dictionary y el soporte multiplataforma. Consulta tambien la construccion de sistemas de diseno, la guia de CSS/estilizado y la implementacion de modo oscuro.

Para mas detalles sobre Style Dictionary, consulta la documentacion oficial de Style Dictionary.