Il problema

Il design system esistente era nato per un solo prodotto. Accanto c’erano tre librerie di componenti separate, una per il backoffice, una per l’e-commerce B2B e una per la forza vendita, che condividevano solo le foundations. I designer finivano per creare componenti locali e le progettazioni perdevano coerenza.

Ogni cliente che voleva l’interfaccia con i propri colori significava ritoccare componenti a mano, in Figma e nel codice, con il rischio costante che design e sviluppo divergessero. E la struttura dei token aveva un limite pesante per i clienti: prevedeva un solo colore di brand. Quando un cliente ne chiedeva due, non c’era un modo pulito per accontentarlo.

In più avevamo un obiettivo che a marzo era ancora insolito: rendere i componenti abbastanza coerenti e strutturati da poter essere usati anche da strumenti e agenti AI, per generare interfacce e prototipi fedeli al sistema.

Vincoli

  • Nessun team dedicato. Ero l’unico designer interno sul progetto, affiancato da un consulente esterno e da due sviluppatori frontend: uno per le decisioni tecniche, uno per l’implementazione dei componenti.
  • Una consulenza con tempi e perimetro concordati, da rinegoziare quando il progetto ha dovuto assorbire l’integrazione di un intero UI kit per le tabelle.
  • Prodotti già in uso dai clienti, sviluppati in Angular.

Come è partito

A marzo, insieme alla responsabile del team UX, ho preparato il brief e incontrato due consulenti esterni specializzati, mostrando lo stato dei design system esistenti. Il kickoff è stato a fine maggio, con office hours settimanali per tutta la durata del progetto.

  1. Marzo 2026Brief e scelta del partnerStato dei design system esistenti, due proposte a confronto.
  2. Fine maggioKickoffAudit del design system precedente e dei prodotti, foundations, struttura dei token.
  3. EstatePipeline e componentiPipeline verso lo sviluppo, componenti e pattern; a fine agosto, la scelta di rifare invece di rattoppare.
  4. Ottobre 2026ConsegnaQuattro sessioni di formazione, documentazione, team autonomo.
Le tappe del progetto, dal brief alla consegna al team.

Le decisioni chiave

1. Un partner per l’architettura, non per i componenti

Decisione
Abbiamo scelto la proposta che costruiva un sistema di token capace di reggere tutti i brand, con variabili responsive, tipografia adattiva e un passaggio automatico dal design al codice.
Alternativa scartata
Una consulenza centrata sul disegno dei componenti.
Perché
Il problema non erano i singoli componenti, ma la struttura che doveva reggerne le varianti per brand e per prodotto.

2. Tre collezioni di token, non una catena a tre livelli

Decisione
I primitivi (20 famiglie di colore, spaziature a passi di 4 px, raggi, bordi, tipografia) sono identici per tutti i brand. La personalità di ogni cliente vive solo nei semantici, che pescano dai primitivi. Una terza collezione, i responsive, gestisce i valori che cambiano con il breakpoint. I token dei singoli componenti stanno dentro i semantici, in un gruppo dedicato.
Alternativa scartata
Un livello di token separato per i componenti.
Perché
Con tanti componenti, un livello in più moltiplica la complessità e fa calare la consistenza.
Che cosa ha comportato
Aggiungere un brand significa creare una nuova modalità dei semantici. Dai colori del cliente si generano le palette e si collegano ai ruoli, senza toccare un componente.
Primitivi Uguali per tutti i brand 20 famiglie di colore, spaziature a passi di 4 px, raggi, bordi, tipografia
Semantici Una modalità per brand Colore primario, sfondi, testi, bordi, raggi del brand Token di componente: un gruppo dedicato dentro i semantici
Responsive Una modalità per breakpoint Dimensioni e interlinee che cambiano con lo schermo
Le tre collezioni di Nile. I semantici e i responsive partono entrambi dai primitivi, su due assi diversi: il brand e il breakpoint.
Brand
Stato
Dispositivo

