Scrollcraft
Capitolul 10 din 15EN

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.

Capitolul 10 din 153 min de citit

Ce vei învăța

La finalul capitolului
  1. 01Transformi culoarea, tipografia, spațiul și mișcarea într-o listă scurtă de tokenuri cu nume.
  2. 02Construiești componente care citesc tokenuri și nu țin niciodată valori brute.
  3. 03Faci o temă sau o variantă cu mișcare redusă schimbând tokenuri, nu reguli.
  4. 04Scrii un DESIGN.md care ține AI-ul consecvent de la prima secțiune la ultima.

01 · Tokenuri

Patru tipuri
a

Culoare

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.

b

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.

c

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.

d

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.

style.css
: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ă
1

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.

HTML
<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 brute
a

O 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.

style.css
.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); }
b

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.

c

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.md
a

Scrie 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
# 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.
b

Trimite AI-ul la el

Prompt
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.
c

Verifică abaterile

Prompt
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 ferme
1

Un singur accent

Marchează ce se poate apăsa, ce are focus și cât ai citit. Folosit în altă parte, nu mai înseamnă nimic.

2

Cel mult două familii

Una pentru text și, opțional, una monospace pentru etichete. Grosimea și mărimea duc ierarhia.

3

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.

4

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 ta

AI-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

Prompt
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

Prompt
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.

Practică · Exerciții

Încearcă, apoi compară
1

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.

2

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ă.

CSS
@media (prefers-reduced-motion: reduce) {
  :root { --dur-fast: 0s; --dur-base: 0s; --dur-slow: 0s; }
}
3

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 parcursul

Dă site-ului pentru [subiect] un design system cu care să poată crește.

  1. Rulează „Extrage tokenurile” și stabilește setul împreună cu AI-ul.
  2. Mută fiecare valoare în :root și înlocuiește valorile brute, câte un grup o dată, verificând pagina după fiecare.
  3. Rulează „Scrie DESIGN.md” și fă commit cu ambele fișiere.
  4. 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 acceptare

0 din 4 criterii îndeplinite

Urmează Arhitectură

Cum alegi tehnologiile, o structură de foldere care crește, o singură buclă de animație pentru tot site-ul și efecte care se curăță singure.

Scurtături de tastatură: [ capitolul anterior · ] capitolul următor