Il 28 ottobre 2025 il Design Tokens Community Group del W3C ha pubblicato la prima versione stabile della sua specifica: un formato comune per descrivere colori, spaziature e scale tipografiche, in modo che passino da un programma di grafica al codice senza essere ricopiati a mano. I design token, racconta la specifica stessa, li aveva inventati qualche anno prima il team del design system di Salesforce.
Salesforce lavorava su un prodotto usato da milioni di persone, con un team di designer dedicato, ma il problema che i token risolvono è lo stesso che trovo nei siti delle PMI su cui lavoro ogni giorno. Nel post su UX e UI ho raccontato la richiesta che sento più spesso: “Vorrei un sito bello. Moderno. Pulito. Elegante.” La parola “coerente”, in quell’elenco, non compare quasi mai. Quando un sito sembra trascurato, però, molto spesso il motivo è proprio la coerenza che manca: tre grigi diversi, bottoni che cambiano forma da una pagina all’altra, titoli che a volte sono enormi e a volte no.
Un design system serve a questo. Fissa una volta per tutte come si presenta e come si comporta il sito, e lo fa rispettare a chiunque ci metta le mani, me compresa.
Un design system è un insieme di regole condivise
Designers Italia, che cura il design system della Pubblica Amministrazione, lo descrive come un insieme di indicazioni e risorse per realizzare interfacce usabili e accessibili. Dentro ci sono tre livelli:
- le fondamenta, cioè colori, caratteri, dimensioni del testo, spaziature, griglia e icone;
- i componenti, cioè i pezzi dell’interfaccia costruiti con quelle fondamenta: bottoni, card, form, menu, ognuno con i suoi stati (normale, al passaggio del mouse, disattivato, in errore);
- la documentazione, che spiega quando usare un componente e quando no.
Funziona un po’ come un negozio in franchising: entri in un punto vendita di un’altra città e riconosci subito il marchio, anche se il locale è diverso. Le regole sono le stesse e qualcuno le ha scritte prima di aprire.

Design system, style guide e UI kit sono tre cose diverse
Questi tre termini si usano spesso come sinonimi, e ogni volta che succede in una riunione si finisce a parlare di cose diverse senza accorgersene.
La style guide è il documento con le regole visive del brand: il logo e i suoi usi, i colori, i caratteri. Molte aziende ce l’hanno già, di solito in PDF, fatta da chi ha disegnato il marchio.
Lo UI kit è una libreria di componenti grafici, oggi quasi sempre in Figma, da trascinare nei mockup. Il design system .italia, per esempio, ha il suo UI Kit Italia.
Il design system comprende entrambi e aggiunge il codice e la documentazione. Designer e sviluppatori lavorano sulla stessa base, con gli stessi nomi: quando dico “bottone primario” a Christian, intendiamo la stessa identica cosa, nel file di design e nel sito.
I design token sono le decisioni più piccole
La specifica del W3C definisce i design token come i pezzi indivisibili di un design system: un colore, una spaziatura, un gradino della scala tipografica. Ogni token è una decisione con un nome.
Prendi il blu del brand. Invece di scrivere #1d4ed8 ovunque, lo chiami color-primary. Poi decidi che lo sfondo dei bottoni principali usa quel colore, e crei un secondo token, color-button-background, che rimanda al primo. La specifica chiama questi rimandi alias.
Il secondo token serve il giorno in cui il cliente decide che i bottoni devono diventare arancioni, mentre il blu resta il colore dei titoli: cambi l’alias del bottone e tutto il resto resta com’è. Senza token, quel giorno si passa a cercare a mano ogni bottone, sperando di non cambiare per sbaglio anche i titoli. Un mezzo dramma, te lo assicuro.

