Scrollcraft
Capitolul 14 din 15EN

Producție și lansare: publică și ține-l sănătos.

Publicarea durează câteva minute. Ce o face profesionistă e tot ce e în jur: un domeniu, metadate, verificări care rulează la fiecare schimbare și cineva care are grijă de site după lansare.

Capitolul 14 din 153 min de citit

Ce vei învăța

La finalul capitolului
  1. 01Publici un site static sau o aplicație Next.js, cu previzualizări pentru fiecare ramură.
  2. 02Legi un domeniu și adaugi metadatele pentru rezultatele căutării și pentru linkurile distribuite.
  3. 03Rulezi automat lint, build-ul și testele la fiecare push.
  4. 04Ai grijă de site după lansare: erori, actualizări și verificări repetate.

01 · Publică folderul

Orice găzduire statică

Rezultatul sunt trei fișiere statice, deci orice găzduire statică îl poate servi. Verifică pe pagina fiecărui serviciu limitele și prețurile actuale.

Netlify

Trage folderul pe pagina Netlify Drop sau publică din linia de comandă.

Vercel

Rulează comanda de mai jos în folder și urmează întrebările.

GitHub Pages

Urcă folderul într-un repository, apoi activează Pages din setările repository-ului.

Cloudflare Pages

Încarcă folderul din dashboard sau conectează un repository.

bash
npx vercel

02 · Publică o aplicație Next.js

Vercel
a

Leagă repository-ul

Importă repository-ul în Vercel. Fiecare push pe ramura principală ajunge în producție, iar fiecare altă ramură primește propria adresă de previzualizare, ca să verifici înainte de merge.

bash
npx vercel          # o previzualizare
npx vercel --prod   # producție
b

Variabile de mediu

Setează-le în setările proiectului, separat pentru previzualizare și producție. Doar variabilele care încep cu NEXT_PUBLIC_ ajung în browser; ține cheile și secretele fără acest prefix.

03 · Domeniu și metadate

Găsit și distribuit
a

Un domeniu

Adaugă domeniul în panoul găzduirii și creează înregistrările DNS pe care ți le arată. Certificatele HTTPS se emit automat.

b

Head-ul paginii

Un titlu și o descriere pentru rezultatele căutării, o adresă canonică și o imagine Open Graph pentru cardul afișat când linkul e distribuit.

index.html
<html lang="ro">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Aurora: sound that fills the room</title>
  <meta name="description" content="A small speaker that plays in every direction.">
  <link rel="canonical" href="https://example.com/">

  <!-- cardul afișat când linkul e distribuit -->
  <meta property="og:title" content="Aurora">
  <meta property="og:description" content="A small speaker that plays in every direction.">
  <meta property="og:image" content="https://example.com/og.jpg">
  <meta name="twitter:card" content="summary_large_image">
</head>
c

Sitemap și robots

Un sitemap.xml listează fiecare pagină; robots.txt trimite la el. Next.js le generează pe amândouă din app/sitemap.ts și app/robots.ts.

04 · Automatizează verificările

CI
a

La fiecare push

Un workflow rulează lint, build-ul și testele în browser din capitolul anterior. O schimbare care strică site-ul nu ajunge niciodată neobservată în producție.

ci.yml
# .github/workflows/ci.yml: fiecare push și pull request e verificat
name: CI
on: [push, pull_request]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22, cache: npm }
      - run: npm ci
      - run: npm run lint
      - run: npm run build
      - run: npx playwright install --with-deps chromium
      - run: npx playwright test

05 · După lansare

Ține-l sănătos
1

Urmărește erorile

În primele zile, uită-te în logurile găzduirii sau adaugă un instrument de urmărire a erorilor. Vizitatorii găsesc combinațiile pe care nu le-ai testat.

2

Măsoară discret

Folosește analytics care respectă intimitatea sau deloc. Un banner de cookie-uri pe un site cinematic strică prima impresie.

3

Actualizează după program

