Which Side Are You On? helps an event organizer to run a group game that asks questions and has participants joining one side or the other.
Presentation view: shows the open question and players as they make choices. As an event organizer, this is the view that you want to livestream.
Player view: this is what players see when a question is open, they can choose left or right to go to that side.
Manager view: this view allows the event organizer to add, edit, open, and close questions, as well as see a list of the players that have joined.
Manager view settings: these settings allow the event organizer to import and export data, as well as change the appearance of the presentation view.
Roles:
- Event organizer: The person creating the sides game, adding questions, and sharing the game link to players.
- Player: A person entering the game with player ID and name via a game link.
- An event organizer should create a new sides game in the main landing page https://sides.mtso.io. After the game is created, the event organizer will be redirected to the manager view. Make sure to bookmark this URL as it is the only way to access the manager view.
- Share the game link with players (looks like "https://sides.mtso.io/name-of-game" where name-of-game is the generated game name).
- Livestream the presentation view "https://sides.mtso.io/name-of-game/present".
- Add questions in the manager view and open them to show the question to players. Players can pick a side for a question as long as the question is open.
The main web app running at https://sides.mtso.io is hosted on heroku.
Requirements
- MongoDB instance with a connection string in the environment variable
MONGODB_URI
. A MongoDB database can be provisioned at https://www.mongodb.com/atlas/database. - Heroku CLI (Installation instructions at https://devcenter.heroku.com/articles/heroku-cli)
git clone https://github.com/mtso/sides
git checkout main
heroku git:remote -a <app name>
git push heroku HEAD