La Mulți Ani
Experiență web în limba română pentru generarea și distribuirea unei urări personalizate, cu 5 teme cromatice, animații cu confetti, mesaj aleator stabil, control audio, link shareable și export al felicitării ca imagine.

Stack principal
Provocarea
Transformarea unui demo open-source de felicitări într-o experiență românească coerentă și ușor de distribuit, păstrând interacțiunea simplă pe mobil și desktop și rezolvând inconsecvențele dintre randarea live, audio și exportul ca imagine.
Soluția
Baza Next.js/React a fost adaptată cu localizare completă, mesaje românești, rute personalizate, cinci teme CSS, control audio manual, PWA manifest + iconuri și capturi, plus un flux de export stabilizat: mesajul aleator este fixat în state pentru sesiunea curentă, iar generarea PNG este declanșată controlat prin state/effect și html-to-image.
Complexitate notabilă
La Mulți Ani este o mini-experiență web construită în Next.js 11 și React 17 pentru a crea rapid o felicitare personalizată de ziua de naștere. Utilizatorul alege una dintre cinci teme cromatice, introduce numele sărbătoritului și este direcționat către o rută shareable care codifică numele și tema aleasă. Ecranul rezultat combină titlu animat literă cu literă, confetti pe canvas, o urare aleasă aleator și controale pentru muzică, revenire și, în fluxul creatorului, copierea linkului și descărcarea felicitării ca PNG.
Repository-ul nu reprezintă o implementare integrală de la zero. Fișierul CONTRIBUTING și licența indică explicit proiectul open-source gouravkhunger/nextjs-birthday-wish ca bază. Compararea codului curent cu upstream-ul arată că structura principală Next.js, hook-ul de teme, componentele Button/CopyLinkButton, animația de titlu, confetti-ul și mecanismul de export prin html-to-image + file-saver provin din acea bază. Personalizarea verificabilă constă în localizarea completă în română, înlocuirea și rescrierea mesajelor, adaptarea titlului "La Mulți Ani", eliminarea brandingului upstream din interfață, integrarea PWA, asset-uri și capturi proprii, schimbarea fluxului audio și câteva corecții de comportament în pagina felicitării.
Fluxul principal este complet client-side. Pagina "/" menține local numele și tema selectată; validarea blochează valoarea goală sau un nume care începe cu spațiu, apoi Next Router navighează la "/{nume}" pentru tema albastră implicită sau "/{nume}/{themeId}" pentru celelalte teme. Ruta catch-all "[...name].js" extrage numele și ID-ul culorii din URL, aplică tema prin custom hook și setează culoarea într-o variabilă CSS globală. Nu există API, controller, serviciu backend, bază de date, conturi sau date persistate pe server.
Mesajul de felicitare este ales aleator o singură dată la montarea componentei și păstrat în state. Aceasta este o diferență relevantă față de upstream, unde mesajul era recalculat la render și putea deveni inconsistent între ecran și imaginea exportată. În versiunea analizată, același mesaj este folosit atât în experiența vizibilă, cât și în template-ul temporar randat pentru export. Funcția de descărcare a fost de asemenea mutată într-un React.useCallback și declanșată prin efect atunci când se activează starea downloading, eliminând apelul cu side effects direct din render prezent în upstream.
Titlul este construit caracter cu caracter pentru a aplica o animație ondulată CSS. Prefixul românesc "La Mulți Ani, " și numele sunt separate dinamic pe baza lungimii prefixului, nu prin pragul hardcodat folosit de versiunea upstream în engleză. Numele primit din URL este randat ca text React, fără dangerouslySetInnerHTML, astfel încât React face escaping pentru conținutul introdus. Tema este aleasă doar din lista fixă de cinci variante: albastru, verde, violet, galben și roșu.
Audio-ul a fost modificat din autoplay-ul upstream într-un control explicit "Pornește muzica" / "Oprește muzica", conectat la un element audio prin useRef. Oprirea face pause și resetează currentTime la zero. Asset-ul audio este livrat local din public/media. Pagina de creare scrie și un flag "playMusic" în localStorage înainte de navigare, însă snapshot-ul curent nu îl citește nicăieri, deci flag-ul este cod rezidual și nu influențează comportamentul real.
Sharing-ul folosește Clipboard API pentru copierea URL-ului curent și oferă feedback temporar "Link copiat!". Butoanele de copiere și export sunt afișate doar când istoricul intern arată că utilizatorul a ajuns la felicitare din homepage; o deschidere directă a linkului primește experiența de destinatar, cu buton de creare a unei urări noi și control audio. Această separare este o regulă de UX bazată pe stare locală, nu un mecanism de autorizare și se pierde la refresh.
Exportul vizual folosește html-to-image pentru a transforma un container dedicat într-un PNG și file-saver pentru salvarea fișierului "birthday-wish.png". În modul de export, animația este eliminată din titlu și fundalul folosește asset-ul static de confetti, astfel încât rezultatul capturat să fie o felicitare curată, nu canvas-ul animat din experiența interactivă.
Aplicația este configurată ca PWA prin next-pwa, manifest web și set complet de iconuri între 48×48 și 512×512. Manifestul include capturi wide și mobile ale UI-ului român și rulează în display standalone. Configurația next-pwa folosește register și skipWaiting. Repository-ul conține și service worker / Workbox generate; snapshot-ul comis demonstrează în special configurarea PWA, nu o strategie offline matură, deoarece service worker-ul salvat folosește NetworkFirst doar pentru start URL și NetworkOnly pentru celelalte rute în acel artifact.
Frontend-ul este responsive și minimalist: fundal alb, tipografie system/Roboto, formă tip pill pentru input și butoane și accent controlat prin CSS custom property. Pe desktop interfața este foarte aerisită și centrată; pe mobil titlul se sparge pe două rânduri, selectorul de temă rămâne vizibil ca cinci puncte colorate, iar formularul se reorganizează vertical. Capturile versionate confirmă această adaptare responsive.
Din punct de vedere al securității, repository-ul nu conține secrete sau fișiere .env versionate; .gitignore exclude fișierele de mediu locale și certificatele PEM. Nu există autentificare, acces la date sensibile sau endpoint-uri de server care să introducă riscuri de IDOR, SQL injection, mass assignment ori webhook forgery. Suprafața de risc rămâne cea a unei aplicații browser-only: Clipboard API poate eșua în contexte nesigure sau fără permisiune, URL-urile pot deveni foarte lungi deoarece numele nu are limită explicită, iar erorile de clipboard / export / audio nu au UI de fallback.
Repository-ul nu conține teste automatizate, GitHub Actions, Docker, configurație de deployment, analytics sau error monitoring. Scripturile disponibile sunt dev, build, export, start și lint. Next.js este pornit cu openssl-legacy-provider pentru compatibilitate cu toolchain-ul vechi, iar start rulează pe portul 3001. Istoricul Git disponibil conține un singur commit de backup, astfel încât evoluția modificărilor nu poate fi demonstrată feature-by-feature; contribuțiile de mai sus sunt atribuite prin comparația directă dintre snapshot și upstream, nu prin numărul de commituri.
Rezultate cheie
- Flux complet client-side pentru creare urare: alegere temă → introducere nume → rută personalizată
- Cinci teme cromatice persistate în URL prin ID-ul temei
- Experiență de felicitare cu confetti canvas și titlu animat caracter cu caracter
- Set de urări localizate în limba română, cu un mesaj aleator stabil pe durata vizitei
- Control audio manual cu pornire, oprire și resetare la începutul piesei
- Copierea linkului curent în clipboard cu feedback vizual temporar
- Exportul felicitării ca imagine PNG prin html-to-image și file-saver
- Separare UX între creator și destinatar pe baza istoricului local de navigare
- Configurare PWA cu manifest, iconuri multiple, display standalone și service worker generat prin next-pwa
- Capturi versionate pentru layout desktop și mobil
- Localizare și personalizare verificabilă peste proiectul open-source upstream, fără revendicarea bazei ca implementare proprie
Proiecte asemănătoare
- CreativeSys AutoMagazin online personalizat cu produse simple și variabile, catalog și filtre dinamice, checkout, plăți EuPlătesc, documente comerciale, administrare completă și un flux separat de ofertare pentru vopsea auto.
- Ghici CineJoc de petrecere multiplayer în browser, cu camere private, cuvinte propuse de participanți, ture sincronizate în timp real, stare filtrată pentru fiecare jucător și reconectare la sesiunea activă.
- Vedete & InițialeAplicație web multiplayer pentru runde TOMAPAN în camere private, cu cod de acces, categorii configurabile, literă comună, timer, scor pentru răspunsuri unice sau duplicate și sincronizare real-time între jucători.
Vrei ceva similar?
Începe cu wizard-ul de estimare — răspunzi la câteva întrebări și primești un range de preț + timeline realist.