This project is a real-time 2-players game built with React, Socket.IO, and Node.js, as part of the Wooclap technical assessment.

Players join from separate tabs/devices, pick one of the 5 actions, and receive synchronized results in real-time using WebSockets.

• Real-time multiplayer with Socket.IO
• Waiting screen until both players are connected
• Choice of 5 actions: Rock, Paper, Scissors, Lizard, Spock
• Waiting state when one player chooses
• Synchronized result screen when both have picked
• “New round” resets the game for both players
• Custom React hook (useGameSocket) handling all logic
• Unit-tested using React Testing Library + Jest

wooclap-fullstack/
├── backend/
│   ├── index.js               # Express + Socket.IO server
│   └── package.json           # Backend dependencies
│
├── frontend/
│   ├── public/
│   ├── src/
│   │   ├── components/
│   │   │   ├── ActionSelection.js
│   │   │   ├── ResultScreen.js
│   │   │   └── WaitingRoom.js
│   │   ├── hooks/
│   │   │   └── useGameSocket.js
│   │   ├── App.js
│   │   ├── index.js
│   │   └── socket.js
│   └── package.json           # Frontend dependencies
│
├── package.json               # Root: defines workspaces + shared scripts
├── README.md                 
└── .gitignore

This is a monorepo using plain npm workspaces All you need is Node ≥ 18 and npm ≥ 9.

git clone https://github.com/ClaraChaouat/wooclap-2.git

cd wooclap-2

npm install

npm run install:all

npm run dev

Run Socket.IO server on http://localhost:3001 Run frontend using React (CRA) on http://localhost:3000.

npm test

To start playing, open two http://localhost:3000 windows.