This project is a Phoenix server that handles running a game of beer-Ludo ("Kalja-Kimble"). The API is based on Phoenix channels. A Postgres-based persistence layer is included for longer games. See the Preact frontend project for the corresponding web client. The current version of the game can be played at https://webludo.katris.dev/
Steps to setup the project the first time:
- Clone the repository
- Install dependencies with
mix deps.get - Ensure that a local Postgres database is running and the settings in
config/dev.exsmatch your local setup - Create and migrate your database with
mix ecto.setup
To start your Phoenix server: mix phx.server
The server now runs in localhost:4000. There is no built-in browser interface, but running the Preact frontend project locally works well.
The production instance can be found at https://webludo-api.oni.dev. Deployment is done through Gigalixir.
- Deploy by running
git push gigalixir master - (If migrations are needed:)
gigalixir ps:migrateto run missing database migrations
You can tail the production server logs by running gigalixir logs