🛒 FreshCart – E-Commerce Web Application

Welcome to FreshCart, a modern and responsive e-commerce web application designed to deliver a seamless online shopping experience using the power of Angular, Tailwind CSS, and Flowbite plugins. 🚀

---

🎯 Project Overview

FreshCart is a fully-featured e-commerce platform that replicates real-world online shopping functionalities with a sleek and intuitive UI. It includes advanced features such as cart and wishlist management, order tracking, user authentication, and much more – all built with scalability, performance, and user experience in mind.

---

🔥 Key Features

• 🖥️ Frontend: Angular 19 + Tailwind CSS + Flowbite UI
• ⚙️ State Management: Services, Observables, Interceptors, and Guards
• 🔐 Authentication: JWT-based Login/Register with route protection
• 📦 Cart & Wishlist: Add, update, remove products in real-time
• 🔍 Search & Filtering: Advanced product search and category filters
• 📑 Pagination: Smooth navigation using ngx-pagination
• 🖼️ Image Carousel: NgOwl Carousel for product image previews
• 📦 Order Status Tracking: Real-time delivery status updates based on order time
• ✨ Animations: Angular Animations for enhanced user interaction
• ⏳ Loading Experience: Custom SVG spinners for smoother UX
• ⚠️ Global Error Handling: Centralized error handling via HTTP Interceptors
• 🔔 User Notifications: Toastr notifications for feedback alerts
• ✅ Form Handling: Reactive Forms with full validation
• ⚡ Lazy Loading Modules: Optimized application performance
• 🧪 API Integration & Testing: Built and tested using Postman
• 🧠 Scalable Code Structure: Modular, maintainable, and clean architecture

---

🧠 Tech Stack

• Angular 19
• Tailwind CSS
• Flowbite UI
• Ngx Pagination
• NgOwl Carousel
• Toastr
• Reactive Forms
• Postman
• JWT Authentication

---

📂 Folder Structure

src/
├── app/
│   ├── core/              → Global services, interceptors, guards
│   ├── shared/            → Reusable components, pipes, interfaces
│   ├── modules/           → Feature modules (auth, cart, wishlist, etc.)
│   ├── components/        → Common layout & UI components
│   └── assets/            → Icons, images, SVGs

---

🚀 Installation & Setup

To run this project locally, follow these steps:

# 1️⃣ Clone the repository
git clone https://github.com/Michael-Moris/E-Commerce-App.git
cd E-Commerce-App

# 2️⃣ Install dependencies
npm install

# 3️⃣ Run the development server
ng serve

# 4️⃣ Open in browser
http://localhost:4200

✅ Make sure you have Angular CLI installed globally:

npm install -g @angular/cli

ℹ️ Optional: Setup environment variables if needed (e.g., for API base URLs)

---

💡 Contribution

Want to contribute or suggest improvements? Feel free to fork this repo, submit pull requests, or open issues. Your feedback is always welcome! 💙

---

📜 License

This project is licensed under the MIT License.