Local services & ports

Backend API (apps/backend-api)

• Stack: Go with Gin.
• Default listen port: not finalized yet. Do not treat any hard-coded API port in older README snippets or tooling labels as the permanent contract.
• When you run bun run dev or cd apps/backend-api && bun run dev, check the process output (and any .env in that package) for the port currently in use.
• Docker Compose currently publishes a host range that maps into the container’s internal listen port for development; that mapping may change as the default port is finalized.

Frontend app (apps/frontend-app)

Item	Value
Framework	Astro
Typical local URL	http://localhost:4321
Dev script	astro dev --host

Marketing website (apps/website-vexil)

Item	Value
Framework	Astro + Tailwind
Expected local port (Devcontainer / Compose)	4322 when that port is free
Note	The package dev script uses Astro’s default port unless overridden; Compose maps the website service toward host 4322+.

Dev Docs (docs/dev)

Item	Value
Local	bun run dev from docs/dev (Astro default, often 4321 if nothing else is bound)
Production	https://dev-docs.vexil.tools

Docker Compose overview

From the repository root:

docker compose up --build -d
docker compose down

Services defined in docker-compose.yml:

Service	Package	Host port mapping (ranges)
backend-api	apps/backend-api	Dynamic range into the API container
frontend-app	apps/frontend-app	4321–4399 → container 4321
website	apps/website-vexil	4322–4399 → container 4321

Ranges avoid collisions when a preferred host port is already taken. Inspect docker compose ps for the actual published ports.

Env init TUI

uv run --directory dev-tools/env-init main.py

Use this to scaffold local config and manage Compose. Some TUI actions may still reflect older backend assumptions — prefer this handbook and the current apps/backend-api code when something looks stale.