Last Done Tracker

A modern, offline-first PWA for tracking the recurring, never-really-finished stuff that's easy to forget: when did you last water the plants, change the sheets, clean the litter box, call Mom? See when you last did anything — and what's due — at a glance.

A clean-room web re-imagining of the lastGLANCE concept, built with React + Vite + Tailwind. Your data stays on your device.

What it does

• At-a-glance color states — every chore card eases from green → amber → red as it approaches and passes its due date. One look tells you what needs attention.
• One-tap done — tap a chore the moment you do it. That's the whole interaction.
• Cadences — give each chore a rough rhythm (daily, weekly, every 3 months, or any custom number of days), or leave it untimed.
• Categories — group chores (Home, Plants, Pets, Health, Car…), each with its own icon and colour, and filter by them.
• Households — add people, assign chores, and filter the view to just one person ("me").
• Seasonal chores — chores that only count during part of the year (e.g. salt the driveway Nov–Feb) go dormant off-season.
• Completion notes & history — add a note to any completion and see the full history per chore.
• Activity heatmap — a GitHub-style contribution heatmap of everything you've kept up with, plus streaks and stats.
• Search — jump straight to any chore.
• Light / dark / system themes.
• Backup & restore — export/import your data as a JSON file. Everything lives in the browser (localStorage); nothing leaves your device.
• Overdue notifications — opt-in system notifications nudge you when chores go overdue (see below).
• Installable PWA — add it to your home screen or desktop; works fully offline via a service worker.

Notifications — how they work

Two layers, both wired up:

• Local reminders (no server). The browser's Notifications API fires a daily summary of overdue chores while the app is open or recently backgrounded. Enable it under Settings → Notifications.
• Background push (self-hosted server). True reminders that fire even when the app has been closed for days. Toggle "Background push" in Settings; the app subscribes via Web Push, syncs a compact due-schedule to the backend in /server, and a cron sweep pushes overdue nudges. Tapping Done on the notification marks the chore complete in the app.

The service worker (src/sw.js) handles both push and notificationclick. Platform notes: Android Chrome and desktop browsers support web push well; iOS supports it only for PWAs added to the home screen (iOS 16.4+).

See server/README.md to run the push backend (docker compose up).

Tech

• React 18 + Vite 5
• Tailwind CSS 3
• vite-plugin-pwa (Workbox) for the manifest + offline service worker
• State via React useReducer + Context; persistence in localStorage (wrapped so IndexedDB or cloud sync can drop in later)
• Zero backend, zero accounts, zero analytics

Getting started

npm install
npm run dev      # http://localhost:5173
npm run build    # production build to dist/
npm run preview  # serve the production build

Self-host with Docker (app + push in one container)

One image builds this frontend and serves it alongside the push API at the same origin. Use the repo-root docker-compose.yml — its build context is the repo root, so a plain git checkout builds as-is.

Manual / local:

docker compose up -d --build      # from the repo root

Then open http://<host>:${PUSH_PORT} (default 4000).

Deploy via Dockhand (pull a prebuilt image — recommended):

Dockhand only stores the compose file, not the repo, so it can't build — it pulls the image that GitHub Actions publishes (.github/workflows/docker-publish.yml) to ghcr.io/s39n/lastdone-push:latest.

1. Push this repo so the workflow runs and publishes the image (check the Actions tab).
2. Give the NAS access to the (private) image — either make the GHCR package public in its package settings, or on the NAS run docker login ghcr.io -u s39n with a read:packages PAT.
3. In Dockhand, paste the root docker-compose.yml (or point at it); set DATA_PATH (a folder on your NAS) and VAPID_CONTACT in the env editor; optionally PUSH_PORT / IMAGE.
4. Deploy. Each push to main rebuilds the image; redeploy in Dockhand to pull :latest. Because DATA_PATH lives on the NAS, subscriptions and the VAPID keypair survive across image updates.

To build on the host instead (only if your deployer does a full git checkout), swap image: for the commented build: block in the root compose.

See server/README.md for the full env-var list, NAS/NFS storage, ports, and troubleshooting.

Project structure

src/
  App.jsx                 # shell: header, filters, views, bottom nav, FAB
  lib/
    dates.js              # cadence + color-state + season math (the core logic)
    store.jsx             # reducer, context, persistence, derived selectors
    seed.js               # demo data on first run
    notifications.js      # phase-1 local notifications + phase-2 push stub
    icons.js, uid.js
  components/
    ChoreCard.jsx         # the color-coded card with one-tap done
    ChoreDetail.jsx       # history, complete-with-note, edit, archive
    AddEditChore.jsx      # add/edit form (icon, cadence, category, person, seasonal)
    Stats.jsx, Heatmap.jsx
    Settings.jsx          # people, categories, notifications, theme, backup
    Sheet.jsx, Pickers.jsx

Design

Editorial-minimal aesthetic (Linear/Vercel-leaning): near-monochrome canvas, a single indigo accent, Geist Sans for UI with Geist Mono for timestamps and figures, hairline borders over shadows, and Lucide line icons throughout. Chore urgency reads as a color state (green → amber → red) shown as a left edge and a monospaced label. Full light/dark support.

Roadmap

• Phase 2: Web Push backend for background overdue reminders
• Optional end-to-end-encrypted cloud sync
• Home-screen widgets / Quick Settings tiles (native wrapper)

License

Private project. Concept inspired by lastGLANCE; implementation is original.