Design token con Style Dictionary
Definire in JSON i token per colori, spaziatura e tipografia e trasformarli con Style Dictionary in variabili CSS, costanti JS o formati iOS/Android
Design token con Style Dictionary è una lezione Frontend Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Frontend Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Frontend Academy include 4 lezioni in totale.
Che cosa sono i design token
I design token sono i valori primitivi denominati di un design system: colori, spaziature, dimensioni dei caratteri, raggi dei bordi e ombre. Sono la fonte di verità: ogni componente deriva da essi i propri stili.
Perché i token sono importanti
I token separano le decisioni di design dall'implementazione. Cambiando una volta color.primary da blu a verde, ogni componente che lo utilizza si aggiorna. Consentono inoltre di distribuire lo stesso design su web, iOS e Android.
Dove memorizzare i token
Memorizzare i token in JSON o YAML, formati neutrali utilizzabili dagli strumenti su più piattaforme. JSON è il formato più comune.
// tokens/color.json
{
"color": {
"brand": {
"primary": { "value": "#2563eb" },
"secondary": { "value": "#7c3aed" }
},
"text": {
"default": { "value": "#111827" },
"muted": { "value": "#6b7280" }
}
}
}Style Dictionary
Style Dictionary (Amazon) è lo strumento di build de facto per i design token. Legge i token e li trasforma in diversi formati di output: variabili CSS, SCSS, costanti JS, Swift per iOS, XML per Android.
npm install -D style-dictionaryConfigurazione
Creare style-dictionary.config.js per descrivere i token di input e le piattaforme di output.
// style-dictionary.config.js
module.exports = {
source: ['tokens/**/*.json'],
platforms: {
css: {
transformGroup: 'css',
buildPath: 'build/css/',
files: [{ destination: 'tokens.css', format: 'css/variables' }]
},
js: {
transformGroup: 'js',
buildPath: 'build/js/',
files: [{ destination: 'tokens.js', format: 'javascript/es6' }]
},
ios: {
transformGroup: 'ios',
buildPath: 'build/ios/',
files: [{ destination: 'Tokens.swift', format: 'ios-swift/class.swift' }]
}
}
};Eseguire la build
Eseguire la CLI per generare l'output per tutte le piattaforme.
npx style-dictionary build
# Output:
# build/css/tokens.css — CSS variables
# build/js/tokens.js — JS constants
# build/ios/Tokens.swift — Swift constantsOutput CSS generato
Variabili CSS con uno schema di denominazione coerente (kebab-case con namespace).
:root {
--color-brand-primary: #2563eb;
--color-brand-secondary: #7c3aed;
--color-text-default: #111827;
--color-text-muted: #6b7280;
}Output JS generato
Oggetto JS da usare nel codice JS/TS (configurazione di Tailwind, CSS-in-JS).
export const ColorBrandPrimary = '#2563eb';
export const ColorBrandSecondary = '#7c3aed';
export const ColorTextDefault = '#111827';Convenzioni per i nomi dei token
Usare nomi semantici (color.primary) invece di nomi letterali (color.blue-500). I token semantici consentono di cambiare i valori senza rinominare i token. Sistema a due livelli: palette letterale (blue-500) → alias semantico (primary).
{
"color": {
"palette": {
"blue-500": { "value": "#2563eb" }
},
"brand": {
"primary": { "value": "{color.palette.blue-500.value}" }
}
}
}Creare temi con i token
Creare build per più piattaforme con input diversi per supportare i temi (chiaro/scuro): stessi nomi, valori diversi.
// Light theme:
--color-bg: white;
--color-text: black;
// Dark theme:
--color-bg: #111;
--color-text: white;Categorie di token
Categorie comuni: color, spacing, typography (font-family, size, line-height, weight), border (radius, width), shadow, transition (duration, easing), z-index, breakpoint.
Strumenti per il registro dei token
Oltre a Style Dictionary: Tokens Studio (plugin di Figma), Specify, Supernova. Consentono ai designer di gestire i token in Figma e sincronizzarli automaticamente con il codebase.
Verifica rapida
Qual è il principale vantaggio dell'uso dei design token con Style Dictionary?
Riepilogo: design token
I token sono valori primitivi denominati (colore, spaziatura, tipografia), la fonte di verità di un design system. Si memorizzano come JSON. Style Dictionary li trasforma in variabili CSS, JS, iOS e Android. Preferire nomi semantici (primary) a quelli letterali (blue-500). Sistema a due livelli: palette → alias semantico. Temi tramite build separate. Sincronizzazione da Figma tramite Tokens Studio.
Domande Frequenti
La lezione «Design token con Style Dictionary» è gratuita?
Sì — il testo completo di «Design token con Style Dictionary» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Frontend Academy, passa a CoddyKit PRO. Il corso Frontend Academy include 4 lezioni in totale.
Cosa imparerò in «Design token con Style Dictionary»?
Definire in JSON i token per colori, spaziatura e tipografia e trasformarli con Style Dictionary in variabili CSS, costanti JS o formati iOS/Android Eserciti Frontend Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Frontend Academy?
Non è richiesta alcuna esperienza precedente. Frontend Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Design token con Style Dictionary»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Frontend Academy?
Sì. Ogni lezione Frontend Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Storybook: stories, controlli e documentazione
- Design token con Style Dictionary
- Versioning e pubblicazione su npm
- Utilizzare un design system