TokenValoreCosa lo fa cambiareStato attuale
semantic › specific/button/primary/filled/background#F2B705Il brandIn uso
semantic › specific/button/primary/filled/backgroundHover#D9A404Il brand
semantic › specific/button/primary/filled/foreground#1A1A1AIl brandIn uso
semantic › brand/radius/component2pxIl brandIn uso
semantic › brand/fontFamily/mainHelvetica NeueIl brandIn uso
semantic › colors/background/page#26282BIl brandIn uso
semantic › dimension/md32pxIl dispositivoIn uso
primitives › spacing/sm8pxIl dispositivoIn uso
primitives › sizes/4xl80pxIl dispositivoIn uso
responsive › fontSize/ui/button16pxNiente: è condivisoIn uso
responsive › lineHeight/ui/button16pxNiente: è condivisoIn uso
responsive › breakpoint/width1440pxIl dispositivoIn uso
semantic › layerOpacity/disabled50%Niente: è condiviso
Lo stesso bottone primary · filled in tre brand inventati, Ardesia (tecnico-industriale), Velluto (moda) e Brezza (servizi), su tre dispositivi, con i nomi dei token di Nile. I semantici seguono il brand; il dispositivo sceglie la size (md con il mouse, xl con il touch) e il breakpoint; la misura del testo e l’opacità del disabilitato restano uguali. Il componente non viene mai toccato. I valori sono inventati.

Un bottone, tre brand

  1. Lo stesso bottone primary · filled nel brand Ardesia: sono i semantici del brand a decidere colore, raggio e font.

  2. In hover cambia un solo token: lo sfondo passa a specific/button/primary/filled/backgroundHover.

  3. Disabilitato: l’opacità viene da layerOpacity/disabled, uguale per tutti i brand.

  4. Cambiando brand cambiano solo i valori dei semantici: Velluto ha un altro colore, un altro raggio, un altro font.

  5. Brezza: stesso componente, stessi nomi dei token, valori diversi. Il componente non viene mai toccato.

  6. Con il touch il dispositivo sceglie la size xl e il breakpoint; la misura del testo resta uguale.

3. Una pipeline al posto dell’export a mano

Decisione
I token escono da Figma con un plugin in formato standard W3C, arrivano nel repository e una pipeline genera i CSS e pubblica il pacchetto usato dal frontend. La convenzione dei commit decide il tipo di rilascio.
Alternativa scartata
Esportare i CSS e passarli allo sviluppo a mano, come si faceva prima.
Perché
Design e sviluppo leggono la stessa fonte di verità e nessun valore viene più copiato a mano. Ho curato la pubblicazione dei plugin come strumenti privati dell’organizzazione, così ogni designer può usarli senza configurazioni da sviluppatore.
  1. FigmaVariabili, una modalità per brand
  2. PluginEsporta i token in JSON standard W3C
  3. RepositoryUna sola fonte di verità
  4. PipelineGenera i CSS e pubblica il pacchetto
  5. Libreria AngularI prodotti usano i token aggiornati
Il percorso dei token dal design al codice, senza passaggi manuali.

4. Rifare invece di rattoppare

Decisione
A fine agosto, davanti al nodo più delicato del progetto, abbiamo scelto un refactor vero dei componenti mancanti con il team interno. La maggior parte è stata ricostruita; solo alcuni sono stati ricollegati ai nuovi token.
Alternativa scartata
Collegare i vecchi componenti ai nuovi token così com’erano.
Perché
Era più veloce sulla carta, ma avrebbe portato dentro Nile il debito del sistema precedente. In parallelo abbiamo rinegoziato il perimetro della consulenza.

5. Densità per tipo di puntatore, non per larghezza

Decisione
Cinque fasce di breakpoint condivise da tutti i prodotti. La densità dei componenti non dipende dalla larghezza dello schermo ma dal puntatore: touch significa densità comoda, mouse significa compatta, a qualsiasi dimensione.
Perché
Gli stessi componenti devono funzionare su un backoffice usato da desktop, su un e-commerce usato soprattutto da smartphone e su un’app tablet usata sul campo.

Il mio ruolo, giorno per giorno

  • Coordinamento: tempi, milestone e Gantt con il consulente; approvazione delle scelte di architettura.
  • Progettazione: ho progettato il 60% dei componenti e migrato i più complessi del vecchio sistema, come la card in versione griglia, con slot e varianti per dispositivo e stato.
  • Qualità: audit sistematici dei componenti con l’assistente AI di Nile, trovando e correggendo violazioni ricorrenti: token basati sull’opacità, placeholder rimasti nei file, nomi delle proprietà incoerenti.
  • Governance: ho impostato da zero il tracciamento del lavoro di design e sviluppo, pensato per un modello federato in cui contribuiscono designer e frontend.

