Alex's Homework Tracker

How this app works

A quick guide for Mom and Dad. Alex doesn't need any of this — he just logs in and sees what's due.

1. One-time setup, in order

  1. Family — add the other parent (pick Mom or Dad) and Alex (his real name, the only place it's typed). Each person's email here is also their login and where reminders go — make sure Alex's is one he actually checks. They'll get an emailed invite link to set their own password; if nothing arrives, check that email is configured (see below) and use "Resend invite" on the Family tab.
  2. Subjects — add each subject once (Math, Reading, Science...). You'll pick from this list every time you add homework, so it stays tidy.
  3. You're set up. Everything below is the week-to-week routine.

2. Homework vs. Assignments — what's the difference

Homework is due a single day. It's what blocks "Activity unlocked" for that day.

Assignments are longer projects (a book report, a diorama) with their own due date, days or weeks out. They also block unlock once their due date arrives — but in the meantime, they show up on the Calendar and send reminder emails counting backward from the due date.

Rule of thumb: if it's due tomorrow, it's homework. If it's due next week or later, make it an assignment so the reminders kick in.

3. Adding homework (the day-to-day one)

On the Week tab, two ways:

4. Adding an assignment + setting reminders

Same "Add" form on Week, but pick Kind: Assignment. Two extra fields appear:

Reminders only fire if GMAIL_ADDRESS / GMAIL_APP_PASSWORD are set in Railway. Without them the app still works, it just won't send mail.

5. Reviewing what Alex turns in

The Review tab (with a red count badge when something's waiting) shows every submission. For each one you can:

If Alex says he did something at school, you'll see a flag asking you to verify it in person (ask to see the actual paper) rather than just approving from the photo.

Nothing counts as "done" for the day until everything due that day is approved.

6. Calendar and Week

Week is the day-by-day working view — where you add things and where Alex sees what's due. Calendar is a month-at-a-glance view with a 📌 marking assignment due dates — good for spotting a busy week coming up.

7. "No homework today"

Alex can't just skip a day silently. If nothing's entered for a day, he has to explain why ("teacher said no homework") and a parent has to confirm it before anything unlocks.