Posio

A multiplayer geography game built using:

• Django (GeoDjango) and the Django Channels library
• HTMX
• Leaflet

Visit https://posio.abrenaut.com/ for a live demo.

Quick start

With Docker

1. Initialize the database

docker-compose run web manage.py migrate
docker-compose run web manage.py createcitiesgame
docker-compose run web manage.py createflagsgame

2. Start the application

docker-compose up

3. Open the following URL in your web browser: http://127.0.0.1:8000

Without Docker

1. Follow the GeoDjango documentation to install the application dependencies in your environment using Spatialite as the Spatial Database
2. Install Redis
3. Create a virtual environment and install the Python dependencies (tested with Python 3.12)

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

4. Initialize the database

mkdir -p db
./manage.py migrate
./manage.py createcitiesgame
./manage.py createflagsgame

5. Start the application

./manage.py runserver

6. Open the following URL in your web browser: http://127.0.0.1:8000

License

This project is under MIT license.

More screenshots