O dată pe lună: actualizezi dependențele, rulezi testele, compari capturile. Bibliotecile încărcate de pe un CDN rămân fixate pe o versiune exactă.

4

Treci din nou prin listă

Înaintea fiecărei schimbări mai mari, parcurge încă o dată lista pentru lansare din capitolul Testare.

06 · Mergi mai departe

Documentație oficială
Cod

Bibliotecile folosite aici

Lenis pentru scroll lin, GSAP ScrollTrigger pentru animații legate de scroll și fixate, și three.js pentru capul din particule. GSAP a devenit gratuit pentru uz comercial în 2025, conform anunțului Webflow.

Practică · Lucrul cu AI

Aceeași sarcină, în unealta ta

Lasă AI-ul să scrie configurația, dar publică și leagă domeniile tu: acei pași ating conturi și costă bani.

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.

Metadate

Prompt
Citește CLAUDE.md. Adaugă metadatele din head pentru site-ul pentru [subiect]: titlu, descriere, adresă canonică, titlu, descriere și imagine Open Graph și cardul Twitter. Folosește doar text din brief.md. Adaugă și un sitemap.xml și un robots.txt care trimite la el. Arată-mi schimbările.

Workflow de CI

Prompt
Scrie .github/workflows/ci.yml care rulează la fiecare push și pull request: instalează cu npm ci, lint, build, instalează Playwright cu Chromium și rulează testele. Fixează versiunile acțiunilor. Explică fiecare pas într-un rând.

Practică · Exerciții

Încearcă, apoi compară
1

Previzualizare înainte de producție

Fă push pe o ramură cu o schimbare vizibilă. Găsește-i adresa de previzualizare și verific-o înainte de merge.

Indiciu: găzduirea pune linkul de previzualizare ca comentariu pe pull request sau îl listează în panou.

Arată soluția

Fiecare ramură are propria adresă, așa că poți verifica o schimbare pe un telefon real înainte să ajungă la vizitatori. Faci merge doar după ce previzualizarea trece lista de verificare.

2

Verifică cardul distribuit

Lipește adresa site-ului într-o aplicație de mesagerie sau într-o postare nepublicată. Cardul arată titlul, textul și imaginea corecte?

Indiciu: cardul citește etichetele Open Graph.

Arată soluția

Dacă lipsește imaginea, adresa din og:image e probabil relativă sau imaginea e prea mică. Folosește o adresă absolută și o imagine de aproximativ 1200 pe 630 de pixeli.

3

Strică intenționat build-ul

Fă push pe o ramură cu o eroare de lint. Ce face CI-ul?

Indiciu: uită-te la verificările de pe pull request.

Arată soluția

Workflow-ul pică la pasul de lint, iar pull request-ul arată o verificare roșie, așa că schimbarea nu poate intra neobservată. Repar-o și fă push din nou.

Practică · Proiectul cursului

Un site, construit pe tot parcursul

Pune online site-ul pentru [subiect] și pregătește-l să rămână sănătos.

  1. Publică folderul pe o găzduire statică sau aplicația pe Vercel, dintr-un repository Git.
  2. Rulează „Metadate”, publică din nou și verifică cardul distribuit.
  3. Rulează „Workflow de CI”, fă push și confirmă că verificările trec.
  4. Leagă un domeniu dacă ai unul și scrie în notes.md un plan lunar de întreținere.

Practică · Testează

Verifici rezultatul
  • Adresa publică se încarcă prin HTTPS, fără erori în consolă.
  • Un link distribuit arată titlul, textul și imaginea corecte.
  • /sitemap.xml și /robots.txt se încarcă.
  • Un push pornește CI-ul, iar o schimbare greșită arată o verificare roșie.

Practică · Evaluare

Criterii de acceptare

0 din 4 criterii îndeplinite

Urmează Referință

Un tabel cu problemele frecvente, cauzele și reparațiile lor, și un glosar al termenilor folosiți în curs.

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