Najmi ma

Projekt - Ako som si vytvoril (a prerobil) svoj osobný web

jandurkaj.dev je viacjazyčná osobná webová stránka. Vytvoril som ju v roku 2023 pomocou Next.js 13 a vtedy úplne nového App Router-a a v roku 2026 som ju prerobil na Next.js 16 spolu s AI asistentom na programovanie.

Klient
Ján Durkaj
Rok
–
Služby
Next.js vývoj, i18n, SEO, modernizácia s pomocou AI
Hlavný obrázok projektu

Motivácia

Tento projekt som začal s cieľom naučiť sa a precvičiť nové koncepty v Next.js, ako je napríklad App Router a Server Components. Chcel som zlepšiť svoje zručnosti v Next.js/React.js, rozšíriť moje front-end zručnosti a aktualizovať moju staršiu osobnú stránku, ktorá bola vytvorená pomocou WordPress CMS. Taktiež som chcel predstaviť svoje najnovšie projekty.
Možno sa pýtaš: „Prečo použiť Next.js pre takú malú stránku?“ Gatsby.js je oveľa lepšia voľba. Poskytuje množstvo základných tém a doplnkov, ktoré urýchlia proces vytvárania.
Môj hlavný dôvod pre vytvorenie novej portfólio stránky, okrem prezentácie mojich najnovších projektov, bol učenie sa. Mal som predchádzajúce skúsenosti s Next.js a chcel som preskúmať server-side vykresľovanie, React.js Server Components a hlbšie sa ponoriť do všestrannejšieho framework-u pre veľké škálovateľné projekty, ktorý by som rád v budúcnosti znovu použil. Skrátka, iná možnosť jednoducho nebola.

Špecifikácia projektu

Chcel som vytvoriť osobnú webovú stránku, ktorá skutočne odráža to, kto som. Namiesto toho, aby som návštevníkov zahltil únavným opisom mojich technických zručností, mojím cieľom je poskytnúť im čo najlepšie odzrkadlenie môjho pravého ja.

Od samého začiatku som vedel, že k dosiahnutiu tohto cieľa budú kľúčové nasledujúce faktory:

  • Vytvorenie viacjazyčnej stránky.
  • S minimalistickým a elegantným UI/UX.
  • Zahrnúť prispôsobené prvky používateľského rozhrania.
  • Pridávanie skrytých vtipov, ako ihla v kope sena.
  • Optimalizácia webu pre SEO a výkon.

Pre vyhnutie problémom s konfiguráciou, počiatočným nastavením a vytváraním UX/UI od nuly som sa rozhodol použiť štartovacú šablónu. Na webe GitHub Next.js je dostupných viacero príkladov, ktoré môžete využiť na rýchle nastavenie aplikácie. Inštalácia je jednoduchá pomocou CLI nástroja create-next-app. Ďalšie informácie o fungovaní nájdete v dokumentácii Next.js.

Napriek mnohým úspešným rokom používania CSS s konvenciou pomenovania BEM (Block Element Modifier) a Sass, ako rozšírením jazyka CSS, som sa rozhodol použiť Tailwind CSS framework pre používateľské rozhranie na tomto projekte. Už som ho predtým používal a veľmi som ho obľúbil. S natívnou podporou pre Tailwind CSS v Next.js to bolo jednoduché a zrejmé rozhodnutie v tomto prípade.

Next.js ponúka ďalšiu natívnu podporu v podobe MDX. Keďže moja osobná stránka bude obsahovať len málo obsahu a ten bude väčšinou statický, videl som v MDX skvelú náhradu za plnohodnotný backend s databázou. Pôvodne som uvažoval o použití bezhlavého CMS KeystoneJS, ale MDX sa javí ako lepšia voľba.

Keďže bolo jasné, že môj nový osobný web bude vytvorený pomocou React.js, Next.js, MDX a Tailwind CSS, začal som hľadať dobrú štartovaciu šablónu. Našťastie som nemusel hľadať ďaleko, keďže tvorcovia Tailwind CSS majú ďalší projekt s názvom Tailwind UI. Koncom roku 2022 rozšírili tento projekt o šablóny, ktoré využívajú React.js, Next.js, Tailwind CSS a MDX. Jedinou nevýhodou bolo obmedzené množstvo dostupných šablón (ani jedna sa mi veľmi nepáčila) a v auguste 2023 boli tieto šablóny mierne zastarané, pretože používali starý Next.js Pages Router. Avšak dňa 7. augusta vydali nádhernú minimalistickú šablónu pre digitálne štúdiá. Táto šablóna používala nový App Router, avšak nezahŕňala TypeScript, ktorý je teraz predvolený pre nové inštalácie Next.js.

