Pull request bingo game

This is a game where people use Pull Request to submit numbers for bingo. A Gamemaster will merge Pull Requests, and upon merge, the numbered file added to the repository becomes the next number called.

How it works

As a Gamemaster

Fork the repository
Make on one commit to trigger a pages build (add the first number for example)
Share this URL with all the players: http://your_username.github.io/bingo-board
Decide the range of numbers for a board (1~~50 or 1~~100)
Every player should go to http://your_username.github.io/bingo-board/board.html to create a bingo board based on the range
You merge Pull Request as they come in, ideally in the order they come in

Verify that the file is a JSON file that lives in _data/numbers.
Verify that there is no more than one file.

As a player

Fork the game repository (not this one, but the one from the Gamemaster)
Add an empty JSON file with your preferred number as the file name to your fork in _data/numbers, like 47.json
Submit a Pull Request to the game repository
Wait for your number to be merged by the Gamemaster
Click on a number to mark it as called
Go back to 2!

Development

This is a Jekyll site, numbers are from the data files.

Running the app

# Install Jekyll from the github-pages gem
$ gem install github-pages
# Serve the website, which will live on localhost:4000 by default
$ jekyll server -w

Playing alone

Set up your bingo board at /board.html
Open / for numbers
Use fun-script.js and pass in a maximum number (50 or 100) to generate random numbered files every 5 seconds. For example:

$ node fun-script.js 50

Mark numbers as they are called until bingo

Restart

Delete all the files in _data/numbers
Clear localStorage by doing

localStorage.removeItem('numbers')

in the console

License

MIT

Maintainers

@muan & @jlord

retrofor/bingo-board