UltiMafia

This is the source code powering UltiMafia.com, a website built to provide online chat mafia to all.

Contributing

1. Fork the repository
2. Make your changes to your forked repository
3. Open a pull request on the master branch of this repository
4. Perform a final test on the main site after merge into master

Running the site on codespaces

If you are a beginner, please follow the easy setup guide and ask in Discord if you are stuck at any step.

Running the site locally

-OBSOLETE- This is for running your own development environment locally. You can still use this if you'd like by following the old beginner's guide, but the easiest way is now the docker guide linked above.

Prerequisites

1. Install node.js, and set the version to v14.16.0.

2. Install MongoDB and Redis and run them as services. You can refer to this guide for setting up MongoDB and Redis via Docker.

3. Clone your forked repository. Replace "UltiMafia" with your github username.

git clone https://github.com/UltiMafia/Ultimafia.git

Install node modules

1. Install pm2 globally.

npm i -g pm2

2. Install backend node modules.

cd Ultimafia
npm install

3. Install frontend node modules.

cd react_main
npm install

Setup environment variables

1. Create .env file for the server under Ultimafia/.env, and copy this example file

2. Create a .env file for the React app under Ultimafia/react_main/.env and copy this example file

3. Refer to this guide for retrieving your own test API keys for Firebase and reCAPTCHA.

Start the site

1. Start the backend server

cd Ultimafia
npm start

2. Start the frontend React app

cd react_main
npm start

Role and game creation

• Role Creation Guide
• Role Icon Guide

This site is based on the code provided by r3ndd from this repository and is used under the Creative Commons license (Attribution-NonCommercial-ShareAlike 4.0 International). It has been changed and is not affiliated with the creator or the website that uses the original repository's code.

Contributors

Music is by Fred, check out his youtube @fredthemontymole