🛒 E-Commerce Customer App (Flutter)

A modern full-stack e-commerce application built using Flutter for the frontend and Node.js + Express + MongoDB for the backend. The app supports authentication, product browsing, cart management, secure checkout, and scalable backend APIs. This project supports Android and Web from a single Flutter codebase.

Test now at https://super-haupia-a2f0fd.netlify.app/

Mobile UI

Web UI

---

🚀 Features

Cross Platform

• Single codebase for Android and Web using Flutter

Authentication

• JWT-based authentication and authorization
• Secure password reset flow

Product & Catalog

• Product listing with categories
• Product detail page
• Search and filter functionality
• Pagination / infinite scroll support

Cart & Orders

• Add/remove products from cart
• Quantity management
• Checkout flow
• Address management
• Order history

Media Support

• Product image upload (Cloudinary)
• Support for PDFs and GIFs (planned)

UI & UX

• Clean dark and light theme UI
• Custom theme system
• Modern responsive layouts
• State management using Provider
• Uses modern skeleton loading screens

---

🧰 Tech Stack

Frontend (Mobile App & Web)

• Flutter (Dart)
• Provider for state management
• Dio for HTTP networking
• Google Fonts and custom themes

Backend

• Node.js + Express.js
• MongoDB Atlas
• JWT authentication
• OTP verification system
• Cloudinary for media storage
• Redis for caching (homepage products)
• MongoDB atomic transactions for order placement

Infrastructure (Free Tier)

• MongoDB Atlas (M0 Cluster)
• Redis Cloud (30MB Free)
• Cloudinary Free Tier

---

📦 Deployment

Backend

• Deployed using free Node.js hosting
• MongoDB Atlas as primary database

Mobile & Web App

• Play App Signing enabled for Android
• Web deployed via Flutter Web build

Admin Panel

• Web-based admin dashboard built in Flutter
• Manages products, orders, users, and content n---

🔔 Notifications

• Push notifications implemented for user events and order updates,
• Uses FCM tokens and Firebase Cloud Messaging module for node js

---

🧪 Testing

• Manual UI testing
• API testing via Postman
• Release mode testing via APK

---

🛠️ Planned Features

• Payment gateway integration (Razorpay/Stripe)
• Analytics dashboard for admin
• AI-based product recommendations

---

🧠 Developer Notes

• JWT token is not decoded on the frontend to extract user ID so it is safer
• Redis caching used for homepage product performance
• MongoDB atomicity ensured for order placement
• Focus on scalable free-tier infrastructure and cost efficiency

---

📜 License

This project is for educational and personal portfolio use.

---

👨‍💻 Author

Prathvi Raj Chauhan Flutter & Full Stack Developer