🥪 Sandwitches

Sandwiches so good, they haunt you!

• ✨ Overview
• 🎯 Features
  • TRML
• 📥 Getting Started
  • Environment variables
• Development setup
  • Prerequisites
  • Installation
• 🧪 Testing & Quality

✨ Overview

Sandwitches is a modern, recipe management platform built with Django. It is made as a hobby project for my girlfriend, who likes to make what I call "fancy" sandwiches (sandwiches that go beyond the Dutch normals), lucky to be me :). Sandwiches so good you will think they are haunted !. See wanted to have a way to advertise and share those sandwiches with the family and so I started coding making it happen, in the hopes of getting more fancy sandwiches.

To view the live website go to sandwitches.vandijke.xyz

🎯 Features

Sandwitches comes packed with comprehensive features for recipe management, community engagement, and ordering:

• 🍞 Recipe Management - Upload and create sandwich recipes with images, ingredients, and instructions
• 👥 Community Page - Discover and browse sandwiches shared by community members
• 🛒 Ordering System - Browse recipes and place orders with cart functionality and order tracking
• ⭐ Ratings & Reviews - Rate recipes on a 0-10 scale with detailed comments
• 🔌 REST API - Full API access for recipes, tags, ratings, orders, and user management
• 📊 Admin Dashboard - Comprehensive admin interface for recipe approval and site management
• 🌍 Multi-language Support - Internationalization for multiple languages
• 📱 Responsive Design - Mobile-friendly interface with BeerCSS framework
• 🔔 Notifications - Email and Gotify push notification integration
• 📈 Order Tracking - Real-time order status tracking with unique tracking tokens
• 📊 Analytics - Umami analytics integration for tracking user behavior
• 🖨️ TRML – Official TRML plugin support.

TRML

If you happen to have a TRML laying arround be sure to check out this recipe which is an official plugin for your TRML.

📥 Getting Started

services:
  sandwitches:
    image: martynvandijke/sandwitches:latest
    container_name: sandwitches
    environment:
     - ALLOWED_HOSTS=localhost,127.0.0.1,[::1]
     - CSRF_TRUSTED_ORIGINS=http://localhost:8000,http://127.0.0.1:8000
     - SECRET_KEY=superdupersecretkey
     - DATABASE_FILE=/config/db.sqlite3
     - MEDIA_ROOT=/config/media
    ports:
      - 6270:6270
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:6270/api/ping"]
      interval: 5s
      timeout: 10s
      retries: 3
    volumes:
      - /path/to/sandwitches:/config
    restart: always

Environment variables

Below is a list of all supported environment variables.

Development setup

Prerequisites

• Python 3.12+
• uv (recommended) or pip

Installation

1. Clone the repository:

   git clone https://github.com/martynvdijke/sandwitches.git
   cd sandwitches
   

2. Sync dependencies:

   uv sync
   

3. Run migrations and collect static files:

   uv run src/manage.py migrate
   uv run src/manage.py collectstatic --noinput
   

4. Start the development server:

   uv run src/manage.py runserver
   

🧪 Testing & Quality

This project wraps all tests, linting and formatting in invoke tasks so you can run:

• Run tests: uv run invoke tests
• Linting: uv run invoke linting
• Type checking: uv run invoke typecheck

Made with ❤️ for sandwich enthusiasts.