Skip to content
This repository has been archived by the owner on Nov 3, 2019. It is now read-only.
/ PlayByPost Public archive

Play-by-post single forum for D20 RPGs.

License

Notifications You must be signed in to change notification settings

Celeo/PlayByPost

Repository files navigation

Play by post

pipeline status coverage report

A full-stack web app for a simple forum designed for "play by post" RPGs.

System requirements

  1. Python 3.7
  2. Redis

Getting set up

  1. Clone the repo
  2. Create a virtualenv
  3. Activate the virtualenv
  4. Install Python deps
  5. Copy 'config.example.json' to 'config.json'
  6. Populate the config
  7. Navigate to the project root

This project is set up to run with SQLite by default. If you want to run on some other database, update 'config.json' accordingly and install any required libraries.

Running

Run './run.sh' for local development and './run.sh prod' for production.

If you're using any of the emailing, you'll need a provider (I'm using Mailgun) and to run the celery worker alongside your app (both in development and producton).

Running tests

  1. Run './run.sh tests'

Deploying

Basically the same as the "Getting set up" instructions, but on whichever server you're running the app on. Then:

  1. Setup a Nginx (or Apache) proxy
  2. Run the app with './run.sh prod'