Skål is a modern web application for managing your mead brewing journey—from crafting recipes to tracking batches and calculating ABV & calories. Designed with the homebrewer in mind, it features an intuitive interface, responsive design, and robust tooling for both casual and meticulous brewers alike.
Though built primarily for meadmakers (it's what I brew!), Skål is just as capable for beer and cider.
- Recipe Management: Create, edit, and browse brewing recipes with detailed ingredients and step-by-step instructions.
- Batch Tracking: Log fermentation batches with OG, FG, primary/secondary/bottle dates, notes, and photo galleries.
- Yeast Comparison: Compare, search, sort various yeasts to see tolerances and suggested uses.
- ABV & Calorie Calculator: Calculates ABV using the alternate formula and estimates calories.
- Ingredient Autocomplete: Ingredient names auto-saved and suggested for quicker input.
- Image Support: Upload and resize images (max 800x800), organized per batch.
- Theme Toggle: Supports light and dark themes, saved per user profile.
- User Authentication: Secure login, registration, and profile customization.
- Multi-User Support: Users can manage their own recipes and batches, or make them public.
- Responsive Design: Built with a sleek, CSS styled interface - and mobile-friendly.
- Export Options: Export your recipes and batches as PDF, CSV, JSON, TXT, or SQL backups.
git clone https://github.com/daytonjones/Skal.git
cd Skal(replace the values in '{}')
SECRET_KEY={your-secret-key}
DEBUG=False
POSTGRES_DB=skal
POSTGRES_USER=skaluser
POSTGRES_PASSWORD={skalpass}
DJANGO_ALLOWED_HOSTS=localhost,127.0.0.1,{yourdomain.com}
DJANGO_SUPERUSER_USERNAME=admin
DJANGO_SUPERUSER_EMAIL=admin@{example.com}
DJANGO_SUPERUSER_PASSWORD={password123}docker compose up --build -dThe app will automatically apply migrations, seed some recipes, and create the superuser on first run.
Visit http://localhost:8000
- Database: PostgreSQL service managed via
docker-compose.yml - Static & Media: Static files served with Whitenoise; uploaded media goes to
/media/ - Themes: Toggle stored in user profile, switched via CSS class
- CSRF: Derived from
DJANGO_ALLOWED_HOSTS - Export: Recipes/batches exportable in multiple formats (PDF, JSON, CSV, TXT, SQL)
-
Home Page
-
ABV Calculator
-
Yeast Info and Comparison
- Home: Welcome banner, most recent recipe & batch
- Recipes: Sortable list, detail view, edit/delete (if owner), public visibility toggle
- Batches: Track your brews from primary to bottling; upload images and notes
- Profile: Set your display name, avatar, and theme
- Calculators: Input OG/FG to compute ABV and estimated calories
- Export: Download your data for backup or printing
- Fork the repository
- Create a new feature branch (
git checkout -b feature/new-feature) - Commit your changes and add tests
- Submit a pull request with details
Dayton Jones Email: jones.dayton@gmail.com GitHub: @daytonjones
MIT License. See LICENSE for full details.