election-game/web/README.md

1.3 KiB
Raw Permalink Blame History

選舉小鎮 — 前端

前端只依賴 @election2026/protocol(後端程式庫中的協定套件),不含任何遊戲規則,所有結算都在後端。整體架構見 ../backend/docs/README.md。

畫面(hash 路由,src/App.tsx):首頁與選戰卡牌(#/、#/rogue/<局>)、政治生涯、圖鑑與成就、捏人物、服裝店、政策島、小遊戲、任期試玩、歷屆參選人, 以及開發用的資料檢視器(#/viewer)、美術總覽(#/art、#/faces)、頭像部件檢查(#/avatar-check)。

開發時要先啟動後端 API(pnpm --filter @election2026/server start,見後端 README);/api 由 Vite 轉給 127.0.0.1:8787。 開發用的頁面(#/viewer、#/art、#/faces、#/avatar-check)只有 pnpm dev 打得開,正式版不打包。

正式玩(第一次連線快很多):pnpm start=建置後用 vite preview 在 5173 提供,/api 一樣轉給後端。

開發

pnpm install
pnpm sync-fixtures        # 從 ../backend/data/build/packs 複製資料包到 public/fixtures(需先在後端產生)
pnpm dev

讀取資料時會用協定的 Zod 定義驗證;格式和協定不符會直接顯示錯誤。

檢查

pnpm test
pnpm typecheck
pnpm build

設計 token(顏色、字型)集中在 src/theme/tokens.css。