A modernized HTML5/JavaScript multiplayer game experiment, rebuilt with a bleeding-edge tech stack.

• Modern Monorepo: npm workspaces with @bq/client, @bq/server, @bq/shared
• Real-time Multiplayer: WebSocket-based networking with ws
• Type-Safe: End-to-end TypeScript with shared types
• Docker Ready: Multi-stage Dockerfiles with docker-compose orchestration
• CI/CD: GitHub Actions for lint, test, and build

• Node.js >= 22.0.0
• npm >= 10

# Install dependencies
npm install

# Start all services in development mode
npm run dev

# Or start individually
npm run dev --workspace @bq/client
npm run dev --workspace @bq/server

# Build and run all services
docker-compose up --build

# Access:
# - Client: http://localhost:8080
# - Server: ws://localhost:8000

browserquest-monorepo/
├── apps/
│   ├── client/          # React 19 + Vite 6 game client
│   │   ├── src/
│   │   │   ├── components/  # React UI (HUD, Login, Chat)
│   │   │   └── game/        # Canvas game engine
│   │   └── public/          # Static assets (sprites, audio)
│   └── server/          # Node.js WebSocket server
│       ├── src/
│       │   ├── entities/    # Game entities (Mob, Npc, Character)
│       │   ├── WorldServer.ts
│       │   └── player.ts
│       └── test/            # Vitest tests
├── packages/
│   └── shared/          # Shared types, utils, constants
└── legacy/              # Original BrowserQuest code (reference)

# Run all tests
npm run test

# Run server tests only
npm run test --workspace @bq/server

Test Coverage:

• Unit tests for Player, WorldServer, Utils
• Integration tests for Game Loop (HELLO/WELCOME/MOVE handshake)

• Code: MPL 2.0
• Content: CC-BY-SA 3.0

Original game created by Little Workshop:

• Franck Lecollinet - @whatthefranck
• Guillaume Lecollinet - @glecollinet

Modernization by the community.