Drink Stash

A little web app for saving and searching for cocktail recipes.

Features

• Built for mobile devices
• Search for recipes with an expressive (nerdy) query engine
• Keep lists for menus or of things you love or want to try
• Track what's in your liquor cabinet so you can easily find what you can make
• Over a 150 classic cocktails and original recipes to get you started
• Dark mode
• Lightweight server, tidily packaged in Docker

Screenshots

Running

Run it behind an HTTP reverse-proxy for TLS-termination etc. You can run it from the base image, storing persistent data in a sqlite database in a mounted volume. With docker-compose:

version: '3.7'

services:
    api:
        image: 'gthole/drink-stash:latest'
        init: true
        restart: 'always'
        environment:
            SECRET_KEY=<yourlongsecretkey>
            ALLOWED_HOSTS=<yourhostname>
        ports:
            - '8000'
        volumes:
            - './data:/data'
            - './public:/public'

The SECRET_KEY should be a long random string of characters, and the ALLOWED_HOSTS is a comma-separated list of hostnames you plan to use to access the app.

Settings

Drink Stash imports settings from environment variables. Values that are arrays (e.g. ALLOWED_HOST) are interpreted to be a comma separated list. A limited set of variables are currently supported.

For example:

EMAIL_HOST=mail.mydomain.com
EMAIL_HOST_USER=no-reply@mydomain.com
EMAIL_HOST_PASSWORD=emailpassword
DEFAULT_FROM_EMAIL=Drink Stash <no-reply@mydomain.com>
SERVER_EMAIL=no-reply@mydomain.com
TIME_ZONE=America/Los_Angeles
ALLOWED_HOSTS=drinks.mydomain.com
DEBUG=False
ADMINS=Me:me@mydomain.com,Someone Else:someone@mydomain.com

Provisioning

When starting up your container, you should set the following environment variables to provision an initial user and some recipes to get started with:

version: '3'

services:
    api:
        image: 'gthole/drink-stash:latest'
        restart: 'always'
        environment:
            SECRET_KEY=<yourlongsecretkey>
            ALLOWED_HOSTS=<yourhostname>
            DJANGO_SUPERUSER_USERNAME=<yourusername>
            DJANGO_SUPERUSER_EMAIL=<youremail>
            DJANGO_SUPERUSER_PASSWORD=changeme
            DJANGO_SUPERUSER_FIRST_NAME=<first>
            DJANGO_SUPERUSER_LAST_NAME=<last>
            INITIAL_FIXTURES=recipes
        ports:
            - '8000'
        volumes:
            - './data:/data'
            - './public:/public'

This will run a provisioning script on startup that creates a superuser if no users exist, and creates initial recipes to search. On subsequent container starts you can remove the DJANGO_SUPERUSER_* and INITIAL_FIXTURES variables.

Development Environment

Install Docker.

# Build the app image
$ docker-compose build api

# Follow the setup instructions in the Provisioning section above

# Start the server
$ docker-compose up

# Run the API unit tests
$ docker-compose run --rm api ./manage.py test drinks