Ilia Denisov
8565942392
Serve the whole stack behind one host: site at /, game UI at /game/, gateway REST at /api + /healthz, Connect at /rpc (prefix stripped by the edge Caddy). The built artifact is domain-agnostic — the UI talks to the gateway same-origin via relative URLs, so the same bundle runs under any host with no rebuild and with CORS disabled. - Rename the Connect proto service galaxy.gateway.v1.EdgeGateway -> edge.v1.Gateway; regenerate Go + TS; public path /rpc/edge.v1.Gateway. - Move the game UI under base path /game (env BASE_PATH); make the manifest, service-worker scope, WASM loader, and all navigation base-aware via a withBase helper. - Relative API + /rpc Connect prefix; Vite dev proxy mirrors the strip. - Rewrite the edge Caddy (dev + prod) for path-based routing; empty CORS allow-lists (same-origin); single host. - New VitePress project site (site/): i18n en/ru with switcher, LaTeX math, minimal monospace theme; built and served at /. - dev-deploy compose/Makefile + CI (dev-deploy, prod-build, new site-build) build and seed the site; probes hit /, /game/, /healthz. - Sync docs (ARCHITECTURE, gateway README/openapi, dev-deploy & local-dev READMEs, CLAUDE.md, ui/PLAN). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
37 lines
1.3 KiB
Markdown
37 lines
1.3 KiB
Markdown
# Galaxy project site
|
|
|
|
The public project site — an overview today, documentation as it grows.
|
|
Built with [VitePress](https://vitepress.dev) and served as static files
|
|
at the **root** (`/`) of the single-origin deployment; the game UI lives
|
|
under `/game/` (see `tools/dev-deploy/Caddyfile.dev`).
|
|
|
|
## Layout
|
|
|
|
- `index.md`, `ru/index.md` — per-locale home pages.
|
|
- `.vitepress/config.ts` — site config: locales (English + Russian, with
|
|
the built-in language switcher), LaTeX math (`math: true`), and the
|
|
two-column navigation (left sidebar = chapters, right outline =
|
|
on-this-page).
|
|
- `.vitepress/theme/` — the default theme without bundled fonts, plus a
|
|
minimal monospace type stack in `custom.css`.
|
|
|
|
## Authoring
|
|
|
|
- Add a page as Markdown and register it in the `sidebar` of each locale
|
|
in `.vitepress/config.ts`.
|
|
- Localised content mirrors the English tree under `ru/`.
|
|
- Math uses LaTeX: inline `$E = mc^2$`, block `$$ … $$`.
|
|
- Link to the game with the root-relative `/game/` path so the build
|
|
stays domain-agnostic (no hard-coded host).
|
|
|
|
## Commands
|
|
|
|
pnpm install
|
|
pnpm dev # local dev server
|
|
pnpm build # static build into .vitepress/dist
|
|
pnpm preview # preview the build
|
|
|
|
The dev and prod deploys build the site via
|
|
`make -C tools/dev-deploy seed-site` and the `dev-deploy` /
|
|
`prod-build` workflows.
|