An online implementation of the tabletop game Secret Hitler, built on node.js and socket.io. Play at secrethitler.online.

Supports 5-10 players, text or voice (beta) chat, and the game's core rule set. Game data is persisted to allow features like stat aggregation, or game replays in future.

Run sql_import.sh to create the Postgres DB and import the SQL dump within the repo.

./sql_import.sh

Then start the application via docker-compose.

docker-compose up -d

I highly suggest changing the database credentials in the files above before running this anywhere publically.

The app is written in vanilla HTML5, CSS3, and JS ES5. Files in /server run on the node.js server, files in /public are served statically when users load the page, while files in /common are shared for both.

For testing/development purposes, clone/fork the repository and ensure you have node.js installed to start the server:

cd secret-hitler
npm install
node server.js

By default, the app is served at localhost:8004

All js and css assets in /public and /common are bundled with WebPack for efficient page loads. To recompile your changes as you work:

npm install --global webpack
webpack --watch

Unless you specifically need to test the user accounts system or game persistence features, you don't need to run a local db instance. Instead, simply sign in via the guest button (note that in this mode, not all features are available). Otherwise, you'll need to be running a recent version of Postgres locally.

1. Create a new database and import schema.sql
2. Set LOCAL_DB_URL in server/tools/config.js to the Postgres database URL
3. (optional) Set SENDGRID_API_KEY to your SendGrid account's API key if you want to test email delivery

Pull requests welcome, or check the issues page to make a bug report or feature suggestion.

"Secret Hitler" is a game designed by Max Temkin, Mike Boxleiter, Tommy Maranges, and Mackenzie Schubert. This adaptation is neither affiliated with, nor endorsed by the copyright holders.

Secret Hitler is licensed under Creative Commons BY-NC-SA 4.0 (non-commercial, share-alike, attribution required).