averyfelts/Stop_smoking_website_ver2
1
2
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Stop_smoking_website_ver2/DEV_SETUP.md
Avery Felts e5b3f649be changes
2026-02-24 02:03:27 -07:00

3.4 KiB
Raw Blame History

Dev Setup Notes (Local)

This file captures the local development setup used in this session so future work can resume quickly.

Project Location

  • Main working copy: /Users/averyfelts/Desktop/DevSmokeWebsite
  • Old typo folder exists but unused: /Users/averyfelts/Desktop/DevSmokWebsite

Runtime Choice

  • Use Cloudflare Worker dev flow (not plain next dev) for D1-backed features.
  • Dev server is pinned to port 3000 to avoid conflicts with Signet tooling.

Commands

From /Users/averyfelts/Desktop/DevSmokeWebsite:

bun install
bun run d1:migrate
bun run build:worker
bun run dev:worker

Expected URL:

  • http://localhost:3000

Key Local Changes Made

  1. package.json
  • Updated script:
    • dev:worker from wrangler dev to wrangler dev --port 3000
  1. .gitignore
  • Added .dev.vars so local worker env secrets are not tracked.
  1. src/app/logo-black.png/route.ts
  • Added compatibility route to stop GET /logo-black.png 404.
  • Route redirects /logo-black.png to /icons/icon-192.png.

Env File Notes

  • Local app env file: .env.local
  • Local wrangler env file: .dev.vars
  • Both are intended for local development.
  • Keep secrets out of git.

Cloudflare/D1

  • Wrangler auth verified for this machine.
  • Local D1 migrations were applied via bun run d1:migrate.

Known Warnings

  • Wrangler/OpenNext may print duplicate object key warnings from generated .open-next output.
  • These warnings did not block startup in this session.

Session Preferences to Preserve

  • Keep file reads tightly scoped to explicit paths when requested.
  • Avoid broad folder crawling unless asked.

Latest Session Changes

Product and UX

  • Reworked mobile dashboard into dedicated swipe pages:
    • Mood (+ Daily Inspiration)
    • Quit Journey Plan
    • Usage Stats
    • Health Recovery
    • Achievements
    • Savings
    • Usage Calendar
  • Removed mobile side arrow buttons; swipe + dots are now primary navigation.
  • Moved floating Log Usage button above the mobile swipe indicator and centered it on mobile.
  • Updated profile menu to top-right and moved quick actions (notifications/install/theme) into menu.
  • Expanded Quit Journey Plan sections (no dropdown collapse), showing both nicotine and weed plans.
  • Replaced old theme token set with updated light/dark OKLCH theme variables in src/app/globals.css.

Reliability and Auth

  • Added explicit dashboard/substance data load error handling and retry surface.
  • Fixed hourly reminders edge cases for overnight windows.
  • Added reminder API input validation for time/frequency values.
  • Implemented real password reset initiation via WorkOS endpoint and UI wiring in login/settings.

Achievements

  • Added inline unlock guidance text under each achievement tile.
  • Added completed/locked status treatment directly in the tile.
  • Added unlock safeguards to avoid duplicate global first_day unlock behavior:
    • first_day now normalizes to substance: both
    • dedupe normalization in achievements API GET
    • API validation for badge/substance input
    • INSERT OR IGNORE safety in D1 write path

Validation Commands Used

bun run build
bun run build:worker
bun run dev:worker

Quick Troubleshooting

  • If UI changes do not appear in worker mode:

    1. bun run build:worker
    2. bun run dev:worker
    3. hard refresh browser (Cmd + Shift + R)

  • If mobile swipe feels off:

    • swipe behavior is controlled in src/app/globals.css under .swipe-container and .swipe-item.