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

27 lines
1.1 KiB
Markdown

# 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`.
```bash
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