Pinewood One Monorepo

This repository consolidates the backend and frontend application histories.

Branches

Important

main is not production. It is the default branch, so it is the one you land on by cloning and the one pull requests target by default — but merging into it deploys nothing.

• main — default branch and integration trunk. Reviewed work merges here first.
• prod — the production branch. What is on prod is what is live. Releases happen by promoting main into prod, never by pushing to prod directly.

If you are checking what users are actually running, read prod, not main.

Local Commands

• make setup runs the interactive onboarding wizard.
• make init installs backend and frontend dependencies, seeds missing local env defaults such as FLASK_SECRET_KEY and ENCRYPTION_KEY, and on macOS bootstraps Homebrew plus python@3.12, node, and pnpm when they are missing.
• make doctor checks whether local setup is healthy.
• make secret-export prints a paste-ready env block containing the current shared secrets from backend/.env and frontend/.env.local.
• make dev starts the frontend, the backend, and the scraper together. State is stored in SQLite and the frontend receives live updates over the SSE events channel at /api/events.
• make dev-frontend and make dev-backend start one service at a time.