Skip to content

Commit 9625c89

Browse files
committed
docs: finalize README with user preferred structure and GIFs
1 parent d3a3c57 commit 9625c89

1 file changed

Lines changed: 27 additions & 23 deletions

File tree

README.md

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
1-
<div align="center">
2-
<img src="public/app_screens/1.webp" alt="EL APP Hero Mockup" width="800" />
3-
<h1>🚀 EL APP - Twój Interaktywny Nauczyciel Angielskiego</h1>
1+
<div align="left">
2+
<img src="public/logo.webp" alt="EL APP Logo" width="120" />
3+
<h1>Twój Interaktywny Nauczyciel Angielskiego</h1>
44
<p><b>Nowoczesna nauka języka angielskiego oparta na etapach i wizualnych skojarzeniach.</b></p>
5-
6-
**🔗 [🔴 Zobacz Demo na żywo / Live Demo (Kliknij tutaj)](https://sevetoo.github.io/el-app) 🔗**
75
</div>
86

97
---
108

9+
**🔗 [🔴 Zobacz Demo na żywo / Live Demo (Kliknij tutaj)](https://sevetoo.github.io/el-app) 🔗**
10+
1111
## 📖 Spis Treści
12+
- [✨ Pierwsze Wrażenie](#-pierwsze-wrażenie)
1213
- [🛠️ Stack Technologiczny](#️-stack-technologiczny)
13-
- [✨ Pierwsze Wrażenie (Loader)](#-pierwsze-wrażenie-loader)
1414
- [✨ Etapy Nauki (Learning Flow)](#-etapy-nauki-learning-flow)
1515
- [🧠 Inteligentna Pętla Nauki (Study Loop)](#-inteligentna-pętla-nauki-study-loop)
1616
- [📈 Wydajność i Optymalizacja (98%+)](#-wydajność-i-optymalizacja-98)
@@ -22,6 +22,14 @@
2222

2323
---
2424

25+
## ✨ Pierwsze Wrażenie
26+
27+
Główny interfejs aplikacji został zaprojektowany z myślą o przejrzystości i intuicyjnej nawigacji. System kategorii pozwala na szybki dostęp do interesujących Cię tematów:
28+
29+
![EL APP Main Menu](public/app_screens/loading_screen.gif)
30+
31+
---
32+
2533
## 🛠️ Stack Technologiczny
2634

2735
Aplikacja została zbudowana w oparciu o najnowocześniejszy stack webowy, zapewniający szybkość, dostępność i responsywność:
@@ -38,30 +46,28 @@ Aplikacja została zbudowana w oparciu o najnowocześniejszy stack webowy, zapew
3846

3947
---
4048

41-
## ✨ Pierwsze Wrażenie (Loader)
42-
43-
Zamiast pustej strony, użytkownik widzi autorsko zaprojektowany ekran ładowania, który przygotowuje silnik nauki:
44-
45-
![Loading Screen Flow](public/app_screens/loading_screen.gif)
46-
47-
* **Animowane Logo**: Pulsujące i obracające się logo **EL APP**.
48-
* **Adaptacyjność**: Loader automatycznie wykrywa motyw przeglądarki użytkownika.
49-
50-
---
51-
5249
## ✨ Etapy Nauki (Learning Flow)
5350

5451
Aplikacja prowadzi użytkownika przez 5 inteligentnych etapów nauki, od poznania słowa do jego swobodnego użycia w zdaniu:
5552

5653
1. **🗂️ Etap 1: Fiszki (Flashcards)**
54+
- Dynamiczne karty z obrazkami i wymową native speakera.
5755
- ![Fiszki Flow](public/app_screens/stage_1.gif)
56+
5857
2. **⚖️ Etap 2: Szybka Ocena (Fast Review)**
58+
- Błyskawiczna weryfikacja znajomości słówek.
5959
- ![Oceń Flow](public/app_screens/stage_2.gif)
60+
6061
3. **🎮 Etap 3: Gra w Dopasowywanie (Matching Game)**
62+
- Trening skojarzeń wizualnych - dopasuj słowo do obrazka.
6163
- ![Gra Flow](public/app_screens/stage_3.gif)
64+
6265
4. **✍️ Etap 4: Test Pisemny (Written Test)**
66+
- Wpisywanie słówek z pamięci z trybem karnym za błędy.
6367
- ![Pisanie Flow](public/app_screens/stage_4.gif)
68+
6469
5. **📝 Etap 5: Uzupełnianie Zdań (Sentences)**
70+
- Użycie słowa w prawdziwym kontekście z systemem podpowiedzi.
6571
- ![Zdania Flow](public/app_screens/stage_5.gif)
6672

6773
---
@@ -87,7 +93,7 @@ Projekt osiąga najwyższe noty w audytach Lighthouse dzięki optymalizacji obra
8793

8894
## 🌓 Dark Mode & UI Showcase
8995

90-
Pełne wsparcie dla motywów jasnych i ciemnych z responsywnym układem:
96+
Pełne wsparcie dla motywów jasnych i ciemnych z responsywnym układem dostosowanym do urządzeń mobilnych:
9197

9298
| Wariant | Desktop | Mobile |
9399
| :--- | :---: | :---: |
@@ -113,10 +119,7 @@ Projektowanie na darmowe hostingi statyczne (GitHub Pages) wymagało kreatywnych
113119

114120
## 🎨 Prototypowanie UI (Design Exploration)
115121

116-
Aplikacja stale ewoluuje. W ramach prac nad nowym menu głównym, stworzyliśmy stronę z prototypami dostępną pod `/design-preview`. Testujemy tam koncepcje takie jak:
117-
- **Galaxy Cards** (Karty Galaktyki)
118-
- **Quest Path** (Ścieżka Zadań)
119-
- **Compact List** (Kompaktowa Lista)
122+
Aplikacja stale ewoluuje. W ramach prac nad nowym menu głównym, stworzyliśmy stronę z prototypami dostępną pod `/design-preview`.
120123

121124
---
122125

@@ -143,4 +146,5 @@ Obrazki użyte w aplikacji zostały wygenerowane za pomocą modelu **Nano Banana
143146

144147
---
145148

146-
_Stworzone z pasją do nauki języków by [SeveToo](https://github.com/SeveToo)_
149+
_Stworzone z pasją do nauki języków. by
150+
[SeveToo](https://github.com/SeveToo)_

0 commit comments

Comments
 (0)