Dobre. Potreboval som len nastaviť TypeScript pre existujúci projekt, prepísať všetky existujúce komponenty a upraviť vzhľad používateľského rozhrania z digitálneho štúdia na osobnú webovú stránku. A vieš čo? Presne to som urobil a vytvoril som šablónu pre svoje portfólio.

Zoznam použitých technológií

Výzvy

TL;DR: Rozhodnutie použiť „najnovšie a najlepšie“ na trhu bolo veľkým zdrojom frustrácie počas celého projektu. Nižšie uvádzame niekoľko príkladov:

Internacionalizácia

Toto by nemal byť veľký problém. Pôvodne som si myslel, že je to len nový obsah pre každý ďalší jazyk. Nasledoval som dokumentáciu Next.js pre i18n, vytvoril vlastný middleware a narazil som na prekážku, keď som sa pokúsil použiť preklady v komponentoch na strane servera a klienta súčasne.
Framer Motion vyžaduje použitie na strane klienta a využíva sa po celej aplikácii na vylepšenie používateľského rozhrania (UX). Preto som potreboval flexibilné riešenie, ktoré by fungovalo pre komponenty na strane servera aj klienta.
Bol som nútený použiť externé riešenia, a jediné, ktoré najlepšie fungovalo s komponentmi Server/Client, bolo next-intl. Vyskúšal som rôzne možnosti a nakoniec som sa rozhodol pre neho, pretože najlepšie pokrýval moje požiadavky.

Server Components a App Router

Hoci Next.js 13 prináša dobre zdokumentovanú podporu pre Server Components a App Router je považovaný za predvolený, v čase, keď som začal s projektom, tieto funkcie neboli dostatočne dotiahnuté ani otestované v praxi.

Jeden z mnohých príkladov: generateStaticParams nefungovalo s experimentálnou funkciou Next.js Server Actions a v tom čase preň neexistovalo žiadne skutočné riešenie až do tejto opravy.

MDX a i18n

Kvôli novému Next.js App Router-u a štruktúre mojej šablóny som musel vyvinúť riešenie na načítanie správneho obsahu MDX podľa aktuálneho jazyka. Toto mi umožnilo preložiť obsah uložený v súboroch .mdx.

P.S.: Napriek všestrannosti next-intl nie je možné ho použiť priamo v súboroch .mdx. Je navrhnutý na použitie v kontexte React.js komponentov a ďalších špecifických oblastí Next.js. Viac informácií o oblastiach, v ktorých sa dá použiť, nájdete v oficiálnej next-intl dokumentácii.

Prerobená v roku 2026

Na jeseň 2026 stránka stále fungovala, ale jej kód zostarol ako mlieko. Next.js 14 s Reactom 18, internacionalizácia držaná pokope obchádzkami, Tailwind CSS 3, Jest, ktorý si už nerozumel s ničím moderným, a cookie lišta pre Google Analytics, ktorú nikto nechcel vidieť. Otázka nebola, či ju aktualizovať, ale ako to urobiť bez toho, aby som s tým strávil každý večer počas celého mesiaca.

Tak som skúsil niečo nové: celú modernizáciu som urobil spolu s Claude Code, AI asistentom na programovanie, ktorý pracuje priamo v mojom repozitári a termináli.

Ako sme pracovali

Hneď od prvej správy som stanovil jedno pravidlo: žiadne skákanie rovno do opráv. Každý krok musel prejsť rovnakým cyklom:

  • Analýza súčasného stavu so zisteniami podloženými dôkazmi.
  • Návrh jedného kroku s vysvetlenými výhodami a nevýhodami.
  • Moje zelené svetlo a až potom kód, v jednom commite.
  • Kontrola bežiacej stránky na Vercel preview predtým, než sme pokračovali.

Samotná aktualizácia prebehla v ôsmich krokoch: upratovanie, next-intl 4, nová architektúra prípadových štúdií, Next.js 16 s Reactom 19, Tailwind CSS 4, kontaktný formulár, Vitest a nakoniec audit celej stránky, po ktorom nasledovalo ešte niekoľko kôl obsahu a doladenia. Každý krok sme overili zostavením stránky a porovnaním každého odkazu, prekladu aj položky v sitemape pred a po zmene.

Výsledok je vidieť na mobile: domovská stránka má teraz v Lighthouse skóre 96 namiesto 77 a jej hlavný obsah sa zobrazí za 2,8 sekundy namiesto 6,3.

Skóre Lighthouse pre domovskú stránku na mobile: výkon 77 a largest contentful paint 6,3 s na Next.js 14, výkon 96 a 2,8 s na Next.js 16

