docs: the village is a client-laid-out SVG diorama

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Fabian @ Blax Software 2026-10-28 19:54:20 +01:00
parent 3ab9156664
commit c7322c51db
1 changed files with 2 additions and 1 deletions

View File

@ -7,7 +7,8 @@ This is the Nuxt client for a browser strategy game in the style of Tribal Wars.
- **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 a `village:updated` push arrives.
- **`ssr: false` for 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 `ws` singleton from `@blax-software/networking`, the same as learn-atc. HTTP is only for login and register, which return the bearer token. Load the `blax-websockets` skill before you write `ws.send` or `ws.listen` code.
- **Light Tailwind UI** (Tailwind 4, theme and component classes like `.panel`, `.btn` in `app/assets/css/main.css`) with simple hand-written inline SVG graphics (`app/components/icon/`, colours in `app/utils/palette.ts`). No paid, hosted or licensed assets: no icon packs, web fonts or images from outside the repo. Sprites per building level and drag-to-place stay in M7 (city view). Keep components small and typed, with state in composables (`useVillage`, `useWorld`).
- **Light Tailwind UI** (Tailwind 4, theme and component classes like `.panel`, `.btn` in `app/assets/css/main.css`) with simple hand-written inline SVG graphics (`app/components/icon/`, colours in `app/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 in `app/diorama/`), drawn as inline SVG, no WebGL. There are no tiles or positions: the server only sends each building's `space` and the village's `space.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 `en` as the first locale. Sources are `i18n/locales/` and `i18n/pages/` (`@blax-software/i18n` layout); register a new page file in `i18n/messageloader.ts`.
## Mock server