feat(deploy): single-origin path-based deployment + project site
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>
This commit is contained in:
@@ -0,0 +1,3 @@
|
||||
node_modules/
|
||||
.vitepress/dist/
|
||||
.vitepress/cache/
|
||||
@@ -0,0 +1,55 @@
|
||||
import { defineConfig } from "vitepress";
|
||||
|
||||
// Galaxy project site. The single-origin deployment serves this static
|
||||
// build at the root (`/`); the game UI lives under `/game/`. The site is
|
||||
// Markdown-first with the default theme's two-column navigation (left:
|
||||
// chapters; right: on-this-page), LaTeX math, and a minimal monospace
|
||||
// theme. Internationalisation uses VitePress `locales`, which renders the
|
||||
// built-in language switcher in the nav bar.
|
||||
export default defineConfig({
|
||||
title: "Galaxy",
|
||||
description: "Galaxy — a turn-based space strategy game.",
|
||||
cleanUrls: true,
|
||||
// READMEs (this dir's and any future per-section ones) are developer
|
||||
// docs, not site pages.
|
||||
srcExclude: ["**/README.md"],
|
||||
// The game UI is served from `/game/` by the edge Caddy, not by
|
||||
// VitePress, so its links must skip the dead-link checker.
|
||||
ignoreDeadLinks: [/^\/game\//],
|
||||
markdown: {
|
||||
// LaTeX via markdown-it-mathjax3: inline `$…$`, block `$$…$$`.
|
||||
math: true,
|
||||
},
|
||||
themeConfig: {
|
||||
outline: { level: [2, 3], label: "On this page" },
|
||||
},
|
||||
locales: {
|
||||
root: {
|
||||
label: "English",
|
||||
lang: "en",
|
||||
themeConfig: {
|
||||
nav: [{ text: "Play", link: "/game/" }],
|
||||
sidebar: [
|
||||
{
|
||||
text: "Galaxy",
|
||||
items: [{ text: "Overview", link: "/" }],
|
||||
},
|
||||
],
|
||||
},
|
||||
},
|
||||
ru: {
|
||||
label: "Русский",
|
||||
lang: "ru",
|
||||
link: "/ru/",
|
||||
themeConfig: {
|
||||
nav: [{ text: "Играть", link: "/game/" }],
|
||||
sidebar: [
|
||||
{
|
||||
text: "Galaxy",
|
||||
items: [{ text: "Обзор", link: "/ru/" }],
|
||||
},
|
||||
],
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
@@ -0,0 +1,10 @@
|
||||
/*
|
||||
* Minimal, restrained theme. No flashy hero or bright accents — the
|
||||
* project site leans "nerdy" with a fixed-width type stack. System
|
||||
* fonts first so nothing is downloaded.
|
||||
*/
|
||||
:root {
|
||||
--vp-font-family-base: ui-monospace, "JetBrains Mono", "SF Mono",
|
||||
"Fira Code", "DejaVu Sans Mono", Menlo, Consolas, monospace;
|
||||
--vp-font-family-mono: var(--vp-font-family-base);
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
// Minimal theme: the default VitePress theme without its bundled Inter
|
||||
// font, plus a monospace type stack for the project's "nerdy" look.
|
||||
import DefaultTheme from "vitepress/theme-without-fonts";
|
||||
import "./custom.css";
|
||||
|
||||
export default DefaultTheme;
|
||||
@@ -0,0 +1,36 @@
|
||||
# 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.
|
||||
@@ -0,0 +1,5 @@
|
||||
# Galaxy
|
||||
|
||||
A turn-based space strategy game.
|
||||
|
||||
[Play the game →](/game/)
|
||||
@@ -0,0 +1,16 @@
|
||||
{
|
||||
"name": "galaxy-site",
|
||||
"version": "0.0.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"description": "Galaxy project site — overview and documentation (VitePress).",
|
||||
"scripts": {
|
||||
"dev": "vitepress dev",
|
||||
"build": "vitepress build",
|
||||
"preview": "vitepress preview"
|
||||
},
|
||||
"devDependencies": {
|
||||
"markdown-it-mathjax3": "^5.2.0",
|
||||
"vitepress": "^1.6.4"
|
||||
}
|
||||
}
|
||||
Generated
+1736
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,2 @@
|
||||
allowBuilds:
|
||||
esbuild: true
|
||||
@@ -0,0 +1,5 @@
|
||||
# Galaxy
|
||||
|
||||
Пошаговая космическая стратегия.
|
||||
|
||||
[Играть →](/game/)
|
||||
Reference in New Issue
Block a user