Design systems: o singură sursă de adevăr.
Un site cinematic pare gândit pentru că fiecare mărime, culoare și mișcare vine dintr-o listă scurtă de decizii. Scrie lista o singură dată, ca tokenuri, și construiți din ea și tu, și AI-ul.
Ce vei învăța
La finalul capitolului- 01Transformi culoarea, tipografia, spațiul și mișcarea într-o listă scurtă de tokenuri cu nume.
- 02Construiești componente care citesc tokenuri și nu țin niciodată valori brute.
- 03Faci o temă sau o variantă cu mișcare redusă schimbând tokenuri, nu reguli.
- 04Scrii un
DESIGN.mdcare ține AI-ul consecvent de la prima secțiune la ultima.
01 · Tokenuri
Patru tipuriCuloare
Numește culorile după rolul lor, nu după nuanță: --accent și --muted, nu --blue. O pagină minimalistă are nevoie de cinci-șase, cu un singur accent.
Tipografie
O scară de patru-cinci trepte. Fiecare treaptă e un clamp(), așa că titlurile cresc odată cu ecranul fără un breakpoint pentru fiecare mărime.
Spațiu
O unitate și multiplii ei. Când fiecare spațiu e 8, 16, 24, 48 sau 96, secțiunile se aliniază fără să măsoare cineva.
Mișcare
Duratele, curbele de easing și distanțele sunt și ele decizii de design. Trei durate și două curbe acoperă aproape orice mișcare pe un site cu scroll.
:root {
/* culoare: numită după rol, nu după nuanță */
--bg: #000; --surface: #070a0d; --line: #20262b;
--fg: #eaf0f4; --muted: #8d989f; --accent: #5cc8ff;
/* tipografie: o scară scurtă care crește cu ecranul */
--t-sm: 13px;
--t-md: clamp(15px, 1.2vw + 12px, 18px);
--t-lg: clamp(22px, 2.4vw + 14px, 32px);
--t-xl: clamp(40px, 8vw, 112px);
/* spațiu: o unitate și multiplii ei */
--s1: 8px; --s2: 16px; --s3: 24px; --s4: 48px; --s5: 96px;
/* mișcare: trei durate, două curbe, o distanță */
--dur-fast: .2s; --dur-base: .6s; --dur-slow: 1.2s;
--ease-out: cubic-bezier(.2, .7, .2, 1);
--ease-in-out: cubic-bezier(.65, 0, .35, 1);
--rise: 24px;
}02 · Tokenuri, live
Apasă butonul, apoi deruleazăO pagină construită doar din tokenuri
Fiecare valoare din pagina de mai jos citește o variabilă. Butonul schimbă un singur token, --accent, iar etichetele, marginile și conturul de focus îl urmează toate.
Reducerea mișcării se rezolvă la fel: media query-ul pune duratele pe zero, în loc să rescrie fiecare tranziție.
<header class="top">
<span class="brand">Field</span>
<button class="swap" type="button" aria-pressed="false">Change the accent</button>
</header>
<h1 class="t-xl">One set of tokens.</h1>
<p class="t-md muted">Every size, gap, colour and timing on this page comes from the variables at the top of the CSS.</p>
<div class="grid">
<article class="card reveal"><span class="t-xs">01</span><h2 class="t-lg">Type scale</h2><p class="muted">Four steps, each one a clamp.</p></article>
<article class="card reveal"><span class="t-xs">02</span><h2 class="t-lg">Spacing</h2><p class="muted">Multiples of one unit.</p></article>
<article class="card reveal"><span class="t-xs">03</span><h2 class="t-lg">Motion</h2><p class="muted">Two durations and one curve.</p></article>
</div>03 · Componentele citesc tokenuri
Niciodată valori bruteO singură regulă
O componentă nu scrie niciodată o culoare, o mărime, un spațiu sau o durată brută. Dacă îi trebuie o valoare care nu există, adaugi întâi un token, apoi îl folosești.
.btn {
padding: var(--s1) var(--s3);
font-size: var(--t-sm);
color: var(--fg);
border: 1px solid var(--line);
border-radius: 99px;
transition: border-color var(--dur-fast) var(--ease-out);
}
.btn:hover, .btn:focus-visible { border-color: var(--accent); }
/* o variantă schimbă tokenuri, nu reguli */
.btn[data-tone="solid"] { background: var(--accent); color: var(--bg); border-color: var(--accent); }Variante prin atribute
O variantă precum data-tone="solid" schimbă câteva tokenuri. Markup-ul rămâne lizibil, iar AI-ul nu poate inventa a șaptea nuanță de gri.
Cu Tailwind
În Tailwind 4 aceleași tokenuri intră într-un bloc @theme și devin clase precum bg-accent. Regula nu se schimbă: doar utilitare, fără valori arbitrare.
04 · Un fișier de design pentru AI
DESIGN.mdScrie deciziile
Pune un DESIGN.md scurt lângă fișierul cu regulile proiectului. AI-ul îl citește înaintea fiecărei schimbări, așa că a cincea secțiune arată ca prima.
# DESIGN.md
## Atmosferă
Liniștit, întunecat, editorial. O idee pe ecran. Mișcarea e lentă și rară.
## Tokenuri
Toate valorile stau în :root, în style.css. Nu scrie nicăieri altundeva
o culoare, o mărime, un spațiu sau o durată brută. Dacă lipsește o valoare,
adaugă întâi un token.
## Tipografie
Cel mult două familii. Titluri subțiri (300), spațiere strânsă (-0.04em).
Text 15–18px, înălțimea rândului 1.5, rânduri de cel mult 65 de caractere.
## Culoare
Fundal negru, un singur accent (--accent) pentru linkuri, focus și progres.
Textul are contrast de cel puțin 4.5:1.
## Mișcare
Apariții: în sus cu --rise, în --dur-base, cu --ease-out, o singură dată.
Scene derulate: fără easing (scrollul e easing-ul).
Sub prefers-reduced-motion nu se mișcă nimic: duratele devin 0.
## Nu
Degradeuri pe text, carduri de sticlă, sărituri, mai mult de un accent,
cifre sau logouri inventate.Trimite AI-ul la el
Citește DESIGN.md și tokenurile din :root din style.css înainte să schimbi ceva. Folosește doar acele tokenuri. Dacă îți trebuie o valoare nouă, propune întâi tokenul și așteaptă răspunsul meu.Verifică abaterile
Listează fiecare culoare, mărime de font, spațiu și durată din CSS care nu vine dintr-un token. Pentru fiecare, spune ce token ar trebui să folosească sau propune unul nou.05 · Rămâi minimalist
Decizii mai puține, mai fermeUn singur accent
Marchează ce se poate apăsa, ce are focus și cât ai citit. Folosit în altă parte, nu mai înseamnă nimic.
Cel mult două familii
Una pentru text și, opțional, una monospace pentru etichete. Grosimea și mărimea duc ierarhia.
O curbă pentru aproape toată mișcarea
Un singur ease-out pentru apariții și tranziții face ca tot site-ul să se miște ca dintr-o singură mână. Scenele derulate nu au niciuna: scrollul e easing-ul.
Spațiu înainte de decor
Când o secțiune pare goală, adaugă spațiu în jurul ei, nu un degradeu, o umbră sau încă un card.
Practică · Lucrul cu AI
Aceeași sarcină, în unealta taAI-ul extrage bine tokenuri dintr-un CSS existent și le respectă prost dacă nu i se cere. Fă-le pe amândouă, în această ordine.
Deschide un terminal în folderul proiectului și rulează claude. Apasă Shift+Tab până se pornește modul plan, lipește promptul, citește planul, apoi aprobă-l. Regulile proiectului stau în CLAUDE.md.
Extrage tokenurile
Citește CLAUDE.md și style.css. Propune un set de tokenuri pentru site-ul pentru [subiect]: culori numite după rol, o scară tipografică de patru-cinci trepte clamp(), o scară de spațiere dintr-o singură unitate și tokenuri de mișcare (durate, easing, distanță). Arată-mi blocul :root și un tabel cu valorile brute pe care le înlocuiește fiecare token. Nu edita încă CSS-ul.Scrie DESIGN.md
Scrie DESIGN.md pentru site-ul pentru [subiect], din tokenurile convenite: atmosfera într-un rând, regulile tokenurilor, tipografia, culoarea, mișcarea și o listă scurtă de lucruri de evitat. Sub 60 de rânduri. Apoi adaugă în CLAUDE.md un rând care îți spune să citești DESIGN.md înaintea oricărei schimbări vizuale.Deschide un terminal în folderul proiectului și rulează gemini; prima dată te întreabă dacă ai încredere în folder, așa că răspunde da pentru proiectul tău. Lipește promptul. Gemini CLI cere voie înainte să editeze un fișier sau să ruleze o comandă: citește fiecare cerere înainte s-o accepți. Regulile proiectului stau în GEMINI.md.
Extrage tokenurile
Citește GEMINI.md și style.css. Propune un set de tokenuri pentru site-ul pentru [subiect]: culori numite după rol, o scară tipografică de patru-cinci trepte clamp(), o scară de spațiere dintr-o singură unitate și tokenuri de mișcare (durate, easing, distanță). Arată-mi blocul :root și un tabel cu valorile brute pe care le înlocuiește fiecare token. Nu edita încă CSS-ul.Scrie DESIGN.md
Scrie DESIGN.md pentru site-ul pentru [subiect], din tokenurile convenite: atmosfera într-un rând, regulile tokenurilor, tipografia, culoarea, mișcarea și o listă scurtă de lucruri de evitat. Sub 60 de rânduri. Apoi adaugă în GEMINI.md un rând care îți spune să citești DESIGN.md înaintea oricărei schimbări vizuale.Deschide un terminal în folderul proiectului, rulează codex, lipește promptul și aprobă fiecare schimbare. În aplicația ChatGPT fără Codex, atașezi fișierele, lipești promptul și copiezi singur schimbările înapoi. Regulile proiectului stau în AGENTS.md.
Extrage tokenurile
Citește AGENTS.md și style.css. Propune un set de tokenuri pentru site-ul pentru [subiect]: culori numite după rol, o scară tipografică de patru-cinci trepte clamp(), o scară de spațiere dintr-o singură unitate și tokenuri de mișcare (durate, easing, distanță). Arată-mi blocul :root și un tabel cu valorile brute pe care le înlocuiește fiecare token. Nu edita încă CSS-ul.Scrie DESIGN.md
Scrie DESIGN.md pentru site-ul pentru [subiect], din tokenurile convenite: atmosfera într-un rând, regulile tokenurilor, tipografia, culoarea, mișcarea și o listă scurtă de lucruri de evitat. Sub 60 de rânduri. Apoi adaugă în AGENTS.md un rând care îți spune să citești DESIGN.md înaintea oricărei schimbări vizuale.Practică · Exerciții
Încearcă, apoi comparăNumește după rol
Redenumește după rol aceste tokenuri: --blue, --grey-400, --white, --dark.
Indiciu: întreabă-te ce face fiecare culoare în pagină.
Arată soluția
De exemplu --accent, --muted, --fg și --bg (sau --surface). Numele după rol supraviețuiesc unei schimbări de paletă; numele după nuanță devin minciuni în ziua în care accentul se face portocaliu.
Mișcare redusă prin tokenuri
Oprește fiecare tranziție din pagină sub mișcare redusă, cu o singură regulă.
Indiciu: fiecare tranziție citește deja un token de durată.
Arată soluția
Pune tokenurile de durată pe zero în media query. Fiecare regulă care le folosește urmează.
@media (prefers-reduced-motion: reduce) {
:root { --dur-fast: 0s; --dur-base: 0s; --dur-slow: 0s; }
}Găsește abaterile
Găsește trei valori brute în CSS-ul tău care ar trebui să fie tokenuri.
Indiciu: caută #, px și s în afara :root.
Arată soluția
Găsiri obișnuite: o culoare hex într-o stare de hover, un margin: 37px izolat, un transition: .3s care ar trebui să fie --dur-fast. Înlocuiește-le cu cel mai apropiat token sau adaugă unul nou dacă niciunul nu se potrivește.
Practică · Proiectul cursului
Un site, construit pe tot parcursulDă site-ului pentru [subiect] un design system cu care să poată crește.
- Rulează „Extrage tokenurile” și stabilește setul împreună cu AI-ul.
- Mută fiecare valoare în
:rootși înlocuiește valorile brute, câte un grup o dată, verificând pagina după fiecare. - Rulează „Scrie DESIGN.md” și fă commit cu ambele fișiere.
- Schimbă o dată
--accent, ca să verifici că tot site-ul urmează.
Practică · Testează
Verifici rezultatul- În afara
:root, CSS-ul nu are culori hex și nici durate brute. - Dacă schimbi un token, se schimbă vizibil fiecare loc care îl folosește.
- Cu mișcarea redusă pornită, nimic nu mai face tranziții.
- Întrebat „Ce fișier stabilește regulile de design?”, AI-ul numește DESIGN.md.
Practică · Evaluare
Criterii de acceptare0 din 4 criterii îndeplinite