Le variabili CSS portano i token nel codice
Nel sito i token diventano variabili CSS, che chi sviluppa chiama anche custom properties:
:root {
--primary: #1d4ed8;
--button-bg: var(--primary);
}
.btn {
background-color: var(--button-bg);
}
Il nome nel file di design e il nome nel codice si somigliano, e questo è il punto di contatto tra il mio lavoro e quello di chi sviluppa. Anche la modalità scura diventa più semplice: per il tema scuro basta assegnare valori diversi alle stesse variabili, e i componenti si adattano da soli.
Come si lavora in Bricks, il builder che usiamo in PopCorn, lo spiega Christian nel suo post sugli stili globali di un sito in Bricks, con Theme Styles, variabili e classi.
Anche il sito di una PMI ha bisogno di coerenza
Il problema della coerenza di solito non si vede il giorno della messa online. Si presenta dopo qualche mese: il cliente aggiunge una pagina da solo, un altro fornitore prepara una landing per una campagna, qualcuno cambia il colore di un bottone “solo qui, solo per questa offerta”. Ogni modifica, presa da sola, è piccola. Dopo un anno il sito sembra cucito con pezzi di tre siti diversi.
Un design system evita questa deriva anche quando il sito è piccolo. Chiaro che a una PMI non serve un manuale di duecento pagine. Di solito bastano:
- una palette con pochi colori, ognuno con un ruolo preciso (principale, secondario, testo, sfondo, errore e conferma);
- due caratteri al massimo, con una scala di dimensioni definita;
- una scala di spaziature, perché lo spazio bianco funziona solo se è regolare;
- i componenti che usi: bottoni, card, form, intestazioni di sezione, header e footer.
Attenzione ai colori: quando li scegli, controlla subito il contrasto tra testo e sfondo. Un design system che nasce con un grigio chiaro illeggibile lo porta in ogni pagina, e correggerlo dopo costa MOLTO di più. Christian ne parla nel post sull’accessibilità dei siti web.
La coerenza poi va oltre il sito. Il preventivo in PDF, la newsletter, i post sui social: se usano gli stessi colori, gli stessi caratteri e lo stesso modo di parlare, l’azienda si riconosce ovunque. È il lato visivo di quello che il brand storytelling e il tone of voice fanno con le parole.
Su WordPress il design system nasce prima delle pagine
L’errore che vedo più spesso è partire dalle pagine. Si disegna la home, poi la pagina servizi, poi i contatti, e solo alla fine si prova a capire quali colori e quali bottoni si ripetono. A quel punto ogni pagina ha già le sue piccole varianti, e mettere ordine diventa un lavoro a parte.
L’ordine che seguo è il contrario: prima i token e i componenti nel file di design, poi la configurazione globale del builder, e solo dopo le pagine. Le pagine diventano quasi un montaggio di pezzi già pronti, e il cliente, quando aggiunge una pagina da solo, trova i pezzi giusti senza doverli inventare.
Dal file di design al builder
Ogni strumento di WordPress ha il suo modo di ospitare un design system.
Con l’editor a blocchi c’è theme.json, il file di configurazione introdotto con WordPress 5.8 nel 2021: ci definisci palette, caratteri, dimensioni e spaziature, e WordPress li trasforma in variabili CSS disponibili nell’editor e sul sito.
Elementor dalla versione 3.0 ha nelle impostazioni del sito una sezione che si chiama proprio Design System, con colori e font globali: quattro colori e quattro stili tipografici di base, a cui puoi aggiungere i tuoi. Per un sito semplice funziona bene, e se il tuo sito è già su Elementor non lo cambierei solo per questo.
Bricks, dalla versione 2.2, raccoglie tutto nello Style Manager: Theme Styles, classi, variabili, colori, scale di tipografia e spaziature. In PopCorn ci lavoriamo insieme ad Automatic.css, un framework che genera già variabili e classi a partire da poche impostazioni. È la soluzione che si sposa meglio con il modo in cui lavoriamo noi, perché permette di tenere il sistema in un posto solo anche quando il sito cresce.
Alcuni design system pubblici da studiare
Il modo migliore per capire un design system è sfogliarne uno vero. Questi sono pubblici e ben documentati.
Il design system .italia è quello della Pubblica Amministrazione italiana: open source, in italiano, con le fondamenta, i componenti, lo UI kit in Figma e il codice. A luglio 2026 Designers Italia ha rilasciato in beta il Dev Kit Italia, costruito con i web components. È un ottimo esempio di come si documentano le regole per persone che non si conoscono e lavorano su progetti diversi.
Material Design è il design system di Google, quello che vedi nelle app Android e nei servizi Google. È molto ampio, e conviene guardarlo soprattutto per capire come sono organizzati i token e gli stati dei componenti.
Il Lightning Design System di Salesforce è il posto in cui sono nati i design token. Per un sito aziendale è sovradimensionato, ma la sezione sui token aiuta a capire da dove arriva tutto questo discorso.
Nessuno di questi va copiato così com’è. Servono per vedere come altri hanno risolto problemi che prima o poi avrai anche tu.
Le domande da farti prima di aprire il builder
Torno alla richiesta da cui sono partita: un sito bello, moderno, pulito, elegante. Sono aggettivi legittimi, e un design system è il modo per farli durare anche dopo la messa online, quando sul sito cominciano a lavorare altre persone.
Prova a chiederti:
- quanti colori usa oggi il tuo sito, contando anche tutti i grigi?
- i bottoni hanno la stessa forma e lo stesso comportamento in tutte le pagine?
- se domani cambiassi il colore principale, in quanti punti dovresti intervenire?
- chi aggiunge una pagina nuova sa quali componenti usare, o se li inventa ogni volta?
- il tuo preventivo in PDF e il tuo sito sembrano della stessa azienda?
Se a qualcuna hai risposto “non lo so”, parti da un inventario: una pagina con tutti i colori, i caratteri e i bottoni che il sito usa oggi. Da quell’elenco si capisce subito cosa tenere, cosa unificare e cosa togliere.




