Files
Wizard/wizard_website/README.md
T
marvinandClaude Opus 5.5 90176e1cca Serve API and website behind Caddy path prefixes
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>
2026-09-27 10:00:29 +02:00

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 the useWizard hook (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 lobby
  • src/screens/LobbyScreen — lobby code, players, AI players, rule options, start
  • src/screens/GameScreen — the table: seats, trick, hand, bidding, trump choice, scoreboard, round summary, game over