Wróć do projektów

VisitedCountries

Interaktywna mapa podróży, na której użytkownik może zaznaczać odwiedzone kraje, prowadzić ich listę, zapisywać daty wizyt i tworzyć listę miejsc, które chce odwiedzić. Aplikacja działa jako PWA oraz na Androidzie i iOS dzięki Capacitorowi.

Mapa odwiedzonych krajów w jasnym motywie – powiększ

Punkt wyjścia

Stworzyłem tę aplikację, żeby nauczyć się TypeScriptu i przejść w praktyce przez cały proces budowy aplikacji w React — od logowania i bazy danych, przez testy i monitoring błędów, po przygotowanie wersji mobilnej.

Wyzwanie

Chciałem zbudować prostą i wygodną aplikację, w której użytkownik zaznacza odwiedzone kraje na mapie świata, prowadzi ich listę i może wrócić do swoich danych na dowolnym urządzeniu.

Jak to zrobiłem

Technicznie oparłem aplikację na React, TypeScript i Vite. Mapę przygotowałem w react-simple-maps, dodając przybliżanie oraz możliwość zaznaczania krajów. Kliknięcie kraju dodaje go do listy, a ponowne kliknięcie — po potwierdzeniu w modalu — usuwa go z zapisanych danych.

Listę krajów oraz dane użytkownika obsłużyłem za pomocą Redux Toolkit i Firebase Realtime Database. Logowanie, rejestrację, reset hasła i edycję profilu z awatarem oparłem na Firebase Auth i Firebase Storage, a formularze przygotowałem z wykorzystaniem Formik i Yup.

Dodałem jasny i ciemny motyw w styled-components, wersje językowe PL i EN w i18next, osobne menu desktopowe i mobilne, PWA, buildy na Androida i iOS w Capacitorze oraz monitoring błędów w Sentry.

Po kilku latach wróciłem do projektu, aby zaktualizować go technologicznie i rozbudować o nowe funkcje. Dodałem zapisywanie dat odwiedzin i statystyki roczne, wyszukiwanie krajów, ulubione kraje z licznikiem, powiadomienia przechowywane w Firebase oraz lokalną bazę danych krajów. Usprawniłem interfejs mobilny i przebudowałem część komponentów po usunięciu zewnętrznej biblioteki UI. Poprawiłem dostępność aplikacji, w tym obsługę klawiatury, etykiety dla czytników ekranu i zarządzanie focusem.

Zaktualizowałem aplikację do React 19 i nowszych wersji bibliotek, dodałem testy jednostkowe i komponentowe oraz testy end-to-end w Cypress. Uporządkowałem konfigurację projektu, zoptymalizowałem grafiki i odświeżyłem dokumentację.

Efekt

Powstała kompletna, wieloplatformowa aplikacja do śledzenia podróży, łącząca interaktywną mapę, listy krajów, konto użytkownika i synchronizację danych. Pierwotny projekt pozwolił mi przećwiczyć cały proces budowy aplikacji React, a późniejszy powrót umożliwił modernizację kodu, poprawę dostępności, zwiększenie pokrycia testami i dodanie funkcji przydatnych w codziennym korzystaniu z aplikacji.

Masz pytania?

Napisz do mnie