Čo našla AI a mne to uniklo

Najcennejšie neboli samotné aktualizácie, ale chyby skryté na očiach:

  • Prípadové štúdie sa vykresľovali iba v prehliadači. Vyhľadávače a náhľady odkazov videli len hlavičku a nič viac. Teraz sa každá prípadová štúdia vopred vygeneruje na serveri z jedinej route.
  • Neexistujúce stránky odpovedali „200 OK“ namiesto „404 Not Found“, a to kvôli načítavacej obrazovke, ktorú na úplne statickej stránke nikto nepotreboval.
  • Štyri prípadové štúdie mali spoločný meta popis „Annie Sloan description“. Ups.
  • Hlavný obrázok prípadových štúdií sa vždy sťahoval vo verzii 1920 px, aj na mobile.
  • Kontaktný formulár veril všetkému, čo poslal prehliadač. Teraz všetko overuje na serveri, pri chybe zachová vašu správu a odfiltruje roboty bez captchy.
  • Tabuľa v pätičke s každým novým bodom znova prekreslila každú čiaru cez seba samú, takže čiary boli zubaté, a na mobile začínal nový ťah tam, kde skončil predchádzajúci.

Čo som musel podchytiť ja

Bola to spolupráca, nie autopilot. AI zmazala priečinok so zostavením, kým mi bežal vývojový server, a ten prestal fungovať. Počas testu v prehliadači mi zase poslala skutočný email z môjho vlastného kontaktného formulára. Táto druhá „chyba“ bola v skutočnosti darom: odhalila, že antispamový časovač zlyhával vždy, keď sa serverless funkcia prebúdzala zo studeného štartu. Opravili sme to v ten istý deň a opravu sme otestovali na čerstvo nasadenom, studenom serveri.

Aj jej vlastné opravy potrebovali kontrolu. Počas auditu prepla formátovanie dátumov na UTC, čím potichu posunula všetky pracovné pozície na mojej stránke „O mne“ o mesiac dozadu, a nikto si to nevšimol, kým sme tú stránku neskôr neaktualizovali.

Ponaučenie pre mňa: AI je neuveriteľne rýchly a dôkladný parťák pri programovaní, ale rozhodnutia, kontrola a vkus zostávajú na človeku. Pýtať si najprv návrh namiesto hotového riešenia urobilo celý rozdiel.

Koľko to trvalo

Celá modernizácia mi zabrala približne 4 hodiny. Môj odhad pre rovnaký objem práce bez AI je zhruba 5 pracovných dní: približne pol dňa na next-intl, pol dňa na architektúru prípadových štúdií, pol dňa na Tailwind CSS a pol dňa na kontaktný formulár, deň na Next.js 16 s Reactom 19, deň na audit a jeho opravy a zvyšok na upratovanie, testy, dokumentáciu a tento text.

S pomocou AI
4 h
Odhad bez AI
5 dní
Závislosti
59 → 39
Omylom poslaný email
1

Potom prišiel čas na hru

Po dokončení aktualizácie som z ihriska kreativity v pätičke spravil malý kresliaci nástroj. Bicykel teraz zostáva ako sivá predloha, ktorú môžete obkresliť, s voliteľným prichytávaním k nej, a pribudla guma, farby a stiahnutie do PNG. Zrolujte dole a vyskúšajte si to.

Hudba budúcnosti

Táto stránka má ďaleko od dokonalosti. Mohol by som stráviť nespočetné množstvo hodín pridávaním nových funkcií a vylepšovaním, ale nateraz mám krátky zoznam nápadov, ktoré by som mohol v blízkej budúcnosti implementovať:

  • Pridanie sekcie blog s možnosťou filtrovania podľa kategórií a triedenia podľa rôznych parametrov.
  • Pridanie prísnej Content Security Policy.
  • Implementácia toastových upozornení pre spätnú väzbu formulára na stránke kontaktu.
Vypitých štiav
123🥤
Skúsenosti
666+
Rýchlejšia
7×
Lacnejšia
∞×

Ďalšie projekty

V prenasledovaní moderného UX/UI

AppScenic je dropshipping-ová platforma, ktorá spája maloobchodníkov s poprednými dodávateľmi na celom svete.

Ponor sa hlbšie

WordPress ako utrhnutý z reťaze vďaka roots.io

Vixio, marketingová stránka pre GamblingCompliance a PaymentsCompliance platformy.

Ponor sa hlbšie

Povedz mi o svojom ďalšom projekte

Moje kancelárie

  • Arrieta
    Biskajsko
    Španielsko
  • Burgos
    Kastília a León
    Španielsko
  • Kdekoľvek
    Na svete
    Planeta Zem