Revision Timetable App — Plan Your Exams

You don't revise a subject once — you revise it two, three, sometimes four times, and each round should take less time than the last because the material is more familiar. The planner is built entirely around that shape:

• Round 1, Round 2, Round 3… — each is a separate pass through every chapter in every subject.
• Rounds get shorter by default. The planner opens with a sensible starting point: 6 days, then 3, then 2 for a three-round plan. You can add up to 10 rounds or drop to as few as 1, and change any round's day count.
• Every subject follows the same round structure, but each subject's chapters get their own even share of that round's days — a subject with 5 chapters and a 5-day round gets 1 day per chapter, spread automatically. You can then hand-adjust any individual chapter's slice if one chapter clearly needs more than an even split.

Open the planner and you get one row per round, each with a day count you type in:

Revision 1 – Days per Subject: 6 days
Revision 2 – Days per Subject: 3 days
Revision 3 – Days per Subject: 2 days

Tap Apply Plan and every subject currently sitting in a given round gets that round's day allocation, split evenly across its own chapters. A subject in round 1 gets the 6-day figure; a subject that's already on round 2 gets the 3-day figure — the plan follows each subject to wherever it actually is.

Once applied, the dialog switches to view mode: your numbers are shown read-only with an Edit Plan button, so you can see what's currently set without accidentally nudging a field.

Every time you change a number, before you even save, the planner recalculates a small report:

• Total Days Scheduled — the round-by-round days you've typed, multiplied by how many subjects you have. This is what your plan is asking for, in total, across every subject running in parallel.
• Total Days Revised — how many calendar days you've actually put into revision so far, counted from your real activity dates, not from the plan. Days where you revised more than one subject only count once — you don't get charged twice for working on two subjects the same afternoon.
• Additional Days Took — where a past or current round ran over its own allocation, the overrun converted into days. This is the plan telling you "round 1 was supposed to cost 6 days, it actually cost 9."
• Days Saved — the opposite: rounds you finished early, converted into days you got back.
• Custom Days Adjust — this one is subtle but important. If a subject's actual allocation doesn't match what you've just typed — because you gave that one subject its own custom day count from its card (see below), or because an old plan is still in effect for it — the difference shows up here, so changing the global numbers doesn't quietly ignore subjects you've already customized.
• Adjusted Buffer / Spare — the number you actually came for. It takes the days between now and your earliest exam date, subtracts everything you've scheduled, backs out any overruns, adds back any days you saved, and corrects for custom subjects. The result is shown in green if you're still comfortably inside your deadline, red if the plan as written would run past it. If no subject has an exam date set yet, it simply says so instead of guessing.

That's the whole negotiation the planner exists for: type a number of days per round, and immediately see whether your exam date can actually absorb it — rather than finding out three weeks in.

The global plan is a starting point, not a cage. On each subject's card in the Revision Tracker there's a small pencil-and-calendar button — "Set Plan" (or the subject's current day count once one exists) — that opens a simple prompt: "How many days do you want to allocate for revising this subject?" Whatever you enter there replaces that subject's share from the global plan and splits evenly across its own chapters instead. This is exactly the number the summary panel's "Custom Days Adjust" line is watching for.

Once a round is running, each chapter is marked the same way learning chapters are — a status (Not started, In progress, Completed, Skipped) plus a percentage slider, kept in sync with each other automatically. The difference is that this status writes to the chapter's revision fields, not its learning ones, so ticking off round 2 never touches how far through the syllabus you originally got.

Every subject's card shows where it stands against the clock:

It also shows days left or days overdue for the round, worked out from how many minutes of revision you've logged against how many minutes the round's day count allows.

Setting a day allocation doesn't start a countdown by itself. The first time you actually mark progress on a subject's revision, the app asks for confirmation before starting that subject's clock — so opening the planner and typing numbers never silently begins counting down days you haven't used yet.

If you're already revising other subjects at the same time, it warns you differently: starting another one means all your active subjects now draw from a shared pool of days rather than separate private ones — because you're genuinely splitting the same real days across more material, and the app wants that visible before you commit.

You can only start round 2 once round 1 is finished — every chapter in it completed or skipped. Until then, the next round's card is shown locked and blurred, with a plain "Complete or skip Revision N to unlock" message.

When it does unlock, starting it isn't a quiet default action — you get an explicit warning first:

Once started, Revision 1 data will be permanently locked. You will not be able to edit or reset previous revisions.

Confirming it:

• Archives every chapter's final status for the round that just ended, so you can look back at exactly what state each chapter was in.
• Records that round's allocated time vs. the time you actually spent, and how many real days it took — the numbers the summary panel's "Additional Days Took" and "Days Saved" lines are built from.
• Resets every chapter to Not started for the new round, applying whatever day count the plan (or your custom override) has for it.
• Resets that subject's clock to zero for the fresh round.

This is deliberately permanent. A revision history you could quietly edit after the fact wouldn't be trustworthy evidence of how your pace is actually changing round to round — and that evidence is exactly what makes round 3's estimate better than round 1's guess.

• The focus timer logs time per subject, per chapter, and per revision cycle specifically, so a session run while revising round 2 is never mistaken for round 1's time or for original learning time.
• Auto-promotion works the same way it does for learning: revise a chapter for at least a minute in the timer and it moves itself from Not started to In progress, without overriding any status you've set by hand.
• The Study Planner, if you're using it instead, runs its own revision cycles and spaced-repetition recall directly on the calendar — the two systems are independent, and a subject you're tracking through the Revision Planner is not also being scheduled by the planner's own revision logic.

A single "days left to revise" number hides the thing that actually breaks a revision schedule: rounds don't cost what you expect, and by round 2 you usually know it. By tracking every round's real cost separately, feeding that history back into the buffer calculation, and forcing the plan to reconcile against your actual exam date on every keystroke, the planner is built to catch a slipping schedule while there's still round left to fix it — not after the last one has already run out.