5.1 KiB
Village Politics: frontend
This is the Nuxt client for a browser strategy game in the style of Tribal Wars. It runs on the web first and may ship on Steam later, wrapped in Electron or Tauri. The backend, its architecture, and the roadmap live in ../game-village-politics-backend. Read ../game-village-politics-backend/docs/architecture.md before you add a feature.
Rules
- The client is a view. It sends intents over WS and renders what the server returns. It never computes costs, durations, combat, or loot. The only computation it does is projecting resources (
stored + rate × elapsed) and countdowns from server timestamps. It refetches when a countdown reaches zero or avillage:updatedpush arrives. ssr: falsefor every target, so one static build serves both the web and Steam. Code must not rely on Nuxt server routes or SSR-only APIs.- Transport is WS-first through the
wssingleton from@blax-software/networking, the same as learn-atc. HTTP is only for login and register, which return the bearer token. Load theblax-websocketsskill before you writews.sendorws.listencode. - Light Tailwind UI (Tailwind 4, theme and component classes like
.panel,.btninapp/assets/css/main.css) with simple hand-written inline SVG graphics (app/components/icon/, colours inapp/utils/palette.ts). No paid, hosted or licensed assets: no icon packs, web fonts or images from outside the repo. - The village is an isometric low-poly diorama (
app/components/village/Diorama.vue, geometry inapp/diorama/), drawn as inline SVG, no WebGL. There are no tiles or positions: the server only sends each building'sspaceand the village'sspace.used/max, and the client lays the buildings out deterministically (headquarters in the centre, the rest in id order around it). Each type has a model per level tier (0, 1–4, 5–14, 15+); the wall is the ring around the plateau. Buildings are focusable buttons that open their details card. Keep components small and typed, with state in composables (useVillage,useWorld). - All user-facing text goes through i18n keys, with
enas the first locale. Sources arei18n/locales/andi18n/pages/(@blax-software/i18nlayout); register a new page file ini18n/messageloader.ts.
Mock server
The client talks to the real backend by default (server-village.localhost.at locally; the server's .env points the static build at server-village.blax.at). For UI work without a backend, NUXT_PUBLIC_MOCK_SERVER=true swaps the ws singleton and login for app/mock/: an in-browser fake that answers the same intents with the payloads in app/types/game.ts, finishes build orders on timers, and pushes village:updated. Its numbers and rules are placeholders, not game design; the backend is the source of truth. Delete app/mock/ once nothing needs it.
Every ws.send carries the bearer token as authtoken (added in app/utils/networking.ts): that is how the WS server authenticates a socket.
Task tracking: Taiga board village-politics
Every deliverable has a card on the Taiga board village-politics (one epic per roadmap milestone). Follow the loop in the taiga skill: search before you create, move the card to In progress when you start, and run done when it is implemented.
Commands
pnpm install
pnpm dev # https://village.localhost.at
pnpm typecheck
pnpm i18n:check # fails on missing keys
pnpm generate # static build for web and Steam
Finishing a change
Every change ends live, right away: the user wants each change on the URL as soon as it is done, not batched. The user has authorized this for this project: deploying the game's containers on edgerealm needs no further go-ahead.
pnpm typecheckandpnpm i18n:checkpass, and the change works in the preview.- Commit (small, one concern each) and push to
origin master. - Run
scripts/deploy-edgerealm.sh. Done when it printsLive: https://village.blax.at at <commit>. - Name the live commit in the reply. When the change needs a new backend contract, deploy the backend first.
The authorization covers only /mnt/HC_Volume_102040804/srv/game-village-politics-frontend, /mnt/HC_Volume_102040804/srv/game-village-politics-backend and their containers. Everything else on edgerealm (a host shared with customer sites) still needs the user's go-ahead.
Deploy
The game runs on https://village.blax.at (edgerealm, /mnt/HC_Volume_102040804/srv/game-village-politics-frontend, container village-politics-frontend). It is the logigate setup with a static twist: a one-shot build container runs pnpm generate into .output/public, and nginx serves it with an SPA fallback (docker/nginx.conf). Build-time settings come from .env on the server, created from .env.example on the first deploy.
Commit and push to origin master, then run scripts/deploy-edgerealm.sh. It is done when it prints Live: https://village.blax.at at <commit>. On Windows, run it as PATH="/c/Windows/System32/OpenSSH:$PATH" scripts/deploy-edgerealm.sh.
Commits
Make small commits, one concern each, with prefixes like feat:, fix:, test:, docs:, chore:.