Goal Tracking

A single-user, web-based goal tracker with push notification reminders. Installs as a PWA on desktop and mobile.

Features

• Three goal types — binary (did it / didn't), quantitative (sum a value to hit a target), milestone (long projects)
• Daily / weekly / monthly cadence with per-period streaks
• Why-statement per goal — pinned during check-ins
• Pause goals so streaks don't break on vacation
• Reminders at a chosen time and weekday selection
• Escalating nudges when you miss a day — fired once, after 9am
• Sunday weekly digest push notification
• Quick-log from notification — tap "✓ Done" on binary goals without opening the app
• Calendar heatmap (GitHub-contributions style) for the last 6 months
• Trend chart per goal (line for daily, bar for weekly/monthly)
• 24-hour edit lock on past entries — keeps history honest
• Export all data as JSON or CSV
• Dark mode with system-preference auto-detect
• Command palette (⌘K / Ctrl+K) for jump-to-goal and quick actions
• PWA — installs to phone home screen, push works on Android and iOS 16.4+

Stack

Next.js 15 (App Router) · TypeScript · Tailwind · Drizzle ORM · Postgres (pg) · iron-session · web-push · Recharts

---

Local development

npm install
cp .env.example .env.local      # fill in vars below
npm run db:migrate              # apply schema to Postgres
npm run dev

Required env vars (see .env.example):

DATABASE_URL=postgres://user:pass@localhost:5432/reminders
APP_PASSWORD=pick-anything-strong
SESSION_SECRET=$(node -e "console.log(require('crypto').randomBytes(32).toString('hex'))")
VAPID_PUBLIC_KEY=...          # generate with: npm run vapid:gen
VAPID_PRIVATE_KEY=...
VAPID_SUBJECT=mailto:you@example.com
CRON_SECRET=...                # any random string
APP_TIMEZONE=America/New_York

Visit http://localhost:3152, log in, create a goal, enable push from Settings.

---

Deploy to Unraid (Docker + Cloudflare Tunnel)

This is the production setup: Postgres + the app in Docker on Unraid, Cloudflare Tunnel for HTTPS, Ofelia for cron.

Two ways to run the containers — pick one:

• Pure Docker tab path (recommended) — install four Unraid templates from the Docker tab. GitHub Actions builds the image and publishes to GHCR; Unraid pulls from there. Zero command-line after the one-time fork + network creation.
• docker compose path (below) — clone the repo to appdata and run docker compose up -d. Better if you'd rather have one config file you can edit.

Both use the same image, same Postgres data dir, and the same env vars — switching later is just docker compose down and re-creating from the templates (or vice versa).

---

Option A: Docker tab only

See unraid/templates/README.md for the full step-by-step. Summary:

1. Fork this repo. The included GitHub Actions workflow auto-builds and publishes ghcr.io/<your-username>/reminders-app:latest. Make the package public.
2. In Unraid → Docker → Network, add a bridge network named reminders.
3. Install four templates from the Docker tab (postgres, app, ofelia, cloudflared).
4. Done — open your Cloudflare hostname.

---

Option B: docker compose

1. Clone to appdata

On the Unraid console (or via SSH):

mkdir -p /mnt/user/appdata/reminders
cd /mnt/user/appdata/reminders
git clone git@github.com:CopesaCola/reminders-app-web.git app
cd app

2. Generate secrets

# 32+ char session secret
docker run --rm node:20-alpine node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# VAPID keypair for Web Push
docker run --rm -v "$PWD":/work -w /work node:20-alpine sh -c "npm install --no-save web-push && node scripts/gen-vapid.mjs"

# Cron bearer token
docker run --rm node:20-alpine node -e "console.log(require('crypto').randomBytes(24).toString('hex'))"

3. Configure environment

cp .env.docker.example .env
nano .env       # paste the values you just generated

4. Set up the Cloudflare Tunnel

1. In Cloudflare Zero Trust dashboard → Networks → Tunnels, click Create a tunnel → Cloudflared.
2. Name it (e.g. reminders), copy the connector token shown after install.
3. Paste it into .env as CLOUDFLARE_TUNNEL_TOKEN=....
4. Still in the Cloudflare dashboard, under your tunnel's Public Hostname tab, add a route:
   • Subdomain + domain you control (e.g. goals.example.com)
   • Service: HTTP → app:3152
   • That hostname is now your app URL. Cloudflare handles TLS automatically.

5. Build and start

docker compose build
docker compose up -d
docker compose logs -f app     # watch migrations run then server start

The first start runs migrations (drizzle/0000_init.sql) against the Postgres container, then boots Next.js.

Visit your Cloudflare hostname. Log in with APP_PASSWORD. From your phone: "Add to Home Screen" first, then open the installed app and enable push from Settings.

6. Cron (already running)

There's nothing to set up — docker compose up -d already started the Ofelia sidecar (reminders-cron container). It reads schedule labels on the app container via the Docker socket and fires:

• /api/cron/reminders every 15 minutes
• /api/cron/weekly-digest Sunday at 18:00 (in APP_TIMEZONE)

To change schedules, edit the ofelia.job-exec.*.schedule labels in docker-compose.yml and docker compose up -d. To disable a job temporarily, comment out its labels and re-up.

Confirm it's working:

docker compose logs -f ofelia    # you'll see jobs registered, then "Job started" entries on schedule

7. Verify

# Trigger a reminder immediately
curl -X POST -H "Authorization: Bearer $CRON_SECRET" http://localhost:3152/api/cron/reminders

# Or click "Send test" in the app's Settings page

Updating

cd /mnt/user/appdata/reminders/app
git pull
docker compose build
docker compose up -d

The entrypoint runs drizzle/ migrations automatically on each start, so schema changes apply on rebuild.

Backup

The Postgres data lives at /mnt/user/appdata/reminders/postgres. Add it to your Unraid CA Backup / Restore Appdata plugin schedule, or pg_dump from outside:

docker exec -t reminders-db pg_dump -U reminders reminders > backup-$(date +%F).sql

Restore

cat backup-2026-05-18.sql | docker exec -i reminders-db psql -U reminders -d reminders

---

How it works

• Auth — one password (APP_PASSWORD), checked in src/app/api/auth/login/route.ts. On success, an encrypted iron-session cookie is set. src/middleware.ts gates every page except /login and the cron endpoints (which use CRON_SECRET).
• Streaks — src/lib/cadence.ts buckets entries by period (day/week/month) and counts consecutive periods where the goal hit its target. Paused goals don't break streaks.
• Reminders — the Ofelia sidecar container hits /api/cron/reminders every 15 minutes by exec-ing curl inside the app container. Each goal has remindAtMinutes (0–1439 in local time) and remindDaysMask (bit per weekday). If now falls within the 15-min window and the goal's not yet hit for its current period, it sends a push. Sent reminders are logged in reminder_log to prevent duplicates.
• Push — web-push library with VAPID. The service worker (public/sw.js) shows the notification and handles the "Done" action by POSTing to /api/entries.
• 24h edit lock — entries created more than 24h ago can't be edited unless the entry is for today. Enforced in /api/entries POST.
• Migrations — Drizzle generates SQL files into drizzle/. The container entrypoint (docker-entrypoint.sh) runs scripts/migrate.mjs on every start. Idempotent.

Keyboard shortcuts

• ⌘K / Ctrl+K — command palette
• n — new goal
• g — go to goals list
• ? — open palette with help

Customizing

• Cron interval — change the ofelia.job-exec.reminders.schedule label in docker-compose.yml and update the WINDOW constant in src/app/api/cron/reminders/route.ts to match.
• Timezone — change APP_TIMEZONE in .env and docker compose up -d. All date math runs in this zone.
• Theme colors — src/app/globals.css :root and .dark CSS variables.
• Schema changes — edit src/lib/schema.ts, then locally run npm run db:generate to produce a new SQL file in drizzle/. Commit it. The next deploy applies it.

Troubleshooting

• Stuck on the login screen (form reloads, no error) — you're accessing the app over HTTP (e.g. http://<unraid-ip>:3152) but SECURE_COOKIES=true. Browsers refuse Secure cookies on HTTP, so the session never sticks. Either leave SECURE_COOKIES unset (default), or set it to true only once you're using HTTPS via Cloudflare Tunnel.
• Red "Wrong password" on login — the typed value doesn't match APP_PASSWORD. Common causes: stray quotes around the value in the Unraid template (don't quote it), or accidental newline at the end. The app trims whitespace on both sides; quotes are not stripped.
• migrate fails on first start — check docker compose logs postgres for healthcheck failures. Confirm POSTGRES_PASSWORD matches between the two services (compose interpolates it from .env).
• Push doesn't fire — Settings page shows your subscription status. If permission: granted but no notifications, run the curl test command above and check docker compose logs app for VAPID errors.
• Cloudflare 1033 / no DNS — the tunnel's public hostname route in the CF dashboard must be saved before traffic flows. Run docker compose logs cloudflared and confirm "Registered tunnel connection".
• Cron not firing — docker compose logs ofelia shows registered jobs and per-run output. If you see cannot find container with label, the app container probably restarted with a different name; docker compose up -d ofelia will pick it back up.

Notes

• The PWA icon is currently an SVG; if you need PNGs for older platforms, place icons/icon-192.png and icons/icon-512.png in public/ and update manifest.json.
• iOS push requires the app to be installed to home screen (PWA mode). Once installed, it works the same as Android.
• The pg driver is used (not @neondatabase/serverless) so the same image works with both local Postgres and any standard hosted Postgres if you ever switch.