Transform your restaurant menu into an interactive digital experience accessible via QR code
Quick Start • Demo Credentials • Features • Installation • Documentation
- Overview
- Problem Statement
- Solution
- Quick Start
- Demo Credentials
- Features
- Technology Stack
- System Architecture
- Project Structure
- Installation
- Usage Guide
- Documentation
- Screenshots
- Future Enhancements
- Contributing
- License
QRDine is a production-ready, multi-tenant SaaS platform that empowers restaurants to create and manage digital menus accessible via QR codes. No app installation required for customers, no technical knowledge needed for restaurant owners.
| 🏨 Restaurants | ☕ Cafes | 🍕 Food Trucks | 🍺 Bars |
|---|---|---|---|
| Full-service dining | Quick-service cafes | Mobile vendors | Drink menus |
Live Demo: https://qr-dine-15cf.onrender.com
| Feature | Benefit |
|---|---|
| 🚀 5-Minute Setup | From registration to live menu in under 5 minutes |
| 💰 ₹0 to Start | Free tier available, no credit card required |
| 📱 Zero App Required | Customers just scan and browse—no downloads |
| 🔄 Real-Time Updates | Mark items unavailable instantly, reflects immediately |
| 🌐 Multi-Tenant Ready | One platform, unlimited restaurants |
| 📊 Analytics Ready | Built-in dashboard with key metrics |
| 🎨 Mobile-First Design | Optimized for smartphones and tablets |
| 🔒 Secure & Reliable | Django-powered backend with role-based authentication |
# 1️⃣ Clone the repository
git clone https://github.com/Sanchet237/qrdine.git
cd qrdine
# 2️⃣ Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# 3️⃣ Install dependencies
pip install -r requirements.txt
# 4️⃣ Setup database
python manage.py migrate
# 5️⃣ Create superuser (optional)
python manage.py createsuperuser
# 6️⃣ Run development server
python manage.py runserver🎉 Success! Visit http://127.0.0.1:8000/ to see the application.
📚 Next Steps: See Installation for detailed setup instructions.
|
Platform Administration Panel What you can do:
|
Restaurant Dashboard & Menu Management What you can do:
🍽️ View Public Menu: https://qr-dine-15cf.onrender.com/menu/hotel-subedar/ |
💡 Tip: These demo accounts are created automatically when you run the management commands included in the project. See restaurants/management/commands/ for details.
Traditional physical menus face several challenges:
- Costly to update: Reprinting menus for price changes or new items is expensive
- Unhygienic: Shared menus pose sanitation concerns, especially post-pandemic
- Static experience: No real-time availability updates (sold-out items)
- Limited information: Space constraints restrict detailed descriptions and images
- Language barriers: Difficult to offer multi-language support
QRDine is a multi-tenant SaaS platform that enables restaurants to digitize their menus instantly. Customers scan a QR code and access a mobile-optimized menu without installing any app. Restaurant owners manage their menus through an intuitive dashboard with real-time updates.
Key Benefits:
- ✅ Instant menu updates without reprinting
- ✅ Contactless ordering experience
- ✅ Rich media support (HD images, descriptions)
- ✅ Real-time availability toggles
- ✅ Analytics-ready architecture
- ✅ Zero app installation for customers
| 🏪 Restaurant Owners | 📱 Customers | 🔐 Platform Admins |
|---|---|---|
| 📝 Self-service registration | 📲 No app installation needed | 🎛️ Full platform control |
| 🍽️ Visual menu builder | 🔍 Real-time search | 👥 User management |
| 📸 Image upload & management | 🏷️ Smart category filters | 📊 Analytics dashboard |
| 📱 QR code auto-generation | 🌿 Vegan/non-veg indicators | 🗑️ Bulk operations |
| 🔄 Real-time availability toggle | 💰 Clear pricing display | 🛡️ Security controls |
| 📊 Dashboard with analytics | 🎨 Mobile-first UI/UX | 🔧 Platform configuration |
| 🎨 Restaurant profile customization | 🚀 Fast, smooth browsing | 📈 Growth monitoring |
| 🖼️ Logo & branding upload | ✅ No registration required | ⚙️ Settings management |
- 🏪 Self-Service Registration — Restaurant owners can sign up and onboard independently
- 📝 Menu Builder — Create categories and menu items with images, descriptions, and prices
- 🔄 Real-Time Availability Toggle — Mark items as sold-out instantly (reflects immediately on customer menus)
- 🖼️ Image Management — Upload high-quality dish images with automatic optimization
- 📱 QR Code Generation — Auto-generated scannable QR codes for each restaurant
- 📊 Dashboard Analytics — View total items, available items, and sold-out count
- 🎨 Profile Customization — Update restaurant name, address, description, and logo
- 📲 No App Required — Access menus directly via QR scan (mobile browser)
- 🎨 Modern UI/UX — Dark theme with smooth animations and responsive design
- 🔍 Advanced Search — Real-time search across all menu items
- 🏷️ Smart Filters:
- Filter by category (Starters, Main Course, Desserts, etc.)
- Dietary filters (Veg Only / Non-Veg Only)
- Availability filter (Hide sold-out items)
- 🌿 Visual Dietary Indicators — Green dot for veg, red triangle for non-veg
- 💰 Clear Pricing — Prices displayed in local currency
- 🔐 Restaurant Management — Approve/suspend restaurants
- 👥 User Management — View and manage restaurant admin accounts
- 📈 Platform Dashboard — Overview of total restaurants and activity
- 🗑️ Bulk Operations — Delete inactive restaurants
| Layer | Technology | Purpose |
|---|---|---|
| Backend Framework | Django 4.2.11 (Python 3.10+) | Web framework, ORM, authentication |
| Database (Dev) | SQLite3 | Lightweight development database |
| Database (Prod) | PostgreSQL | Production-ready relational database |
| Frontend | Django Templates + Vanilla JS | Server-side rendering with progressive enhancement |
| Styling | Tailwind CSS (CDN) | Utility-first CSS framework |
| Image Processing | Pillow 10.3.0 | Image uploads, optimization, resizing |
| QR Generation | qrcode[pil] 7.4.2 | Dynamic QR code generation |
| Static Files | WhiteNoise 6.6.0 | Static file serving in production |
| Environment | python-dotenv 1.0.0 | Environment variable management |
| WSGI Server | Gunicorn | Production HTTP server |
┌─────────────┐
│ Customer │ ──> Scans QR Code ──> Mobile Menu Viewer
└─────────────┘ (Public, No Login)
│
▼
┌──────────────┐ ┌────────────────┐
│ Restaurant │ ──> Dashboard ──> │ Django Backend│
│ Owner │ (CRUD Menu) │ (Business │
└──────────────┘ │ Logic) │
└────────────────┘
┌──────────────┐ │
│ Super Admin │ ──> Admin Panel ──> │
└──────────────┘ (Platform Mgmt) ▼
┌────────────────┐
│ SQLite DB │
│ (Models: │
│ Restaurant, │
│ MenuItem, │
│ Category) │
└────────────────┘
Data Flow:
- Restaurant owner registers → Creates account
- Adds menu items → Stored in database
- QR code auto-generated → Links to
/menu/<restaurant-slug>/ - Customer scans QR → Fetches live menu data
- Owner toggles availability → Updates reflected instantly
qrdine/
├── accounts/ # User authentication & authorization
│ ├── models.py # Custom User model (roles: superadmin, restaurant_admin)
│ ├── views.py # Login, registration, logout views
│ ├── forms.py # Registration and login forms
│ └── urls.py # Auth routes
│
├── restaurants/ # Restaurant management core
│ ├── models.py # Restaurant, Category, MenuItem models
│ ├── views.py # Dashboard, menu CRUD, QR generation
│ ├── utils.py # QR code generation utility
│ ├── forms.py # Menu item and category forms
│ ├── decorators.py # @restaurant_required decorator
│ ├── context_processors.py # Global template context
│ └── management/
│ └── commands/ # CLI commands (create demo data)
│
├── menu/ # Public menu viewer (customer-facing)
│ ├── views.py # menu_viewer() - public menu display
│ └── urls.py # /menu/<slug>/ route
│
├── superadmin/ # Platform administration
│ ├── views.py # Platform dashboard, restaurant management
│ ├── decorators.py # @superadmin_required decorator
│ └── urls.py # /superadmin/ routes
│
├── core/ # Landing page & shared utilities
│ ├── views.py # Landing page, 404/500 handlers
│ └── urls.py # Root URL
│
├── templates/ # HTML templates
│ ├── base.html # Base template with nav
│ ├── base_dashboard.html # Dashboard-specific base
│ ├── accounts/ # Login, registration pages
│ ├── restaurants/ # Dashboard templates
│ ├── menu/ # Public menu viewer
│ ├── superadmin/ # Admin templates
│ └── core/ # Landing page
│
├── static/ # Static assets
│ ├── images/ # Logo, branding assets
│ └── qr_codes/ # Generated QR codes (static copy)
│
├── media/ # User-uploaded files
│ ├── logos/ # Restaurant logos
│ ├── menu_items/ # Dish images
│ └── qr_codes/ # Generated QR codes
│
├── qrdine/ # Django project settings
│ ├── settings.py # Configuration
│ ├── urls.py # Root URL configuration
│ └── wsgi.py # WSGI entry point
│
├── manage.py # Django management script
├── requirements.txt # Python dependencies
├── .env.example # Environment variables template
└── README.md # This file
- Python 3.10 or higher
- pip (Python package manager)
- virtualenv (recommended)
git clone https://github.com/Sanchet237/qrdine.git
cd qrdine# Windows
python -m venv venv
venv\Scripts\activate
# macOS/Linux
python3 -m venv venv
source venv/bin/activatepip install -r requirements.txtDependencies installed:
- Django==4.2.11
- Pillow==10.3.0
- qrcode[pil]==7.4.2
- whitenoise==6.6.0
- python-dotenv==1.0.0
Create a .env file in the project root:
cp .env.example .envEdit .env and update:
SECRET_KEY=your-super-secret-key-here-change-in-production
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1# Run migrations in order
python manage.py makemigrations accounts
python manage.py migrate accounts
python manage.py makemigrations restaurants
python manage.py migrate restaurants
python manage.py migratepython manage.py createsuperuserImportant: When prompted for role, enter superadmin
python manage.py runserverAccess the application at: http://127.0.0.1:8000/
- Navigate to
/accounts/register/ - Fill in restaurant details (name, email, phone, address)
- Create account credentials
- Automatic slug generation from restaurant name
- Go to
/accounts/login/ - Enter credentials
- Redirects to
/dashboard/
- Navigate to Dashboard → Categories
- Add categories (e.g., "Starters", "Main Course", "Desserts")
- Set display order (items will be sorted accordingly)
- Go to Dashboard → Menu Items → Add New Item
- Fill in details:
- Name, Description, Price
- Upload dish image (optional)
- Select category
- Mark as Vegetarian (checkbox)
- Set availability (default: available)
- From menu items list, click Toggle Availability button
- Instantly marks items as sold-out or available
- Updates reflect immediately on customer menu
- Navigate to Dashboard → QR Code
- QR code auto-generated linking to
/menu/<your-restaurant-slug>/ - Download high-resolution QR code
- Print and display at tables, counter, or entrance
- Scan QR Code at restaurant (using phone camera)
- Browser opens menu automatically (no app install)
- Browse menu with categories, images, and prices
- Use filters:
- Search by dish name
- Filter by category
- Show only Veg/Non-Veg items
- Hide sold-out items
- Visual indicators: Green dot (veg), Red triangle (non-veg)
- Access
/superadmin/after logging in as superadmin - View all registered restaurants
- Toggle restaurant active/inactive status
- Delete restaurants (with confirmation)
- View platform statistics
Beautiful, modern landing page with clear call-to-actions and feature highlights.
Simple, streamlined registration process for restaurant owners.
Intuitive dashboard with menu management, analytics, and quick actions.
Auto-generated QR codes ready to download and print for table placement.
Mobile-optimized menu with beautiful dish images and clear pricing.
Advanced filtering by category, dietary preferences, and availability.
- Online Ordering — Add to cart and place orders
- Payment Integration — Razorpay/Stripe integration
- Multi-Language Support — Hindi, Spanish, French menus
- Analytics Dashboard — Track popular items, peak hours
- Table Management — QR codes per table with table numbers
- Customer Reviews — Rating and feedback system
- Allergen Information — Tag items with allergen warnings
- Spice Level Indicators — Mild, Medium, Hot labels
- Combo Offers — Bundle pricing and meal deals
- Push Notifications — Alert customers about new dishes
- WhatsApp Integration — Order via WhatsApp Business API
- Dark/Light Theme Toggle — User preference for menu theme
Detailed documentation is available for each module:
- Accounts Module — User authentication, registration, and role management
- Restaurants Module — Core business logic, menu management, QR generation
- Menu Module — Public menu viewer for customers
- Super Admin Module — Platform administration and management
- Core Module — Landing page and shared utilities
We welcome contributions! To contribute:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit changes (
git commit -m 'Add some AmazingFeature') - Push to branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow PEP 8 style guide for Python code
- Write meaningful commit messages
- Add tests for new features
- Update documentation as needed
This project is licensed under the MIT License — see the LICENSE file for details.
Copyright (c) 2026 Sanchet Kolekar
If you find QRDine useful, please consider:
- ⭐ Starring this repository
- 🐛 Reporting bugs or suggesting features via Issues
- 🔀 Contributing to the codebase via Pull Requests
- 📣 Sharing with restaurant owners who could benefit
