Dou Dizhu - Monorepo

This is a Monorepo project for the Dou Dizhu (斗地主 / Fight the Landlord) card game, structured for frontend/backend separation.

doudizhu/
├── frontend/          # React + TypeScript frontend
│   ├── src/          # Source code
│   ├── public/       # Static assets
│   └── ...           # Config files
├── backend/          # Future backend (Node.js/Express)
├── docs/             # Technical documentation
├── task.md           # Project task tracking
└── README.md         # This file

cd frontend
npm install    # First time only
npm run dev    # Start dev server

The frontend will be available at http://localhost:5173

cd backend
npm install
npm run start:dev

See backend/README.md for detailed setup and API documentation.

• Frontend Guide: frontend/README.md
• Backend Guide: backend/README.md
• Architecture: docs/README.md
  • Phase 11: State Machine
  • Phase 15: Backend Engine

• React 19, TypeScript, Vite
• Tailwind CSS, Framer Motion

• NestJS (Node.js)
• Socket.io (WebSocket)
• Redis (State Persistence)
• MySQL (User Data)

See task.md for detailed task breakdown and progress tracking.

cd frontend
npm test        # Run all tests
npm run test:ui # Open Vitest UI

cd frontend
npm run build   # Production build

MIT License - See LICENSE for details