chore: standardize justfile commands across modules (#694)

- frontend: rename `dev` to `run` (keep `dev` as alias for compat)
- add `r` alias to backend and frontend (matches transcoder/moderation)
- add `just tunnel` command for ngrok
- update docs to reference `just frontend run`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

authored by zzstoatzz.io Claude Opus 4.5 and committed by GitHub b39cbd10 e2b53004

Changed files
+17 -8
backend
docs
frontend
+1 -1
AGENTS.md
··· 33 34 ## 💻 Development Commands 35 * **Backend:** `just backend run` 36 - * **Frontend:** `just frontend dev` 37 * **Tests:** `just backend test` (run from repo root, not from backend/) 38 * **Linting:** `just backend lint` (Python) / `just frontend check` (Svelte) 39 * **Migrations:** `just backend migrate "message"` (create), `just backend migrate-up` (apply)
··· 33 34 ## 💻 Development Commands 35 * **Backend:** `just backend run` 36 + * **Frontend:** `just frontend run` 37 * **Tests:** `just backend test` (run from repo root, not from backend/) 38 * **Linting:** `just backend lint` (Python) / `just frontend check` (Svelte) 39 * **Migrations:** `just backend migrate "message"` (create), `just backend migrate-up` (apply)
+1 -1
README.md
··· 52 just backend run 53 54 # run frontend (hot reloads at http://localhost:5173) 55 - just frontend dev 56 ``` 57 58 ### useful commands
··· 52 just backend run 53 54 # run frontend (hot reloads at http://localhost:5173) 55 + just frontend run 56 ``` 57 58 ### useful commands
+2
backend/justfile
··· 2 set shell := ["bash", "-eu", "-o", "pipefail", "-c"] 3 default := "run" 4 5 # run backend server (hot reloads) 6 run: 7 uv run uvicorn backend.main:app --reload --host 0.0.0.0 --port ${PORT:-8001}
··· 2 set shell := ["bash", "-eu", "-o", "pipefail", "-c"] 3 default := "run" 4 5 + alias r := run 6 + 7 # run backend server (hot reloads) 8 run: 9 uv run uvicorn backend.main:app --reload --host 0.0.0.0 --port ${PORT:-8001}
+1 -1
docs/README.md
··· 64 just backend run 65 66 # frontend 67 - just frontend dev 68 69 # run tests 70 just backend test
··· 64 just backend run 65 66 # frontend 67 + just frontend run 68 69 # run tests 70 just backend test
+1 -1
docs/deployment/environments.md
··· 22 DOCKET_URL=redis://localhost:6379 just backend run 23 24 # terminal 3: start frontend 25 - just frontend dev 26 27 # optional: start transcoder 28 just transcoder run
··· 22 DOCKET_URL=redis://localhost:6379 just backend run 23 24 # terminal 3: start frontend 25 + just frontend run 26 27 # optional: start transcoder 28 just transcoder run
+7 -4
frontend/justfile
··· 1 set shell := ["bash", "-eu", "-o", "pipefail", "-c"] 2 - default := "dev" 3 4 # run frontend dev server (hot reloads) 5 - dev: 6 - cd {{justfile_directory()}}/frontend && bun run dev --host 0.0.0.0 7 8 # check svelte types 9 check: 10 - cd {{justfile_directory()}}/frontend && bun run check
··· 1 set shell := ["bash", "-eu", "-o", "pipefail", "-c"] 2 + default := "run" 3 + 4 + alias r := run 5 + alias dev := run 6 7 # run frontend dev server (hot reloads) 8 + run: 9 + bun run dev --host 0.0.0.0 10 11 # check svelte types 12 check: 13 + bun run check
+4
justfile
··· 36 # stop dev services 37 dev-services-down: 38 docker compose down
··· 36 # stop dev services 37 dev-services-down: 38 docker compose down 39 + 40 + # expose backend via ngrok tunnel 41 + tunnel: 42 + ngrok http 8001 --domain tunnel.zzstoatzz.io