SWSheets is a simple application for creating, storing, sharing, and printing Fantasy Flight Games' Star Wars role-playing game characters online. It is not intended to enforce any rules of character building or provide any aids beyond calculating die rolls.
Please use the issues page.
The easiest way to get the application up and running locally is with Docker.
-
If this is your first time with the application, create and seed the database.
-
NOTE: If this is not your first time running the app, this will drop the local development database, so ensure that you want to do that.
-
Make sure the directory you are running this is in is known to Docker. On the macOS you can configure shared paths from Docker -> Preferences... -> Resources -> File Sharing. See https://docs.docker.com/docker-for-mac for more info.
-
docker-compose run --rm app setup
- Run the application.
docker-compose up
- If you ever want to run ad-hoc
mix
tasks, you can pass arbitrarymix
tasks todocker-compose
.
docker-compose run --rm app doa.mixthing
- Visit
localhost:4000
from your browser.
- Install the
pre-commit
hook in order to automatically check formatting of your Elixir code.
pre-commit install
- You can run your tests inside the container with
docker-compose
.
docker-compose run -e MIX_ENV=test --rm app test
All work within this repo is released under a Creative Commons Attribution-NonCommercial 3.0 United States license. Essentially you are welcome to do what you like with this as long as you provide attribution and don't charge for it.
Star Wars, Edge of the Empire, Age of Rebellion, Force and Destiny, and all associated works remain the copyright of their respective copyright holders.
Artwork from "Star Wars Sketch Cards Cantina" by antonvandort is included under its original CC BY-NC ND license.