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 c31f8d8cfe Document local Cloudflare dev workflow and standardize local port 
Adds a reusable DEV_SETUP guide, prevents accidental secret commits with .dev.vars ignore, sets worker dev to port 3000 to avoid local tool conflicts, and includes a compatibility route for /logo-black.png.
2026-02-24 00:26:24 -07:00

1.6 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.