A simple cocktail recipe manager
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Cocktails is a simple web app to manage cocktail recipes. It's written in Django.



  • Mobile-first responsive design
  • Browse by ingredient, recipe, or source
  • Search for recipes including an ingredient
  • User authentication and private recipes
  • Recipe multiplier for making larger batches
  • Recipe entry with the Django Admin panel


Assuming you have virtualenvwrapper:

  • clone the repo
  • mkvirtualenv cocktails
  • pip install -r requirements.txt
  • create a local database
  • add the file cocktails/localsettings.py — see contents below
  • ./manage.py migrate
  • ./manage.py createsuperuser — you can use this to log in at localhost:8000/admin
  • ./manage.py runserver

Then you can visit localhost:8000 and you should see the site.


DEBUG = True
STATIC_ROOT = 'staticfiles'
STATIC_URL = '/static/'
SECRET_KEY = '[your secret key]'

    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': '[your database name]',
        'USER': '[your database user]',
        'PASSWORD': '[your database user password]'

CSS and JS

CSS is written using SASS, JS is in coffeescript, and both are managed with gulp. The coffee is compiled with webpack. Assuming you already have node, npm and gulp installed, to install all of the packages required to compile these files, run:

npm install

A requirement for sass compilation is the ruby sass gem:

gem install sass

Then to start gulp watching and compiling the files, run:


Deployment Notes

Mostly for my own use, but to deploy:

  • create a python application for the app and a static php application for the static files

  • create domains for each

  • create a database and database user, add those to localsettings.py

  • add a virtualenv, and install the required packages:

    • mkvirtualenv michael_cocktails
    • cd michael_cocktails
    • workon michael_cocktails
    • pip install -r requirements.txt
    • pip install --upgrade pip if prompted
  • in apache2/conf/httpd.conf:

    • delete DirectoryIndex and DocumentRoot, and the <Directory> block

    • Add WYSGIPythonPath — This is like a bash path, except it should point to the likely spots that python executables can be found:

        WSGIPythonPath [path-to-app]/michael_cocktails:[path-to-app]/michael_cocktails/cocktails:/home/katur/.virtualenvs/michael_cocktails/lib/python2.7/site-packages:/home/katur/.virtualenvs/michael_cocktails/lib/python2.7
    • Change WSGIDaemonProcess to use the python in our virtualenv:

        WSGIDaemonProcess michael_cocktails processes=2 threads=12 python-path=[path-to-app]/michael_cocktails:[path-to-app]/michael_cocktails/cocktails:[path-to-home]/.virtualenvs/michael_cocktails/lib/python2.7/site-packages:[path-to-home]/.virtualenvs/michael_cocktails/lib/python2.7
    • Add an alias to the wsgi executable

        WSGIScriptAlias / [path-to-app]/michael_cocktails/cocktails/cocktail/wsgi.py
  • change any settings necessary in the static application (e.g., modify the .htaccess file to serve fonts with a longer expiration)

To deploy updates:

  • git pull
  • get static file updates, if necessary: ./cocktails/manage.py collectstatic
  • restart apache, if necessary: ./apache2/bin/restart