Benjamin and Charlotte

Sept. 2025 Cohort Submission

Online Multiplayer code guessing game.

---

Demo: https://bnc-client-psi.vercel.app

Game logic: https://github.com/jwc20/bncpy

Docs: https://jwc20.github.io/bnc-docs/

Mono-repo: https://github.com/jwc20/bnc-game

FE: https://github.com/jwc20/bnc-client

BE: https://github.com/jwc20/bncapi

            ________________________________________
           / Try the demo at:                       \
           \   https://bnc-client-psi.vercel.app !  /
            ----------------------------------------
                       \              /
                        \            /
                       ^__^        ^__^
             _________/(oo)        (oo)\_________
         \/\(   Ben   /(__) 	   (__)\  Char   )\/\
            ||------||                 ||-----w |
            ||      ||                 ||      ||

---

Play

1. Login or signup
2. Join or create a room
3. Play the game by inputting numbers inside the code input

Game Mode

1. Co-op: guess the code with other players
2. Battle: race with other players to win

Co-op Mode:

Battle Mode:

---

Installation

Clone this repo and run:

git submodule update --init --recursive

Here are two ways to start the project:

Option 1: With startup script Run the provided startup script to initialize and launch the project automatically. If you were to make changes to code while using Option 1, you need to restart the docker containers for the changes to take effect. Therefore Option 2 should be used in development.

Option 2: Manual start Start the project manually without using the startup script.

---

Option 1

# start deployment in local
chmod +x deploy.sh
./deploy.sh

# setup and migrate postgres database
./bncapi/setup_dev_db.sh

# stop deployment
chmod +x shutdown.sh
./shutdown.sh

---

Option 2

Start frontend

Open a terminal and run:

cd bnc-client

yarn install
yarn dev

Start backend

Open another terminal and run:

cd bncapi
# start .venv
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

Start Postgres

docker pull postgres:17-alpine

Start Redis

docker pull redis:7.2.7-alpine