Crusto - Full-Stack Pizza Delivery Platform

Crusto is a full-stack pizza delivery platform with custom pizza building, order tracking, inventory management, dynamic pricing, and an advanced admin dashboard.

🌐 Try now at crusto-pizza.vercel.app

Demo Admin Credentials

Email: admin@gmail.com
Password: Admin@123

Features

Custom Pizza Builder - Choose ingredients and build pizzas
Order Tracking - Real-time status updates
User Accounts - Save preferences and order history
Secure Payments - Multiple payment options
Admin Dashboard - Manage inventory and orders
Low Stock Alerts - Email notifications for low ingredients
Analytics - Sales reports and insights
Dynamic Pricing - Automatically calculate costs and availability
Mobile Responsive - Works across devices

Project Structure

The project is organized into separate frontend and backend applications:

crusto-pizza-delivery-app/
├── client/                     # React frontend application
│   ├── public/                 # Static assets (favicon, etc.)
│   ├── src/
│   │   ├── components/         # Reusable UI components
│   │   ├── hooks/              # Custom React hooks
│   │   ├── layouts/            # Page layout components
│   │   ├── lib/                # Utility functions and helpers
│   │   ├── pages/              # Page components organized by domain
│   │   │   ├── auth/           # Authentication pages
│   │   │   ├── root/           # Customer-facing pages
│   │   │   └── dashboard/      # Admin dashboard pages
│   │   ├── routes/             # React Router configuration
│   │   ├── store/              # Zustand state management stores
│   │   ├── App.tsx             # Main app component
│   │   ├── main.tsx            # React entry point
│   │   └── global.css          # Global styles
│   ├── .env.example            # Environment variables template
│   ├── package.json            # Frontend dependencies and scripts
│   ├── components.json         # Radix UI components configuration
│   ├── vite.config.ts          # Vite build configuration
│   └── tsconfig.json           # TypeScript configuration
│
├── server/                     # Node.js backend application
│   ├── src/
│   │   ├── config/             # DB, Redis, Cloudinary, and Razorpay configuration
│   │   ├── controllers/        # Route handlers and business logic
│   │   ├── jobs/               # Background job system
│   │   │   ├── processors/     # Job processing logic
│   │   │   ├── queues/         # Job queue definitions
│   │   │   └── workers/        # Worker processes
│   │   ├── middleware/         # Express middleware
│   │   ├── models/             # Mongoose schemas and models
│   │   ├── nodemailer/         # Email configuration and templates
│   │   ├── routes/             # API route definitions
│   │   ├── types/              # TypeScript type definitions
│   │   ├── utils/              # Helper functions and utilities
│   │   └── server.ts           # Express server entry point
│   ├── .env.example            # Environment variables template
│   ├── package.json            # Backend dependencies and scripts
│   └── tsconfig.json           # TypeScript configuration
├── .gitignore                  # Git ignore rules
├── LICENSE                     # Apache 2.0 license
└── README.md                   # Project documentation

Prerequisites

Before you begin, ensure you have the following installed:

Getting Started

After checking the prerequisites above, follow these steps to set up the project.

Clone the repository

git clone https://github.com/kunaldasx/crusto-pizza-delivery-app
cd crusto-pizza-delivery-app

Set up the frontend
```
cd client
npm install
cp .env.example .env
npm run dev
```
Configure the required environment variables in .env.
Set up the backend
Open a second terminal:
```
cd server
npm install
cp .env.example .env
npm run dev
```
Configure the required environment variables in .env.

Start the background workers

Use additional terminals for the background jobs:

# Price calculations
cd server
npm run dev:price

# Stock management
cd server
npm run dev:availability

Development

Once the frontend, backend, and background workers are running, the application can be used locally with the configured environment variables.

Contributing

Contributions are welcome. To contribute to Crusto:

Clone the repository and create a new branch:
```
git checkout -b name_for_new_branch
```
Make your changes and test them locally.
Submit a Pull Request with a comprehensive description of your changes.

Emailware

Crusto is an emailware. If you liked using this app or it helped you in any way, you can send an email to kunaldasx@gmail.com with anything you'd like to say about the software.

Technologies

This software uses the following technologies:

Frontend: React 19 + TypeScript + Vite + TailwindCSS + Radix UI
Backend: Node.js + Express + TypeScript
Database: MongoDB (Mongoose ODM)
State Management: Zustand stores
Queue System: Redis + BullMQ for background jobs
Authentication: JWT + bcrypt
File Storage: Cloudinary
Payments: Razorpay
Email: Nodemailer

License

Apache 2.0

🌐 Visit my website →
🖥️ GitHub ·
💼 LinkedIn ·
🐦 Twitter / X ·