FreshIn10 🛒⚡

Ultra-fast grocery delivery platform — groceries in 10 minutes.

Built with Next.js 15, TypeScript, Prisma, PostgreSQL, Razorpay, Socket.io, and Tailwind CSS in a Turborepo monorepo.

---

📖 New Here? Start Here!

👉 START_HERE.md - Complete navigation guide to all documentation

Quick Links:

• 🚀 Quick Start Guide - Get running in 5 minutes
• 🔧 Run Separately Guide - Run backend/frontend independently
• ✅ Backend/Frontend Separation - Proof they're separated
• 🏗️ Architecture Guide - System design & diagrams
• 📊 Project Overview - Visual overview

---

Project Structure

freshin10/
├── apps/
│   ├── web/          # Customer frontend (Next.js 15) — port 3000
│   ├── admin/        # Admin dashboard (Next.js 15) — port 3001
│   ├── delivery/     # Delivery partner app (Next.js 15) — port 3002
│   └── api/          # Backend API (Express + Socket.io) — port 3003
├── packages/
│   ├── ui/           # Shared UI components
│   └── utils/        # Shared utilities, validators, constants
├── .env.example
└── turbo.json

---

Tech Stack

Layer	Technology
Frontend	Next.js 15 (App Router), TypeScript, Tailwind CSS
State	Zustand
Animations	Framer Motion
Backend	Express.js, TypeScript
Database	PostgreSQL + Prisma ORM
Auth	JWT (access + refresh tokens)
Payments	Razorpay
Real-time	Socket.io
Monorepo	Turborepo

---

🚀 Quick Start

Windows Users (Easiest Way)

1. Install dependencies: npm install
2. Setup database: Double-click setup-database.bat
3. Start everything: Double-click start-all.bat
4. Open browser: http://localhost:3000

Or start apps separately:

• Backend: start-backend.bat
• Customer App: start-frontend-web.bat
• Admin Dashboard: start-frontend-admin.bat
• Delivery App: start-frontend-delivery.bat

Manual Setup

1. Install dependencies:

   npm install

2. Setup environment:

   cp .env apps/api/.env
   # Edit apps/api/.env with your values

3. Setup database:

   cd apps/api
   npm run db:generate
   npm run db:push
   npm run db:seed

4. Start development:

   # From root directory
   npm run dev

📚 Detailed Guides

• ⚡ Quick Start: See QUICK_START.md - Get running in 5 minutes
• 🔧 Run Separately: See RUN_SEPARATELY.md - Run backend/frontend independently
• 🏗️ Architecture: See ARCHITECTURE.md - Understand the system design

---

Default Credentials (after seeding)

Role	Email	Password
Admin	admin@freshin10.com	Admin@123

---

API Endpoints

Auth

POST /api/auth/register
POST /api/auth/login
POST /api/auth/refresh
POST /api/auth/logout
GET  /api/auth/me
POST /api/auth/send-otp

Products

GET  /api/products
GET  /api/products/search?q=
GET  /api/products/featured
GET  /api/products/trending
GET  /api/products/:id

Cart

GET    /api/cart
POST   /api/cart/add
PUT    /api/cart/update
DELETE /api/cart/remove/:productId
DELETE /api/cart/clear

Orders

POST /api/orders/create
GET  /api/orders/history
GET  /api/orders/track/:id
POST /api/orders/:id/cancel

Payment

POST /api/payment/create-order
POST /api/payment/verify

Admin (requires ADMIN role)

GET  /api/admin/dashboard
GET  /api/admin/products
POST /api/admin/products
PUT  /api/admin/products/:id
GET  /api/admin/orders
PUT  /api/admin/orders/:id/status
GET  /api/admin/users
POST /api/admin/coupons

---

Deployment

Frontend (Vercel)

1. Connect your GitHub repo to Vercel
2. Set root directory to apps/web (or apps/admin)
3. Add environment variables
4. Deploy

Backend (Railway)

1. Create a new Railway project
2. Connect GitHub repo, set root to apps/api
3. Add environment variables
4. Railway auto-detects Node.js

Database (Supabase)

1. Create a Supabase project
2. Copy the connection string to DATABASE_URL
3. Run npm run db:push

---

Features

Customer App

• 🏠 Premium homepage with hero, categories, offers, trending products
• 🔍 Real-time search with autocomplete
• 🛒 Cart with live updates + mobile sticky bar
• 💳 Razorpay + COD + Wallet payments
• 📍 Address management
• 🎟️ Coupon system
• 📦 Order tracking with real-time updates
• ❤️ Wishlist
• ⭐ Product reviews
• 🔔 Notifications

Admin Dashboard

• 📊 Revenue & orders analytics with charts
• 📦 Products CRUD with inventory management
• 🛍️ Order management with status updates
• 👥 User management
• 🎟️ Coupon management
• ⚠️ Low stock alerts
• 🚚 Delivery partner management

Delivery Partner App

• 📱 Mobile-optimized PWA
• 🟢 Online/Offline toggle
• 📋 Active orders list
• ✅ Pickup & delivery confirmation
• 🗺️ Google Maps navigation
• 💰 Earnings dashboard
• 📡 Real-time location tracking

---

Socket Events

Event	Direction	Description
order:created	Server → Customer	New order placed
order:confirmed	Server → Customer	Payment confirmed
order:status	Server → Customer	Status update
order:delivered	Server → Customer	Order delivered
order:new	Server → Admin	New order alert
delivery:location	Partner → Server	Location update

---

License

MIT © FreshIn10