📖 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.

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.

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.


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.



📚 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 dosrc/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 -- --drypodaje 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 buildtworzy katalogdist/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.