Skip to content

bkgreve/tap-tally

Repository files navigation

Tap Tally: A Digital Beer List and Keg Level Monitor

Tap Tally is designed to present a list of what's on tap in an aesthetically pleasing manner. It will also (in an upcoming release) interface with flow meters to keep a real-time tally of current keg levels -- no more running dry at the worst possible moment! Finally, Tap Tally also (in an upcoming release) provides provisions for keeping notes about batches for streamlined record keeping.

Tap Tally is still very much a work in progress

Installation

To quickly get started with Tap Tally:

git clone [email protected]:bkgreve/tap-tally.git
cd tap-tally
docker-compose up

Docker-compose will then build 2 images: one for the Flask back-end that serves the data and then an Nginx image, which also includes the static assets.

Usage

Starting Tap Tally

The docker-compose up command will start Tap Tally, and the app can be accessed by navigating to http://localhost in your browser. Depending on your network configuration, you may also be able to access Tap Tally from all machines on your network (by default, it is listening on port 80).

Editing the tap list

Currently, all beer/tap data are stored in data/beers.json (a future release will explore alternative data storage methods). This file has the following structure:

[
  {
    "tapNo": 1,
    "alcbyVol": 5,
    "beerName": "Beer Name Here",
    "beerSRM": 1,
    "beerIBU": 1,
    "brewedOn": "Jan. 1, 2020",
    "keggedOn": "Feb. 1, 2020",
    "kegNo": 1,
    "beerDescription": "Beer description goes here",
    "visible": true
  },
  {
    "tapNo": 2,
    "alcbyVol": 5,
    "beerName": "Beer Name Here",
    "beerSRM": 1,
    "beerIBU": 1,
    "brewedOn": "Jan. 1, 2020",
    "keggedOn": "Feb. 1, 2020",
    "kegNo": 1,
    "beerDescription": "Beer description goes here"
  }
]

All objects with visible set to true in the above array will be loaded and passed to the front-end for display. An example file is included in this repository: simply edit the file with your favorite editor, save, and then refresh the page to see your changes. You can add as many or as few beers as you'd like.

Then, navigating to http://localhost (once the Docker containers are running) should show your tap list!

Screenshots

image