Modernizacja i Migracja Strony do Gatsby 5
Okres Realizacji: Marzec 2025 – Czerwiec 2025
Podsumowanie i Cele Projektu:
Celem projektu była kompleksowa aktualizacja i modernizacja strony internetowej opartej na Gatsby.js. Główne zadanie polegało na migracji z technicznie przestarzałej wersji Gatsby 2 do najnowszej możliwej, stabilnej wersji Gatsby 5. Projekt obejmował również aktualizację całego środowiska deweloperskiego (Node.js), refaktoryzację kluczowych komponentów oraz eliminację błędów i optymalizację kodu.
Wyzwanie Początkowe:
Punktem wyjścia była strona działająca na silniku Gatsby 2.13.3 i środowisku Node.js 14. Ta konfiguracja była niekompatybilna z nowszymi wersjami Node.js (16 i 18), co blokowało możliwość aktualizacji, wprowadzenia poprawek bezpieczeństwa i korzystania z nowoczesnych funkcji frameworka.
Etapy Realizacji Projektu:
1. Etap I – Migracja do Wersji Pośredniej (Gatsby 4):
- Po analizie kompatybilności, jako pierwszy krok przeprowadzono migrację strony do Gatsby 4.25.0 oraz środowiska do Node.js 18.
- Zaktualizowano wszystkie wtyczki Gatsby do najwyższych wersji wspieranych przez Gatsby 4.
- Przeprowadzono kluczową refaktoryzację obrazów, migrując wszystkie instancje z przestarzałych
gatsby-background-imageigatsby-imagedo zunifikowanego, nowoczesnegostandardu gatsby-plugin-image. - Na tym etapie osiągnięto w pełni stabilną, działającą wersję strony.
2. Etap II – Finalna Migracja do Gatsby 5:
- Po ustabilizowaniu środowiska, rozpoczęto finalną migrację silnika strony do wersji Gatsby 5.14.0. Ta wersja, działając na Node.js 18, zapewnia również kompatybilność z przyszłościowymi wersjami (np. Node.js 22).
3. Etap III – Optymalizacja i Kontrola Jakości (QA):
- Naprawa Błędów i Ostrzeżeń: Wyeliminowano wszystkie ostrzeżenia (warnings) pojawiające się podczas procesu budowania strony oraz naprawiono krytyczne błędy, takie jak problem z odświeżaniem strony, przełączaniem języka i występowaniem podwójnego ukośnika ("//") w adresach URL.
- Czyszczenie Kodu: Usunięto wszystkie nieużywane pliki i moduły Node.js w celu optymalizacji projektu.
- Poprawki Stron: Wprowadzono dedykowane poprawki funkcjonalne i wizualne na podstronach "firma/company" oraz "kontakt/contact".
- Finalne Testy i Poprawki Wizualne: Ostateczny szlif projektu został nadany po szczegółowych konsultacjach i testach przeprowadzonych przez specjalistę QA i mojego przyjaciela, Tomasza Ciechomskiego, który pomógł zidentyfikować i dopracować najdrobniejsze detale wizualne.
Rezultat:
Projekt zakończył się sukcesem, dostarczając w pełni zmodernizowaną, stabilną i wydajną stronę internetową. Nowa wersja jest bezpieczniejsza, łatwiejsza w utrzymaniu i gotowa na dalszy, bezproblemowy rozwój.