Introductionh3

Breadzy is a full-stack e-commerce website specializing in bread and food products. Built with a modern architecture separating Backend API (Node.js + Express + MongoDB) and Frontend (Angular 20), ensuring scalability and easy maintenance.

Featuresh3

Authentication & User Management:

• Register and login with JWT Authentication
• Role-based access: Admin, User
• Profile and shipping address management
• Password recovery via email (Nodemailer)
• Cookie-based session management

Product Management:

• CRUD operations with pagination
• Category management
• Image upload and management (Multer)
• Product search and filtering
• Slug-based URLs for SEO
• Inventory management

Shopping Cart & Orders:

• Add/remove/update cart items
• Real-time stock validation
• Order management and status tracking
• Purchase history

Admin Dashboard:

• Statistics dashboard
• Product, order, and user management
• Category management

Screenshotsh3

Tech Stackh3

Frontend

• Angular 20.0.0
• NG-ZORRO (Ant Design) 20.0.0
• TailwindCSS 4.1.11
• Lucide Angular (Icons)
• RxJS 7.8.0

Backend

• Node.js with Express 5.1.0
• MongoDB + Mongoose 8.14.1
• JWT Authentication
• Multer 2.0.1 (File Upload)
• Nodemailer 7.0.0 (Email)
• Swagger/OpenAPI 3.0

Getting Startedh3

# Clone repository
git clone https://github.com/kittenwarrior-qb/breadzy.git
cd breadzy

# Backend
cd be
npm install
cp .env.example .env
# Configure MongoDB and JWT_SECRET in .env
npm run dev

# Frontend (new terminal)
cd ../fe
npm install
npm start

Services:

• Frontend: http://localhost:4200
• Backend API: http://localhost:3000
• API Docs: http://localhost:3000/api-docs