diff --git a/README.md b/README.md
index 5a3d8ee..be9641e 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,28 @@
 # hikaruven
-AI-powered quiz learning platform built with Flask, OpenAI and Bootstrap
+# Focus Unlock
+
+AI-powered learning platform that helps you study smarter.
+
+## Features
+- Paste any study text → generates 5 multiple-choice questions using OpenAI
+- Interactive quiz with instant feedback and scoring
+- Save past quiz results (score, date, percentage)
+- View detailed past quiz answers & correct answers
+- Save and manage study materials locally
+- Responsive Bootstrap 5 design + modern indigo theme
+
+## Tech stack
+- Backend: Flask (Python)
+- AI: OpenAI GPT-4o-mini
+- Frontend: HTML + Bootstrap 5 + JavaScript
+- Storage: browser localStorage (no database yet)
+
+## How to run locally
+1. Clone repo
+2. `cd focus-unlock`
+3. `python -m venv env`
+4. `source env/bin/activate` (Mac/Linux) or `env\Scripts\activate` (Windows)
+5. `pip install flask openai`
+6. Set your OpenAI key:
+   ```bash
+   export OPENAI_API_KEY="sk-..."