···40404141## Common commands (run from repo root unless noted)
4242- **Format check**: `pnpm exec prettier --check .`
4343-- **Lint**: `pnpm exec turbo run lint` (or `--filter <package>` to narrow). Frontpage package also supports `pnpm --filter frontpage run lint`.
4444-- **Tests**: `pnpm exec turbo run test` (Vitest). Per-package: `pnpm --filter frontpage run test`, etc.
4545-- **Type-check**: `pnpm exec turbo run type-check` or `pnpm --filter frontpage run type-check`.
4646-- **Build**:
4747- - Frontpage app: `pnpm --filter frontpage run build` (Turbopack; uses `NODE_OPTIONS=--use-openssl-ca` in script).
4848- - atproto-browser/unravel: `pnpm --filter <pkg> run build`.
4949- - Frontpage ATProto client: `pnpm --filter @repo/frontpage-atproto-client run build` (tsc).
4343+- **Lint**: `pnpm exec turbo run lint` (or `--filter <package>` to narrow).
4444+- **Tests**: `pnpm exec turbo run test` (or `--filter <package>` to narrow)
4545+- **Type-check**: `pnpm exec turbo run type-check` (or `--filter <package>` to narrow)
4646+- **Build**: `pnpm exec turbo run build` (or `--filter <package>` to narrow)
5047- **Dev servers**:
5151- - Frontpage app: `pnpm --filter frontpage exec turbo dev` (or `pnpm --filter frontpage run dev`). For production DB access, team uses `dev-1pw` which relies on 1Password CLI and `.env.1pw`.
4848+ - Frontpage app: `pnpm exec turbo dev --filter frontpage`. For production DB access, team uses `dev-1pw` which relies on 1Password CLI and `.env.1pw`.
5249 - atproto-browser/unravel: `pnpm --filter <pkg> run dev`.
5350- **DB / Drizzle (frontpage)**: run inside `packages/frontpage`: `pnpm db:generate`, `pnpm db:migrate`, `pnpm db:push`, `pnpm db:studio`, `pnpm db:pull`. Scripts set `NODE_OPTIONS=--use-openssl-ca`.
5451- **Lexicon tooling**: From root, install Go `glot` (see workflow) then `glot lint lexicons/fyi/frontpage` / `glot compat lexicons/fyi/frontpage` when touching lexicons.
···5855- Follow `packages/frontpage/local-infra/README.md`:
5956 - `docker-compose up` to run PLC, PDS, Jetstream, Drainpipe, Turso, Caddy, cloudflared tunnel.
6057 - Install Unravel CA (`frontpage-local-infra_caddy_data/pki/authorities/unravel/root.crt`) and set `NODE_OPTIONS=--use-openssl-ca` for Node apps (frontpage scripts already set this).
6161- - Generate `.env.local` via `pnpm --filter=frontpage run generate-local-env`, run `pnpm db:migrate`, start app with `pnpm --filter frontpage exec turbo dev` (or `pnpm --filter frontpage run dev`) from the repo root, grab cloudflared tunnel URL for access.
5858+ - Generate `.env.local` via `pnpm --filter=frontpage run generate-local-env`, run `pnpm db:migrate`, start app with `pnpm exec turbo dev --filter frontpage` from the repo root, grab cloudflared tunnel URL for access.
6259 - Troubleshooting steps for docker platforms, SSL renewal, Cloudflare 502, Windows WSL reset are in the README.
63606461## Notes / tips