diff --git a/README.md b/README.md
index 9f9b892..4a83de6 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-# 🎓 LearnPath
+# LearnPath
-**Adaptive learning with any OpenAI-compatible LLM**
+**Quizzes, flashcards and learning roadmaps from any OpenAI-compatible LLM, in English and Bahasa Melayu**
> AI-generated quizzes, flashcards and learning roadmaps, with spaced repetition and a simple progress view. In English and Bahasa Melayu.
@@ -11,6 +11,19 @@
**[Live demo →](https://learnpath-nine.vercel.app)** (bring your own API key: open **Settings**, pick a provider and paste a key)
+
+Screenshots taken in Safari/WebKit (desktop and iPhone 13). The quiz, roadmap and flashcard text is real model output.
+
+
Every AI feature goes through one provider layer (`src/lib/llm/`) that speaks the OpenAI `/chat/completions` protocol. Choose a built-in provider in the browser, or configure the server once with environment variables when you host it yourself.
---
@@ -19,7 +32,7 @@ Every AI feature goes through one provider layer (`src/lib/llm/`) that speaks th
| Feature | What it does |
|---------|--------------|
-| **Adaptive Quiz** | Generates multiple-choice questions for any topic at easy / medium / hard difficulty |
+| **Quiz** | Generates multiple-choice questions for any topic at the difficulty you choose (easy / medium / hard), with an explanation after each answer |
| **Flashcards** | Generates cards for a topic and schedules reviews with the SM-2 spaced-repetition algorithm |
| **Learning Roadmap** | Builds a step-by-step plan for a topic at beginner / intermediate / advanced level |
| **Progress Tracker** | Shows the sessions, scores and token usage from your current visit (kept in memory, not saved) |
diff --git a/docs/screenshots/flashcard-bm-iphone-dark.png b/docs/screenshots/flashcard-bm-iphone-dark.png
new file mode 100644
index 0000000..ad2ea44
Binary files /dev/null and b/docs/screenshots/flashcard-bm-iphone-dark.png differ
diff --git a/docs/screenshots/home-bm-light.png b/docs/screenshots/home-bm-light.png
new file mode 100644
index 0000000..9314342
Binary files /dev/null and b/docs/screenshots/home-bm-light.png differ
diff --git a/docs/screenshots/quiz-bm-iphone.png b/docs/screenshots/quiz-bm-iphone.png
new file mode 100644
index 0000000..2f6510b
Binary files /dev/null and b/docs/screenshots/quiz-bm-iphone.png differ
diff --git a/docs/screenshots/roadmap-en-dark.png b/docs/screenshots/roadmap-en-dark.png
new file mode 100644
index 0000000..6b19bfb
Binary files /dev/null and b/docs/screenshots/roadmap-en-dark.png differ