A modern full-stack e-commerce application for managing and selling sweets online. Built with React, TypeScript, Node.js, Express, and PostgreSQL.

• User Registration & Login - Secure JWT-based authentication
• Browse Sweets - Explore all available sweet products
• Advanced Search - Filter sweets by name, category, and price range
• Shopping Cart - Purchase multiple sweets with quantity selection
• Purchase History - Track all purchases
• Real-time Inventory - See actual stock availability

• Admin Dashboard - Complete inventory management system
• Product Management - Create, read, update, and delete sweets
• Inventory Control - Manage stock levels and restocking
• Sales Analytics - View total inventory value and item counts
• Low Stock Alerts - Real-time notifications for items with less than 10 units
• Category Management - Organize sweets by categories

• Role-Based Access Control - Admin and User roles with different permissions
• JWT Authentication - Secure token-based authentication
• Protected Routes - Frontend and backend route protection
• Admin-Only Operations - Restricted access to admin features
• Password Security - Secure password handling

• React 18 - UI framework
• TypeScript - Type safety
• Tailwind CSS - Styling
• Vite - Build tool
• Axios - HTTP client
• Lucide React - Icons
• React Router - Client-side routing

• Node.js - Runtime
• Express.js - Web framework
• TypeScript - Type safety
• Prisma - ORM
• PostgreSQL - Database
• JWT - Authentication
• Bcrypt - Password hashing
• Vitest - Testing framework

• Node.js (v16 or higher)
• npm or yarn
• PostgreSQL (v12 or higher)
• Git

git clone <repository-url>
cd sweet-shop

cd server

# Install dependencies
npm install

# Create .env file
cp .env.example .env

# Configure your database in .env
DATABASE_URL="postgresql://user:password@localhost:5432/sweet_shop"
JWT_SECRET="your-secret-key-here"
PORT=4000

# Run migrations
npm run migrate

# Start the server
npm run dev

The backend will run on http://localhost:4000

cd ../client

# Install dependencies
npm install

# Create .env file (optional)
echo 'VITE_API_URL=http://localhost:4000/api' > .env.local

# Start the development server
npm run dev

The frontend will run on http://localhost:5173

sweet-shop/
├── client/                          # React Frontend
│   ├── src/
│   │   ├── components/             # Reusable UI components
│   │   │   ├── SweetCard.tsx       # Product card component
│   │   │   ├── ProtectedRoute.tsx  # Route protection wrapper
│   │   │   ├── Layout/             # Layout components
│   │   │   └── UI/                 # UI components (Button, Input, Modal, etc.)
│   │   ├── contexts/               # React contexts
│   │   │   └── AuthContext.tsx     # Authentication state management
│   │   ├── lib/                    # Utilities and API client
│   │   │   ├── api.ts              # Axios API client
│   │   │   ├── auth.ts             # Auth utilities
│   │   │   └── utils.ts            # Helper functions
│   │   ├── pages/                  # Page components
│   │   │   ├── Login.tsx           # Login page
│   │   │   ├── Register.tsx        # Registration page
│   │   │   ├── Dashboard.tsx       # User dashboard
│   │   │   └── AdminPanel.tsx      # Admin dashboard
│   │   ├── App.tsx                 # Main app component
│   │   └── main.tsx                # Entry point
│   └── package.json
│
├── server/                          # Express Backend
│   ├── src/
│   │   ├── modules/                # Feature modules
│   │   │   ├── auth/               # Authentication routes/controllers/services
│   │   │   └── sweets/             # Products routes/controllers/services
│   │   ├── middleware/             # Express middleware
│   │   │   ├── authMiddleware.ts   # Auth verification
│   │   │   ├── roleMiddleware.ts   # Role-based access
│   │   │   └── validate.ts         # Request validation
│   │   ├── common/                 # Shared utilities
│   │   │   ├── errors/             # Custom error classes
│   │   │   └── jwt/                # JWT utilities
│   │   ├── app.ts                  # Express app setup
│   │   ├── server.ts               # Server entry point
│   │   └── prisma.ts               # Prisma client
│   ├── prisma/
│   │   ├── schema.prisma           # Database schema
│   │   └── migrations/             # Database migrations
│   └── package.json
│
└── README.md

• Register and login
• Browse and search sweets
• Make purchases
• View purchase history

• All customer features plus:
• Create/Read/Update/Delete sweets
• Manage inventory levels
• View sales analytics
• Manage low stock alerts

• POST /api/auth/register - Register new user
• POST /api/auth/login - Login user

• GET /api/sweets - Get all sweets
• GET /api/sweets/search - Search sweets by criteria
• POST /api/sweets/:id/purchase - Purchase sweets

• POST /api/sweets - Create new sweet
• PUT /api/sweets/:id - Update sweet details
• DELETE /api/sweets/:id - Delete sweet
• POST /api/sweets/:id/restock - Add to stock

model User {
  id        String   @id @default(cuid())
  email     String   @unique
  password  String
  name      String?
  role      Role     @default(USER)
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
}

enum Role {
  USER
  ADMIN
}

model Sweet {
  id        String   @id @default(cuid())
  name      String
  category  String
  price     Float
  quantity  Int
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
}

cd server
npm run test

• Use the provided UI to test features
• Test with both admin and user roles
• Verify role-based access controls

cd client
npm run build
# Deploy the dist/ folder to Vercel

cd server
npm run build
# Deploy to your hosting provider

Backend (.env)

DATABASE_URL=your_postgresql_url
JWT_SECRET=your_secret_key
NODE_ENV=production
PORT=4000

Frontend (.env.local)

VITE_API_URL=https://your-api-url.com/api

• Dark Theme - Eye-friendly dark interface
• Responsive Design - Works on all devices
• Toast Notifications - User feedback for actions
• Loading States - Smooth loading indicators
• Modal Dialogs - Confirmation and input modals
• Real-time Updates - Data refreshes after actions
• Price Display - All prices shown in Indian Rupees (₹)

Admin Account

• Email: admin@sweetshop.com
• Password: admin@123

Regular User Account

• Email: user@sweetshop.com
• Password: user@123

• Port already in use: Change PORT in .env
• Database connection error: Verify DATABASE_URL
• JWT errors: Ensure JWT_SECRET is set

• API connection error: Check VITE_API_URL
• CORS errors: Verify backend CORS configuration
• Build errors: Run npm install and clear cache

• React Documentation
• Express.js Guide
• Prisma Docs
• Tailwind CSS

This project is licensed under the MIT License - see the LICENSE file for details.

For issues and questions, please create an issue in the repository.

Built with ❤️ using React, Node.js, and PostgreSQL