Grade4 Study Buddy

A fully offline study web app for a Grade 4 student in Dubai, built to follow the child's actual school books (not a generic NCERT syllabus).

Built with plain HTML + CSS + JavaScript — no React, no build tools, no server, no internet, no login, no paid services.

---

How to open the app (offline)

1. Make sure you have the whole grade4-study-buddy folder on the laptop.
2. Double-click index.html — it opens in your default browser.
3. That's it. No installation, no internet, no setup.

Tip: Chrome, Edge, or Firefox all work. You can bookmark the opened page.

---

What is implemented right now (this build)

• Kid-friendly home dashboard with greeting and quick subject links.
• Top navigation: Home · Subjects · Parent Dashboard · Settings.
• A visible OFFLINE READY label.
• Subject cards for Science, Hindi, Maths, English, Arabic showing:
  • Subject name, book name, publisher/source, and number of chapters, plus an Open button.
• Real chapter lists for every subject, taken from the child's actual books.
• Arabic shows two sections:
  • Arabic Recovery Track (start-from-zero basics)
  • School Arabic Book Track (with right-to-left display + units)
• Each chapter shows placeholder buttons: Learn · Practice · Quiz · Mock Test (they currently say "Coming in next build").
• Settings page to set the student name, saved in localStorage.
• Parent Dashboard and Progress placeholder areas.
• Safe localStorage wrapper (SBStorage) with namespaced keys (g4sb.).

Books used as the data source

Subject	Book	Source
Science	The Vivid World of Science	Cambridge, MENA Edition
Hindi	अबीर हिंदी पाठमाला	Language House, Gulf Edition (Ver. 2)
Maths	Maths Ahead	Orient BlackSwan (NEP/NCF aligned)
English	Elevate Your English with Cambridge — Coursebook 4	Cambridge, MENA Edition
Arabic	العربية لغتنا	UAE Ministry of Education, Level 04 (2025-2026)

---

What is NOT implemented yet

• Lesson content for Learn mode (no full lessons added).
• Practice questions / quizzes (question banks are intentionally empty).
• Mock test engine, scoring, and attempt history.
• Wrong-answer notebook.
• Real progress tracking, stars, badges, and daily study plan.
• Parent dashboard analytics.
• Backup export / import.

These will come in later builds.

---

No internet / backend / paid services

• The app runs from local files only. No internet connection is needed.
• No backend, no database server, no Supabase/Firebase, no cloud, no login.
• No paid APIs. Everything happens inside your browser.
• Saved data (student name, and later progress) stays on this computer only, in the browser's localStorage.

---

⚠️ Important note on assessments / school portions

The mock tests and assessment-wise portions (Assessment 1 / 2 / 3 / Final) still need to be confirmed against the school's official test syllabus. Chapter names match the books, but which chapters fall under each term/assessment must be verified with the school before assessment content is built. Do not assume the assessment split.

---

Folder structure

grade4-study-buddy/
  index.html
  README.md
  css/      styles.css, themes.css, rtl.css
  js/       storage.js, app.js, ui.js
  data/     subjects.js + per-subject chapters.js/questions.js (+ arabic/recovery.js)
  assets/   images/, audio/, fonts/   (for later builds)