docs: update README.md with ClassLens content instead of ChatKit templates

README.md

@@ -1,17 +1,66 @@
 ---
-license: mit
-title: classlens
+title: ClassLens
+emoji: 📊
+colorFrom: green
+colorTo: pink
 sdk: static
-emoji: 🚀
-colorFrom: red
-colorTo: red
-short_description: classlens
+app_file: backend/static/report-template.html
+license: mit
+short_description: AI-powered exam analysis that transforms Google Form quiz responses into beautiful, actionable reports for teachers.
 ---
-# OpenAI ChatKit Starter Templates
 
-This repository contains two starter apps as reference implementations of minimal ChatKit integrations.
+# 📊 ClassLens
+
+**AI-powered exam analysis that transforms Google Form quiz responses into beautiful, actionable reports for teachers.**
+
+## ✨ Features
+
+- 🔗 **Google Forms Integration**: Paste your Google Form response sheet URL
+- 📈 **Automatic Grading**: Compare student answers to your answer key
+- 📊 **Visual Statistics**: Interactive charts showing score distribution and per-question accuracy
+- 🎯 **Detailed Explanations**: Bilingual (English + 中文) explanations for each question
+- 👥 **Peer Learning Groups**: AI-suggested groupings for collaborative learning
+- 📧 **Email Reports**: Send beautiful HTML reports directly to your inbox
+- 🎨 **Beautiful Reports**: Dark theme with Chart.js visualizations
+
+## 🚀 How to Use
+
+1. **Paste your Google Form URL** (the response spreadsheet, not the form itself)
+2. **Provide your email** (for receiving the report)
+3. **Optionally add answer key** if not embedded in the form
+4. **Click analyze** and watch the AI work!
+
+## 🔐 Privacy
 
-You can run the following examples:
+- Student names are displayed in full in reports for internal teacher use
+- No data is stored permanently
+- OAuth tokens are encrypted
+
+## 🛠️ Tech Stack
+
+- **Frontend**: React + Vite + TailwindCSS
+- **Backend**: FastAPI + OpenAI ChatKit
+- **Charts**: Chart.js
+- **AI**: GPT-4.1-mini
+
+## 📝 Example Report Sections
+
+### 📝 Q&A Analysis (題目詳解)
+- Reading passages with highlighted key terms
+- Per-question explanations with concept tags
+- Common mistakes and solving strategies
+
+### 📊 Statistics (成績統計)
+- Score distribution bar chart
+- Question accuracy doughnut chart
+- Individual student performance table
+
+### 👩‍🏫 Teacher Insights (教師建議)
+- Overall performance analysis
+- Teaching recommendations
+- AI prompt for next quiz generation
+- Individual student support suggestions
+
+---
 
-- [**ChatKit**](chatkit) - example of a self-hosted ChatKit integration.
-- [**Managed ChatKit**](managed-chatkit) – example of a managed ChatKit integration with hosted workflows.
+Built with ❤️ by [taboola-cz](https://huggingface.co/taboola-cz) for educators