Skip to main content

Welcome to CampusBite

A complete campus food ordering platform that connects students, faculty, and canteen stores. Order food online, track your order in real-time, and pick up with OTP verification.

Get startedView API reference
🍔
Campus Canteen
Open now
Order #1234
Ready
OTP: 5678

Quick start

Get CampusBite running on your campus in minutes

1

Clone the repository

Clone the CampusBite repository to your local machine.
git clone https://github.com/zs0c131y/CampusBite.git
cd CampusBite
2

Set up MongoDB database

Start MongoDB locally or create a free MongoDB Atlas account. The application will automatically create collections on first run.
# Local MongoDB
brew services start mongodb-community  # macOS
sudo systemctl start mongod            # Linux
3

Configure environment variables

Copy the example environment file and configure your database connection, JWT secrets, and email settings.
cp backend/.env.example backend/.env
You’ll need a Gmail account with an App Password for email verification. Generate one at Google Account → Security → 2-Step Verification → App passwords.
4

Install dependencies and start

Install dependencies for both backend and frontend, then start the development servers.
# Install backend dependencies
cd backend && npm install

# Install frontend dependencies
cd ../frontend && npm install

# Start backend (in one terminal)
cd backend && npm run dev

# Start frontend (in another terminal)
cd frontend && npm run dev
The application will be available at http://localhost:5173

Explore by role

CampusBite provides tailored experiences for students, faculty, and store owners

For students

Browse stores, order food, track deliveries, and reorder your favorites

For store owners

Manage your menu, accept orders, and track your daily revenue

For developers

Integrate with the CampusBite API to build custom experiences

Key features

Everything you need to run a modern campus food ordering system

Role-based authentication

Secure JWT-based authentication with email verification for students, faculty, and store employees

Real-time order tracking

Live status updates from order placement through pickup with status timeline

UPI payment integration

Native UPI deep-link payments supporting GPay, PhonePe, Paytm, and BHIM

OTP verification

Secure order pickup with OTP-based verification system

Menu management

Complete menu CRUD operations with availability toggles and category filters

Store dashboard

Analytics dashboard with order queue, revenue tracking, and store settings

Technical overview

Learn about the technology stack and architecture behind CampusBite

Tech stack

React 18, Node.js, Express, MongoDB, Tailwind CSS v4

Architecture overview

Full-stack architecture with REST API and JWT authentication

Project structure

Organized codebase with clear separation of concerns

Deploy to production

Ready to deploy? Choose your platform and get started

Deploy to Fly.io

Deploy with single machine setup and persistent volumes

Docker deployment

Run with Docker and Docker Compose for local or cloud deployment

Database setup

Configure MongoDB with auto-collection creation

Environment variables

Complete reference for all configuration options

Ready to get started?

Follow the quickstart guide to set up CampusBite on your campus in under 10 minutes.

Get started now