Nile «AI ready»

Ramses è l’assistente AI che custodisce le regole di Nile: conosce architettura, convenzioni di naming, proprietà dei componenti e regole di documentazione. Lo usiamo per verificare un componente prima del rilascio, per generare le griglie di specifica e per migrare i componenti legacy sui nuovi token. Ogni regola nuova entra nell’assistente con versione e changelog.

La documentazione è strutturata e i componenti vivono in una libreria Figma ordinata, che gli agenti AI possono leggere e ricostruire tramite MCP. Così il sistema resta leggibile sia dalle persone sia dalle macchine.

Consegna e adozione

Prima della chiusura della consulenza, a ottobre, ho progettato un passaggio di conoscenza in quattro sessioni, con plenarie e momenti separati per design e frontend. Le lezioni registrate sono diventate una documentazione tematica, riutilizzabile come manuale, insieme alla guida di installazione dei plugin.

Da ottobre gli sviluppatori implementano i componenti nella libreria Angular, documentati in Storybook, e li segnano come completati direttamente dalla Dev Mode di Figma. La documentazione di Nile, con foundations e componenti, è in pubblicazione come sito interno.

Risultati

  • 7 brand su un’unica architettura. Aggiungere un cliente significa creare una nuova modalità di token, non modificare componenti.
  • Due colori di brand invece di uno. Il sistema precedente concedeva a ogni cliente un solo colore: era una delle limitazioni più pesanti. Ora ogni brand ne ha due, un primario e un secondario, ciascuno con le sue tonalità.
  • Anche le icone si personalizzano. Abbiamo introdotto quattro librerie di icone, una delle quali è lo standard, e un plugin che le sostituisce in pochi passaggi nei file di design. È una possibilità di personalizzazione pensata per essere venduta ai clienti.
  • Una libreria web al posto di due. Le librerie del backoffice e dell’e-commerce B2B sono diventate un’unica libreria: 75 component set, circa 1.800 varianti, 83 componenti pubblici.
  • Foundations condivise da tutti i prodotti. Oggi Nile è usato dal backoffice e dall’e-commerce B2B; il prossimo è l’app per la forza vendita, con una nuova libreria mobile.
  • Dal design al codice senza copia-incolla. Una sola fonte di verità per design e sviluppo.
  • Un team autonomo. Il progetto si è chiuso nei tempi concordati e oggi gli sviluppatori implementano i componenti senza supporto esterno.

Prossimi passi: misurare l’impatto

Ora che il sistema è consegnato, il passo successivo è dimostrarne il valore con i numeri. Misureremo il tempo per attivare un nuovo brand, la percentuale di componenti completamente tokenizzati e implementati, e le domande degli sviluppatori per componente, come indicatore della chiarezza delle specifiche. Il primo dato arriverà dai commenti già presenti nei file di Nile; gli altri con i prossimi rilasci e con la prima attivazione di un nuovo brand.

Cosa ho imparato

Un design system federato, senza un team dedicato, regge solo se le regole sono scritte in modo che chiunque, persona o strumento, possa applicarle senza chiedere. E i momenti in cui conviene rallentare, come rifare un componente invece di limitarsi a tokenizzarlo, sono quelli che fanno risparmiare di più dopo.

Perché si chiama Nile

L’azienda per cui l’ho creato prende il nome dal dio egizio del disco solare, a cui il faraone Akhenaton diede un ruolo centrale. Da lì Nile: il fiume che attraversa territori diversi restando uno solo, la metafora giusta per un sistema che serve molti brand.

Anche gli strumenti seguono la stessa mitologia. Hapi, il dio del Nilo, è il plugin che porta i token da Figma al repository; Kemi, l’antico nome dell’Egitto, è il plugin per cambiare famiglia di icone; Ramses è l’assistente AI che custodisce le regole del sistema; Delta, come la foce del fiume, è la pipeline che converte i token da JSON a CSS.