Przejdź do treści
Home Blog Projekty O mnie

Czytajnik

📖 Czytajnik

Aplikacja webowa (PWA) do nauki czytania metodą sylabową. Bajki i wiersze są podzielone na sylaby z łukami, a lektor czyta każdą sylabę, wyraz, wers albo całą stronę. Działa na tablecie, telefonie i komputerze, a po pierwszym otwarciu książki także offline. Nie ma kont: postęp i naklejki zapisują się w przeglądarce.

🎬 Demo

✨ Funkcjonalność

Półki z książkami

Książki stoją na półkach podzielonych na poziomy: od zabaw z literami (poziom 0), przez krótkie wierszyki (Sylabki), po dłuższe bajki z dialogami. Na górze jest „Czytaj dalej” z ostatnio czytaną książką i album naklejek przypiętych do tablicy korkowej.

Strona główna z półkami książek

Czytnik

  • Sylaba, wyraz, wers – dotknięcie łuku czyta sylabę, dotknięcie wyrazu czyta wyraz, a głośnik przy wersie czyta cały wers.
  • Karaoke – „Przeczytaj stronę” podświetla aktualnie czytany wyraz, a „Czytaj od tej strony” czyta do końca bajki i sam przewraca kartki.
  • Dwuznaki i zmiękczenia – „cz”, „sz”, „rz” czy „si” są wyróżnione kolorem, a wielkie litery można włączyć jednym przyciskiem.
  • Naklejki – po przeczytaniu bajki naklejka z jej bohaterem trafia do albumu.

Czytnik z podziałem na sylaby

Dwa głosy lektora

Przełącznik „Lektorka / Patryk” jest zawsze pod ręką obok ustawień. Głos „Patryk” to mój sklonowany głos z ElevenLabs, „Lektorka” to gotowy głos z biblioteki ElevenLabs.

Tryb wieczorny

Ciemny motyw do czytania przed snem, obejmujący stronę główną, czytnik i gry.

Strona główna w trybie wieczornym

Czytnik w trybie wieczornym

Gry z literkami

Poziom 0 to gry dla młodszych dzieci, m.in. zgadywanie literek, memory (wielka + mała litera), ślad paluszka, wielka i mała, polowanie na sylabę, pociąg sylab i puzzle.

Zgadywanie literek

Memory

Ślad paluszka

📚 Treści i licencje

  • Teksty – oryginały z domeny publicznej (Wolne Lektury), teksty na otwartych licencjach (CC BY, Licencja Wolnej Sztuki) oraz własne, uproszczone wersje baśni. W oryginałach słowa zostają bez zmian, dochodzi tylko podział na sylaby, wersy i strony.
  • Źródła – pochodzenie i licencja każdego tekstu są widoczne na stronie tytułowej książki i na stronie „O aplikacji”.
  • Ilustracje – generowane przez Codex na podstawie karty postaci, dzięki czemu bohaterowie wyglądają tak samo na każdej stronie.

🧱 Architektura

Frontend

  • React + TypeScript + Vite – statyczna aplikacja bez backendu, routing w hashu (#/czytaj/...), więc działa z dowolnej ścieżki.
  • PWA (vite-plugin-pwa) – aplikacja instaluje się na ekranie głównym, a nagrania i ilustracje trafiają do pamięci podręcznej przy pierwszym otwarciu książki.
  • Font Andika – krój projektowany z myślą o nauce czytania.

Treść jako kod

  • Każda książka to plik YAML (content/books/<id>.yaml) z tekstem zapisanym sylabami (Kap-tu-rek), opisami ilustracji, źródłem i licencją.
  • Kompilator tekstu (scripts/lib/text.ts) zamienia zapis na strukturę dla czytnika, wykrywa dwuznaki i zmiękczenia oraz pilnuje, żeby każda sylaba miała dokładnie jedną samogłoskę.
  • Wynik (npm run content) trafia do src/generated/ razem z miniaturami okładek i naklejkami.

Nagrania (ElevenLabs)

  • Strony – jedno nagranie na stronę z mapą czasów znaków, z której działa karaoke i wycinanie pojedynczych wersów.
  • Wyrazy i sylaby – osobne krótkie klipy, każdy nagrywany raz dla całej biblioteki. Krótkie sylaby dostają znacznik polskiej wymowy, żeby „by” nie brzmiało jak angielskie „bye”.
  • Wymowa – wyrazy problematyczne mają własny zapis dla lektora (np. „Maca” czytane jako „maka”), także osobno dla każdego głosu.
  • Koszty – nazwy plików zawierają hash treści, więc generowane jest tylko to, co się zmieniło, a npm run audio -- --dry podaje koszt w znakach przed nagraniem.

Ilustracje (Codex CLI)

  • npm run images -- <id> najpierw tworzy kartę postaci, a potem okładkę i strony, każdą z kartą jako obrazem referencyjnym.
  • Kilka obrazków generuje się równolegle, a poprawka jednej strony to jedno uruchomienie z --only=pNN --force.

Wdrożenie

  • npm run build tworzy katalog dist/ z samymi plikami statycznymi, który trafia na serwer WWW.
  • Testy (npm test) sprawdzają m.in. kompilator sylab, komplet nagrań w obu głosach i logikę gier.