shabanihamidu19-cell/skonga-academy

Skonga Academy — Programming kwa Kiswahili rahisi. Full curriculum from Beginner to Projects with AI Teacher. # ⚡ Skonga Academy **Programming kwa Kiswahili rahisi — kutoka Beginner hadi kujenga Projects** Production-ready frontend for a complete 15-module programming curriculum. --- ## 🚀 Quick Start ```bash cd SKONGA_ACADEMY npx serve . -p 3000 # open localhost ``` Or open `index.html` directly in a browser. --- ## 📦 What's Included | Item | Status | |------|--------| | 15 modules (Foundations → Project Lab) | ✅ | | 110 lessons with full structure | ✅ | | Ask Teacher (real AI API) | ✅ | | Progress tracking | ✅ | | Dark / Light theme | ✅ | | Search (Ctrl/Cmd+K) | ✅ | | Responsive design | ✅ | | Zero build step | ✅ | --- ## 👨‍🏫 Ask Teacher — Real AI Supports: - **OpenAI** (gpt-4o-mini, etc.) - **Anthropic Claude** - **xAI Grok** - **Groq** (fast free tier) - **Ollama** (local, no API key) - **Custom** OpenAI-compatible endpoints ### Setup 1. Open **Ask Teacher** 2. Expand **API Settings** 3. Choose provider + paste API key 4. Save **Free options:** - Groq — free API key, very fast - Ollama — run locally (`ollama run llama3.2`) Keys are stored only in your browser `localStorage`. ### Teacher modes Explain · Hint · Debug · Practice · Quiz · Explain Code --- ## 🧭 Curriculum (15 modules) 0. Coding Foundations (optional, recommended) 1. HTML 2. CSS 3. JavaScript 4. DOM & Events 5. Python 6. Git & GitHub 7. Developer Tools 8. APIs & Web Data 9. Backend Development 10. Security Fundamentals 11. AI & Automation 12. App Development 13. Computer Science Fundamentals 14. Project Lab Every lesson: Objectives → Concept → Explanation → Examples → Practice → Mistakes → Challenge → Ask Teacher → Checkpoint → Next --- ## 📁 Structure ``` SKONGA_ACADEMY/ ├── index.html ├── style.css ├── app.js ├── package.json ├── data/ │ ├── curriculum.js # Module + lesson metadata │ ├── lessons.js # Full content (110 lessons) │ └── challenges.js ├── lessons/ # Future per-topic assets └── assets/ ``` --- ## 🌐 Deploy Static hosting — no build …