Skip to content

i250882-os/among-us

Folders and files

NameName
Last commit message
Last commit date

Latest commit

066e5c8 · · Feb 8, 2026

History

38 Commits
Feb 8, 2026
Feb 8, 2026
Jan 30, 2026
Jan 22, 2026
Feb 8, 2026
Jan 9, 2026
Feb 1, 2026

Repository files navigation

Among Us


A multiplayer web based clone of game among us built with Phaser 3, React, and Node.js.

Live Demo: https://among-us-mocha.vercel.app

Project Structure


among-us/
├── frontend/                 # React + Phaser 3 frontend application
│   ├── src/                  # React components and game code
│   │   ├── game/             # Phaser 3 game logic
│   │   ├── components/       # React components
│   │   ├── assets/           # Game assets
│   │   └── main.tsx          # Frontend entry point
│   ├── vite/                 # Vite configuration files
│   ├── package.json          # Frontend dependencies
│   ├── tailwind.config.cjs   # Tailwind CSS configuration
│   ├── postcss.config.cjs    # PostCSS configuration
│   ├── .eslintrc.cjs         # ESLint configuration
│   └── index.html            # HTML entry point
├── backend/                  # Node.js + Express backend server
│   ├── src/                  # Backend source code
│   ├── package.json          # Backend dependencies
│   └── tsconfig.json         # TypeScript configuration
└── misc/                     # Miscellaneous files
cellaneous files

Important Files


Frontend

/frontend/src/pages/Menu.jsx
Manages the initial player registeration and room select events.

/frontend/src/App.jsx
Manages the Game UI components visibility.

frontend/src/game/Game.js
Main phaser file, manages the whole game logic and connection with backend

Backend

/backend/src/events/
Contains files to manage the entire socket.io events

backend/src/managers
Contains files to manage the game state, like player updates and game room updates

Technology Stack


Frontend

  • React 19.0.0 - UI library
  • Phaser 3.90.0 - Game framework
  • Vite 6.3.1 - Build tool
  • Tailwind CSS 4.1.18 - Styling
  • Socket.io Client 4.8.3 - Real-time communication

Backend

  • Node.js - JavaScript runtime
  • Express 5.2.1 - Web framework
  • Socket.io 4.8.3 - Real-time communication

Features


  • Real-time multiplayer gameplay
  • Multiplayer room management
  • Socket.io for live player communication
  • React for UI components like meeting screens

Getting Started

Prerequisites


  • Node.js (v16 or higher)
  • npm or yarn

Installation


  1. Clone the repository:
git clone https://github.com/i250882-os/among-us.git

cd among-us
  1. Install frontend dependencies:
cd frontend
npm install

cd ..
  1. Install backend dependencies:
cd backend
npm install

cd ..

Development


Frontend Development

cd frontend
npm run devv

This starts the Vite development server with hot module replacement.

Backend Development

cd backend
npm run devv

This starts the Express and Socket server

Production Build

Frontend:

cd frontend
npm run buildd

Backend:

cd backend
npm startt

Configuration


Frontend Environment Variables

The frontend uses environment variables defined in .env:

VITE_HOST=192.168.1.10
VITE_BACKEND_PROTOCOL=http

You can override with full URLs:

VITE_BACKEND_URL=http://192.168.1.10:3001
VITE_SOCKET_URL=http://192.168.1.10:3000

Backend Environment Variables

ALLOWED_ORIGIN=192.168.1.10

TODO


  • Improve lobby area UX
  • Add tasks system
  • Fix voting system bugs

License


This project is licensed under the MIT License - see the LICENSE file for details.