Study Planner with Exam Countdown and Revision Scheduler

Students lose marks less often to difficulty than to disorganisation — syllabi finished too late, revisions crammed the night before, no honest record of hours actually studied. Existing study apps are usually either pomodoro timers with no plan or rigid timetables with no memory of what was actually learned. The gap this project fills is a planner that remembers: exam dates drive countdowns, countdowns drive urgency, and an SM-2-inspired spaced-repetition scheduler decides what gets revised today based on past recall ratings. A topic you failed yesterday comes back tomorrow; one you aced three times waits a month. That forgetting-curve logic is the interesting computer-science content — a priority queue keyed on overdue-days and exam proximity — wrapped in a dashboard students would genuinely open daily.

1. Exams are stored as {subject, date, units, target, syllabus%} objects; days-left is computed live from the system date.
2. When a topic session is completed, the student rates recall 1–5; the scheduler maps the rating to the next interval on the SM-2-inspired ladder.
3. The revision queue sorts due reviews by an urgency score combining overdue days and the proximity of the linked exam.
4. Passing a review advances the topic one rung up the interval ladder; failing resets it to 1 day — both update the queue immediately.
5. The timetable marks queue-pulled reviews as (R) sessions so the week's plan reflects what the scheduler decided.
6. The dashboard aggregates today's sessions into focused hours and completion fraction, drawn as a progress bar and a stacked weekly chart on Canvas.
7. The full project extends this with accounts, cloud sync, a mobile PWA and teacher-shared study plans.

Tech stack:

• HTML5, CSS3 (custom design system, no framework)
• Vanilla JavaScript (ES6)
• Canvas API for weekly study chart
• Hash-based SPA routing
• SM-2-inspired spaced-repetition algorithm

• [Exam countdowns with syllabus tracking] Each exam shows days remaining, unit count, target score and a syllabus-coverage bar computed from completed units.
• [SM-2-inspired revision scheduler] Recall ratings 1–5 set the next review interval (1 → 3 → 7 → 14 → 30 days); failed recalls reset to 1 day.
• [Priority revision queue] Due reviews are ordered by urgency (days overdue × exam proximity) with pass/fail actions that reschedule instantly.
• [Weekly timetable] Fixed study slots across the week with (R) markers for sessions pulled from the revision queue.
• [Focus dashboard] Today's sessions with done/undo, focused-hours total, day streak and revisions-due count, plus a weekly hours chart split by first-learn vs revision.
• [Add/remove exams and sessions] Full CRUD on exams and today's sessions in the demo build.
• [Single-file SPA] Four hash-routed views, no build step, no server, deployable anywhere.

• Complete single-file study planner web app
• Spaced-repetition scheduler module with documented interval logic
• Demo dataset (exams, sessions, revision queue, timetable)
• Project report PDF (requirements, scheduler design, architecture, screenshots)
• PPT presentation for final review
• Viva Q&A preparation document (SM-2 algorithm, forgetting curve, SPA design)

• The demo build keeps state in memory — a refresh resets to the bundled dataset; the report documents the localStorage/cloud upgrade path.
• Recall ratings are self-reported; the scheduler is only as honest as the input.
• The interval ladder is a simplified SM-2 variant tuned for demo clarity, not a clinically validated memory model.
• No accounts, sync or notifications in the demo build — listed as future scope.
• Timetable is a fixed weekly template; drag-and-drop rescheduling is future scope.