Jambo2

Digital implementation of Jambo with a pure TypeScript game engine, React UI, and AI opponents.

Quick Start

npm install
npm run dev

Useful commands:

npm run dev
npx tsc --noEmit
npx vite build
npm test

Google OAuth + MongoDB Setup

The multiplayer/auth server now serves both WebSocket and HTTP auth endpoints on port 3001.

1. Copy .env.example to .env and set:
   • MONGODB_URI (Atlas connection string)
   • GOOGLE_CLIENT_ID
   • GOOGLE_CLIENT_SECRET
2. In Google Cloud Console, add OAuth redirect URI:
   • http://localhost:5173/api/auth/google/callback
3. Start app + server:

npm run dev
npm run server

Auth endpoints used by UI:

• GET /api/auth/google/start
• GET /api/auth/google/callback
• GET /api/auth/session
• POST /api/auth/logout

Tech Stack

• React 19 + TypeScript + Vite
• Zustand state management
• Zod validation
• Tailwind CSS
• Vitest test runner

Project Structure

• src/engine/ — pure game engine and resolver pipeline
• src/ai/ — AI policies and simulation support
• src/ui/ — React components and interaction panels
• src/hooks/ — Zustand integration
• src/persistence/ — serialization and save/load
• tests/ — engine, AI, UI, and multiplayer tests

Documentation

Canonical docs live in docs/INDEX.md.

Primary references:

• Rules and cards: docs/CARD_REFERENCE.md
• Product requirements: docs/PRODUCT_REQUIREMENTS.md
• Architecture: docs/ARCHITECTURE.md
• Documentation policy: docs/DOCS_POLICY.md

Legacy/superseded docs are retained under docs/archive/ for historical context only.

Docs Changelog

• 2026-02-15: Established canonical documentation set in docs/INDEX.md.
• 2026-02-15: Consolidated active docs and moved superseded material to docs/archive/.
• 2026-02-15: Added documentation governance rules in docs/DOCS_POLICY.md.