Caddy forwards /wizard/api/* and /wizard/website/* with the prefix stripped, so the server received /ws instead of /api/ws and the website connected to /api/ws on the domain root. - Server routes are now /ws and /health (was /api/ws, /api/health) - Website derives the websocket URL from its own location (../api/ws), giving /wizard/api/ws in production and /api/ws in development - Vite dev proxy strips /api like the production proxy - nginx back to the plain SPA config since Caddy strips the prefix - /internal/ai rejects requests that came through the reverse proxy, in addition to the shared secret - Docs updated for the prefixed deployment Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.1 KiB
1.1 KiB
wizard_website
React + TypeScript frontend (Vite). All component styles are CSS modules
(*.module.css); the design tokens live on the .app root in
src/App.module.css.
npm install
npm run dev # http://localhost:5173, proxies /api/* (incl. websocket) to localhost:8000 without the /api prefix
npm run build
npm run lint
The app is built with relative asset paths and connects to ../api/ws relative to its own URL
(/wizard/website/ → /wizard/api/ws). Set WIZARD_SERVER_URL to proxy to another server in
development, or VITE_WS_URL at build time to use an absolute websocket URL instead.
Structure
src/api/— protocol types and theuseWizardhook (websocket connection, reconnect with a per-tab session token, game state)src/components/— reusable UI (button, playing card, modal, toasts)src/screens/HomeScreen— enter a name, create or join a lobbysrc/screens/LobbyScreen— lobby code, players, AI players, rule options, startsrc/screens/GameScreen— the table: seats, trick, hand, bidding, trump choice, scoreboard, round summary, game over