voterbowl

Prepare for the ultimate showcase showdown. https://voterbowl.org/

We use:

• Python 3.12
• Django 5
• Postgres 16

We spend all our hipster tech tokens for this project to help us build a front-end directly in Django-land. In particular, we use:

• HTMX with django-htmx
• css-scope-inline
• surreal

Having never used any of these toys before, we'll see how this pans out. (Update: so far, I sorta like HTMX but don't love how I've structured everything with the other two. And I hate Django templates as much as I remember.)

(Others under consideration include django-slippers, django-template-partials, and django-components. And don't forget the django-htmx-patterns documentation.)

For code cleanliness, we also use:

• Ruff for linting
• mypy for type checking

Getting a local dev instance running

1. Make sure you have python 3.12 installed
2. Create and enable a python virtualenv with python -m venv .venv; source .venv/bin/activate
3. Install the python dependencies with pip install -r requirements.txt or pip install ".[dev]"
4. Get postgres set up. If you've got docker installed, ./scripts/dockerpg.sh up
5. Configure your environment variables. (See .env.sample and settings.py)
6. Run the app. ./manage.py runserver and visit http://localhost:8000/