Brief
Spui ce vrei, pentru cine e și ce trebuie să facă vizitatorul. Numești limitele: culori, fonturi, fără framework-uri.
Nivelul 1 · Fundamente
01ÎnceputUnelte și instalare02SkilluriGăsești, instalezi, scrii03PrompturiBrief pentru AI04ConstrucțiePași și exemplu completNivelul 2 · Mișcare
05MișcareTehnici și rețete06LaboratorExperimente live07GSAPTimeline-uri și ScrollTrigger08WebGLThree.js și shadere09ExempleCinci proiecte de portofoliuNivelul 3 · Producție
10Design systemsTokenuri și reguli11ArhitecturăTehnologii, structură, curățenie12PerformanțăRapid pe un telefon real13Testare și QAVerifici înainte să publici14Producție și lansarePublici și întrețiiAnexă
15ReferințăReparații și termeniZece pași de la un folder gol la o pagină terminată. Fiecare are promptul de lipit și, unde contează, codul pe care ar trebui să-l primești înapoi.
Spui ce vrei, pentru cine e și ce trebuie să facă vizitatorul. Numești limitele: culori, fonturi, fără framework-uri.
Lași AI-ul să scrie câte o bucată pe rând. Bucățile mici sunt ușor de verificat și ușor de anulat.
Deschizi pagina. O derulezi, o micșorezi, treci prin ea cu Tab. Îi ceri AI-ului să spună ce n-a testat și te uiți tu la partea aceea.
Descrii problema pe care ai văzut-o, nu reparația pe care ți-o imaginezi. Apoi inspectezi din nou.
Un brief bun numește subiectul, publicul și singurul lucru pe care vizitatorul trebuie să-l facă la final. Cere întâi lista de secțiuni și aprob-o înainte să existe cod. O listă se schimbă în câteva secunde. Codul terminat costă mult mai mult.
Vreau un site minimalist cu scroll cinematic despre [subiect] pentru [public]. Vizitatorul ar trebui să termine prin [o acțiune]. Propune secțiunile, câte un rând fiecare, și așteaptă aprobarea mea înainte să scrii cod.Ar trebui să vezi: o listă scurtă, încă fără cod.
Cere trei fișiere și numește limitele. Limitele sunt cele care împiedică rezultatul să arate ca orice alt șablon.
Creează index.html, style.css și app.js cu HTML, CSS și JavaScript simple, fără framework. Fundal negru, o culoare de accent, o pereche de fonturi Google. Definește toate culorile ca proprietăți CSS personalizate. Include un hero, trei secțiuni de conținut, un îndemn la acțiune și un footer scurt.Reîncarcă pagina din serverul local. Ar trebui să vezi o pagină completă, dar fără animații.
Lenis dă paginii inerție, așa că rotița alunecă în loc să sară în trepte. Are nevoie de doctype: fără <!doctype html> browserul intră în quirks mode și Lenis nu face nimic, fără vreo eroare. Exact asta s-a întâmplat la testarea acestui site.
Adaugă scroll lin cu Lenis de pe CDN-ul jsDelivr, fixat pe lenis@1.1.18 și condus de requestAnimationFrame. Nu îl porni când este setat prefers-reduced-motion.<script src="https://cdn.jsdelivr.net/npm/lenis@1.1.18/dist/lenis.min.js"></script>const reduced = matchMedia('(prefers-reduced-motion: reduce)').matches;
if (!reduced && typeof Lenis !== 'undefined') {
const lenis = new Lenis({ duration: 1.2, smoothWheel: true });
const raf = (t) => { lenis.raf(t); requestAnimationFrame(raf); };
requestAnimationFrame(raf);
}html.lenis, html.lenis body { height: auto; }
.lenis.lenis-smooth { scroll-behavior: auto !important; }Secțiunile ar trebui să apară când ajungi la ele, nu toate la încărcarea paginii. Ascunde elementele doar când există JavaScript, ca nimic să nu rămână invizibil dacă scriptul eșuează.
Fă fiecare element .reveal să apară o singură dată când intră în ecran: opacitate și o ridicare de 24 px, decalate cu 80 ms între elementele vecine. Adaugă starea ascunsă doar sub o clasă .js pe elementul html.document.documentElement.classList.add('js');
const io = new IntersectionObserver((entries) => {
entries.forEach((e) => {
if (e.isIntersecting) { e.target.classList.add('in'); io.unobserve(e.target); }
});
}, { threshold: 0.12 });
document.querySelectorAll('.reveal').forEach((el) => io.observe(el));.js .reveal { opacity: 0; transform: translateY(24px);
transition: opacity .9s, transform .9s cubic-bezier(.2,.7,.2,1); }
.js .reveal.in { opacity: 1; transform: none; }Parallax înseamnă că straturile de fundal se mișcă mai încet decât prim-planul. Vitezele între 0.15 și 0.5 se citesc ca adâncime. Peste aproximativ 0.6 arată ca o eroare.
Dă hero-ului trei straturi de fundal cu data-speed 0.2, 0.35 și 0.5, mutate cu translate3d la scroll. Oprește actualizarea după 1,3 înălțimi de ecran. Sub 768 px redu deplasările în loc să le elimini.const layers = [...document.querySelectorAll('[data-speed]')];
addEventListener('scroll', () => {
const y = scrollY;
if (y > innerHeight * 1.3) return;
layers.forEach((l) => {
l.style.transform = `translate3d(0, ${y * (1 - l.dataset.speed)}px, 0)`;
});
}, { passive: true });Fixează cel mult o dată pe pagină. Alegerea clasică e o galerie cu scroll orizontal: scrollul vertical mută un rând de carduri în lateral, cât timp secțiunea stă pe loc. Înălțimea containerului e surplusul pistei plus un ecran.
Transformă cele șase carduri cu funcții într-o singură secțiune fixată cu scroll orizontal. Setează înălțimea containerului din lățimea pistei, după încărcarea fonturilor și la redimensionare, ca distanța de scroll să fie egală cu surplusul.const hs = document.querySelector('.hs'), pin = hs.querySelector('.hs-pin'), track = hs.querySelector('.hs-track');
let max = 0;
const measure = () => {
max = Math.max(0, track.scrollWidth - pin.clientWidth);
hs.style.height = (max + pin.offsetHeight) + 'px';
};
addEventListener('resize', measure); measure();
addEventListener('scroll', () => {
const p = Math.min(1, Math.max(0, (64 - hs.getBoundingClientRect().top) / max));
track.style.transform = `translate3d(${-p * max}px, 0, 0)`;
}, { passive: true });.hs-pin { position: sticky; top: 64px; height: calc(100vh - 64px); overflow: hidden; }
.hs-track { display: flex; width: max-content; }Imaginea stă fixă în timp ce pașii de text trec pe lângă ea, și se schimbă după pasul activ. Scrollytellingul acestui site e bucla în patru etape de la începutul capitolului.
Construiește o secțiune de scrollytelling: o imagine fixă în stânga care se schimbă după pasul activ și patru pași de text în dreapta. Pe ecrane sub 900 px, pune-le una sub alta, cu imaginea fixă sus..scrolly { display: grid; grid-template-columns: 1.1fr .9fr; gap: 56px; align-items: start; }
.scrolly-vis { position: sticky; top: 120px; height: 60vh; }
.step { min-height: 72vh; opacity: .3; transition: opacity .5s; }
.step.on { opacity: 1; }const steps = [...document.querySelectorAll('.step')];
addEventListener('scroll', () => {
let best = 0, bd = Infinity;
steps.forEach((s, i) => {
const r = s.getBoundingClientRect();
const d = Math.abs(r.top + r.height / 2 - innerHeight / 2);
if (d < bd) { bd = d; best = i; }
});
steps.forEach((s, i) => s.classList.toggle('on', i === best));
showVisual(best);
}, { passive: true });Opțional și mai greu decât tot ce e mai sus. Costă dimensiune de descărcare și baterie pe telefoane. Întreabă care e costul înainte să accepți. Limitează pixel ratio, oprește randarea când nu e pe ecran și redu numărul de particule pe ecrane mici.
Adaugă un hero cu particule Three.js din buildul cdnjs fixat pe o versiune exactă. Ia punctele dintr-o imagine desenată pe un canvas. Limitează pixel ratio la 2, înjumătățește numărul sub 768 px și oprește randarea când hero-ul nu e pe ecran. Spune-mi ce n-ai putut testa.Verifică trei lățimi: 375, 768 și 1440 px. Apoi activează reduced motion. Trebuie să oprească scrollul lin, parallaxul și mișcarea aparițiilor, nu doar una dintre ele.
Verifică pagina la 375, 768 și 1440 px și listează orice se suprapune, e tăiat sau nu se poate citi. Fă ca prefers-reduced-motion să oprească scrollul lin, parallaxul și mișcarea aparițiilor. Adaugă un link de salt la conținut, stiluri de focus vizibile și aria-current pe elementul de meniu activ.Cere o evaluare dură, repară cele mai grave trei probleme, apoi evaluează din nou. Două runde bat un prompt lung.
Fii un director artistic exigent. Notează pagina de la 1 la 10 pentru ierarhie, ritm și lizibilitate pe mobil. Listează cele mai grave trei probleme și unde sunt, repară-le și notează din nou. Spune ce verificări n-ai putut rula.Prompturile folosesc proiectul completat la pasul 01. Înlocuiește orice altceva dintre parantezele drepte. Restul se încarcă pe măsură ce derulezi.
Acesta e un site terminat și funcțional pe care îl poți rula acum. A fost deschis într-o fereastră Chromium fără interfață și derulat de sus până jos: clasa de scroll lin s-a aplicat, straturile de parallax s-au mișcat, toate cele douăzeci de cuvinte s-au aprins, toate cele șase apariții au pornit, galeria s-a deplasat pe toată lățimea ei, iar consola a rămas goală. Salvează cele trei fișiere într-un folder și servește-l cu python3 -m http.server 8000.
Șase secțiuni în fluxul normal. Doar secțiunea cu cuvinte și galeria sunt fixate.
<!doctype html>
<html lang="en-GB">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Northlight</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<div class="progress" id="progress"></div>
<header class="bar">
<a class="logo" href="#top">Northlight</a>
<nav><a href="#features">Features</a><a href="#gallery">Gallery</a><a href="#contact">Contact</a></nav>
</header>
<main id="top">
<section class="hero">
<div class="layer far" data-speed="0.2"></div>
<div class="layer mid" data-speed="0.4"></div>
<div class="hero-copy">
<p class="eyebrow">A sample site</p>
<h1>Light that follows the long winter.</h1>
<p class="lede">A small demonstration of smooth scroll, parallax, word-by-word text and a pinned horizontal gallery.</p>
<a class="btn" href="#features">Scroll on</a>
</div>
</section>
<section class="words">
<div class="words-pin">
<p id="statement">Every section on this page moves with your scroll position, so the pace of the story is yours to set.</p>
</div>
</section>
<section class="features" id="features">
<h2 class="reveal">Three things this page does</h2>
<div class="cards">
<article class="card reveal" style="--d:0"><h3>Smooth scroll</h3><p>Lenis adds inertia and keeps native scrolling, focus and anchors working.</p></article>
<article class="card reveal" style="--d:1"><h3>Depth</h3><p>Background layers move more slowly than the page, which separates them from the text.</p></article>
<article class="card reveal" style="--d:2"><h3>Pacing</h3><p>Content arrives as it enters the viewport and stays visible when you scroll back.</p></article>
</div>
</section>
<section class="hs" id="gallery">
<div class="hs-pin">
<h2>Gallery</h2>
<div class="hs-track">
<figure><span>01</span><figcaption>Dawn</figcaption></figure>
<figure><span>02</span><figcaption>Ridge</figcaption></figure>
<figure><span>03</span><figcaption>Harbour</figcaption></figure>
<figure><span>04</span><figcaption>Aurora</figcaption></figure>
<figure><span>05</span><figcaption>Dusk</figcaption></figure>
</div>
</div>
</section>
<section class="cta" id="contact">
<h2 class="reveal">Start with an empty folder.</h2>
<a class="btn reveal" href="#top">Back to the top</a>
</section>
</main>
<footer><span>Northlight</span><span>A tutorial example, not a real business.</span></footer>
<script src="https://cdn.jsdelivr.net/npm/lenis@1.1.18/dist/lenis.min.js"></script>
<script src="app.js"></script>
</body>
</html>Tokenurile de culoare sunt sus. Secțiunile fixate folosesc position: sticky într-un părinte mai înalt, așa că browserul face fixarea.
:root {
--bg: #0b0d10; --fg: #eef2f5; --muted: #98a3ad; --line: #232a31; --accent: #7cc4ff;
--pad: clamp(20px, 5vw, 64px);
--bar: 64px;
}
* { box-sizing: border-box; }
html { background: var(--bg); }
body { margin: 0; background: var(--bg); color: var(--fg); font: 400 17px/1.6 system-ui, sans-serif; overflow-x: clip; }
html.lenis, html.lenis body { height: auto; }
.lenis.lenis-smooth { scroll-behavior: auto !important; }
a { color: inherit; }
h1, h2, h3 { font-weight: 500; line-height: 1.08; margin: 0; text-wrap: balance; }
h1 { font-size: clamp(40px, 8vw, 112px); letter-spacing: -0.03em; }
h2 { font-size: clamp(30px, 5vw, 64px); letter-spacing: -0.02em; }
.progress { position: fixed; inset: 0 0 auto 0; height: 2px; background: var(--accent); transform-origin: 0 50%; transform: scaleX(0); z-index: 30; }
.bar { position: fixed; inset: 0 0 auto 0; height: var(--bar); display: flex; justify-content: space-between; align-items: center; padding: 0 var(--pad); z-index: 20; mix-blend-mode: difference; }
.bar nav { display: flex; gap: 24px; }
.bar a { text-decoration: none; font-size: 14px; }
.logo { font-weight: 500; letter-spacing: .02em; }
.btn { display: inline-block; margin-top: 28px; padding: 14px 22px; border: 1px solid var(--line); text-decoration: none; transition: border-color .2s; }
.btn:hover, .btn:focus-visible { border-color: var(--accent); }
.hero { position: relative; min-height: 100svh; display: grid; align-items: end; padding: var(--pad); overflow: hidden; }
.layer { position: absolute; inset: -20% 0; background-repeat: repeat; will-change: transform; }
.layer.far { background-image: radial-gradient(circle, rgba(124,196,255,.35) 1px, transparent 1.5px); background-size: 90px 90px; }
.layer.mid { background-image: radial-gradient(circle, rgba(238,242,245,.5) 1.5px, transparent 2px); background-size: 170px 170px; }
.hero-copy { position: relative; max-width: 960px; padding-bottom: 8vh; }
.eyebrow { color: var(--accent); font: 500 12px/1 ui-monospace, monospace; letter-spacing: .14em; text-transform: uppercase; }
.lede { color: var(--muted); max-width: 52ch; }
.words { height: 220vh; position: relative; }
.words-pin { position: sticky; top: 0; height: 100svh; display: grid; place-items: center; padding: var(--pad); }
#statement { font-size: clamp(26px, 4.4vw, 60px); line-height: 1.2; max-width: 22em; margin: 0; }
#statement .w { opacity: .38; transition: opacity .15s linear; }
.features { padding: 20vh var(--pad); }
.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 16px; margin-top: 48px; }
.card { border: 1px solid var(--line); padding: 28px; }
.card p { color: var(--muted); margin: 12px 0 0; }
.js .reveal { opacity: 0; transform: translateY(24px); transition: opacity .9s cubic-bezier(.2,.7,.2,1), transform .9s cubic-bezier(.2,.7,.2,1); transition-delay: calc(var(--d, 0) * 100ms); }
.js .reveal.in { opacity: 1; transform: none; }
.hs { position: relative; }
.hs-pin { position: sticky; top: 0; height: 100svh; display: flex; flex-direction: column; justify-content: center; gap: 32px; overflow: hidden; padding-left: var(--pad); }
.hs-track { display: flex; gap: 16px; width: max-content; will-change: transform; }
.hs figure { margin: 0; width: min(70vw, 520px); aspect-ratio: 4 / 5; border: 1px solid var(--line); display: flex; flex-direction: column; justify-content: space-between; padding: 20px; background: linear-gradient(160deg, #141a20, #0b0d10); }
.hs figure span { font: 500 12px/1 ui-monospace, monospace; color: var(--accent); }
.hs figcaption { font-size: 28px; }
.cta { min-height: 80svh; display: grid; place-content: center; justify-items: start; padding: var(--pad); }
footer { display: flex; justify-content: space-between; gap: 16px; flex-wrap: wrap; padding: 32px var(--pad); border-top: 1px solid var(--line); color: var(--muted); font-size: 14px; }
@media (prefers-reduced-motion: reduce) {
.js .reveal { opacity: 1; transform: none; transition: none; }
#statement .w { opacity: 1; }
.layer { transform: none !important; }
}Scroll lin, apariții, cuvinte conduse de scroll, parallax și galeria, în aproximativ șaptezeci de rânduri. Un singur handler de scroll face calculele.
(function () {
var reduced = matchMedia('(prefers-reduced-motion: reduce)').matches;
var clamp = function (v, a, b) { return Math.min(b, Math.max(a, v)); };
document.documentElement.classList.add('js');
/* 1. Smooth scroll */
var lenis = null;
if (!reduced && window.Lenis) {
lenis = new Lenis({ lerp: 0.1 });
(function raf(t) { lenis.raf(t); requestAnimationFrame(raf); })(performance.now());
}
document.addEventListener('click', function (e) {
var a = e.target.closest('a[href^="#"]');
if (!a) return;
var target = document.querySelector(a.getAttribute('href'));
if (!target) return;
e.preventDefault();
if (lenis) lenis.scrollTo(target, { offset: -64 }); else target.scrollIntoView();
});
/* 2. Reveal on scroll */
var io = new IntersectionObserver(function (list) {
list.forEach(function (en) { if (en.isIntersecting) { en.target.classList.add('in'); io.unobserve(en.target); } });
}, { threshold: 0.15 });
document.querySelectorAll('.reveal').forEach(function (el) { io.observe(el); });
/* 3. Scroll-driven words */
var statement = document.getElementById('statement');
var words = statement.textContent.trim().split(/\s+/);
statement.innerHTML = words.map(function (w) { return '<span class="w">' + w + '</span>'; }).join(' ');
var wEls = statement.querySelectorAll('.w');
var wrap = document.querySelector('.words');
/* 4. Parallax and horizontal pin */
var layers = document.querySelectorAll('.layer');
var hs = document.querySelector('.hs'), track = document.querySelector('.hs-track'), pin = document.querySelector('.hs-pin');
var maxX = 0;
function measure() {
maxX = Math.max(0, track.scrollWidth - (pin.clientWidth - parseFloat(getComputedStyle(pin).paddingLeft)));
hs.style.height = (maxX + pin.clientHeight) + 'px';
}
var bar = document.getElementById('progress');
function frame() {
var y = window.scrollY, vh = window.innerHeight;
bar.style.transform = 'scaleX(' + clamp(y / (document.documentElement.scrollHeight - vh), 0, 1) + ')';
if (reduced) return;
if (y < vh * 1.3) layers.forEach(function (l) { l.style.transform = 'translate3d(0,' + (y * (1 - parseFloat(l.dataset.speed))) + 'px,0)'; });
var r = wrap.getBoundingClientRect();
var p = clamp(-r.top / (r.height - vh), 0, 1);
wEls.forEach(function (w, i) {
w.style.opacity = (0.38 + 0.62 * clamp((p - 0.1 - (i / wEls.length) * 0.7) / 0.06, 0, 1)).toFixed(3);
});
var h = hs.getBoundingClientRect();
var hp = clamp(-h.top / (hs.offsetHeight - vh), 0, 1);
track.style.transform = 'translate3d(' + (-hp * maxX) + 'px,0,0)';
}
addEventListener('scroll', frame, { passive: true });
addEventListener('resize', function () { measure(); frame(); });
if (document.fonts && document.fonts.ready) document.fonts.ready.then(function () { measure(); frame(); });
measure(); frame();
})();Un prompt pentru fiecare pas ține fiecare schimbare destul de mică încât s-o poți verifica. Promptul de la final se uită la pagină ca întreg.
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.
Citește CLAUDE.md, brief.md și plan.md. Fă doar pasul [număr]: [pasul]. Schimbă cât mai puține rânduri, apoi spune-mi exact cum îl verific în browser și ce n-ai verificat.Comportă-te ca un art director. Uită-te la pagină la 375 și la 1440 de pixeli lățime și listează cele cinci schimbări care ar face-o mai calmă și mai gândită, în ordinea impactului. Nu schimba încă nimic.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.
Citește GEMINI.md, brief.md și plan.md. Fă doar pasul [număr]: [pasul]. Schimbă cât mai puține rânduri, apoi spune-mi exact cum îl verific în browser și ce n-ai verificat.Comportă-te ca un art director. Uită-te la pagină la 375 și la 1440 de pixeli lățime și listează cele cinci schimbări care ar face-o mai calmă și mai gândită, în ordinea impactului. Nu schimba încă nimic.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.
Citește AGENTS.md, brief.md și plan.md. Fă doar pasul [număr]: [pasul]. Schimbă cât mai puține rânduri, apoi spune-mi exact cum îl verific în browser și ce n-ai verificat.Comportă-te ca un art director. Uită-te la pagină la 375 și la 1440 de pixeli lățime și listează cele cinci schimbări care ar face-o mai calmă și mai gândită, în ordinea impactului. Nu schimba încă nimic.Împarte „Adaugă o secțiune de produs fixată, cu trei funcții” în schimbări destul de mici ca să le verifici pe rând.
Indiciu: markup, layout, comportament, apoi variantele statică și de telefon.
1. Markup-ul secțiunii și al celor trei funcții. 2. Layout-ul sticky. 3. Scriptul care alege funcția activă. 4. Varianta pentru mișcare redusă, în care funcțiile stau una sub alta. 5. Layout-ul de telefon. Verifici și faci commit după fiecare.
În Chrome DevTools, înregistrează un profil Performance în timp ce derulezi hero-ul. Găsește ce rulează la fiecare cadru.
Indiciu: blocurile lungi galbene sunt JavaScript, cele mov sunt layout.
Un parallax care schimbă top sau margin forțează layout la fiecare cadru. Mută-l cu transform: translate3d(), citește poziția scrollului o singură dată pe cadru și oprește calculul când hero-ul a ieșit din ecran.
Pornește mișcarea redusă din setările sistemului și derulează toată pagina.
Indiciu: macOS: Accesibilitate, Afișaj. Windows: Accesibilitate, Efecte vizuale, Efecte de animație oprite.
Scrollul lin se oprește, straturile parallax stau pe loc, aparițiile se arată fără să se miște, iar secțiunea fixată se citește ca o listă obișnuită. Tot ce încă se mișcă are nevoie de propria regulă prefers-reduced-motion.
Acum proiectul cursului primește pagina. Parcurge cei zece pași din acest capitol pentru [subiect], câte un prompt pentru fiecare.
git add -A
git commit -m "Pasul 4: apariție la scroll"reveal e vizibil după ce ai trecut de el.// lipește în Consolă după ce ai derulat până jos:
// listează fiecare apariție care nu s-a arătat (o listă goală înseamnă că trece)
[...document.querySelectorAll('.reveal:not(.in)')].map((el) => el.textContent.trim().slice(0, 40));0 din 4 criterii îndeplinite