Premkolte/MicroMart

โ˜… 5Forks 0DartGitHub โ†—Compare

Project website โ†—

README

MicroMart - Complete E-commerce Solution

A comprehensive e-commerce platform featuring both a modern web application and a mobile Flutter app, providing seamless shopping experiences across all devices.

๐ŸŒ Live Demo

๐Ÿ“ฑ Project Overview

MicroMart is a full-stack e-commerce solution that includes:

  • Web Application (MERN-Website): A responsive React-based e-commerce website
  • Mobile Application (Android-App): A Flutter-based mobile application

๐Ÿš€ Tech Stack

Web Application (MERN-Website)

  • Frontend: React 18, TypeScript
  • State Management: Redux Toolkit, Redux Thunk
  • Routing: React Router v6
  • Styling: SCSS, Framer Motion
  • HTTP Client: Axios
  • UI Components: SwiperJS for carousels
  • Build Tool: Vite
  • Deployment: Vercel

Mobile Application (Android-App)

  • Framework: Flutter
  • Language: Dart
  • Platform: Android (with iOS support)

โœจ Features

Web Application

  • ๐ŸŽจ Fully responsive design
  • ๐Ÿ›’ Add to cart functionality
  • ๐Ÿ—‘๏ธ Remove items from cart
  • ๐Ÿ’ณ Checkout process
  • ๐Ÿ–ผ๏ธ Lazy loading of images
  • โšก Image optimization
  • ๐Ÿ” Quick view for products
  • ๐Ÿ“„ Detailed product pages
  • ๐Ÿ›๏ธ Shopping cart management
  • ๐Ÿ” User authentication/login
  • ๐Ÿ“ฑ Mobile-first responsive design
  • ๐ŸŽญ Smooth animations with Framer Motion

Mobile Application

  • ๐Ÿ“ฑ Native mobile experience
  • ๐Ÿ›’ Shopping cart functionality
  • ๐Ÿ“ฆ Product browsing
  • ๐Ÿ‘ค User authentication
  • ๐ŸŽจ Modern UI/UX design

๐Ÿ“ Project Structure

MicroMart/
โ”œโ”€โ”€ MERN-Website/           # React Web Application
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ app/           # Redux store configuration
โ”‚   โ”‚   โ”œโ”€โ”€ components/    # Reusable React components
โ”‚   โ”‚   โ”œโ”€โ”€ features/      # Feature-based modules
โ”‚   โ”‚   โ”œโ”€โ”€ pages/         # Page components
โ”‚   โ”‚   โ”œโ”€โ”€ routes/        # Routing configuration
โ”‚   โ”‚   โ””โ”€โ”€ types/         # TypeScript type definitions
โ”‚   โ”œโ”€โ”€ public/            # Static assets
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ””โ”€โ”€ vite.config.ts
โ”œโ”€โ”€ Android-App/           # Flutter Mobile Application
โ”‚   โ”œโ”€โ”€ lib/
โ”‚   โ”‚   โ”œโ”€โ”€ main.dart      # Main application entry
โ”‚   โ”‚   โ”œโ”€โ”€ Dataset/       # Data models
โ”‚   โ”‚   โ”œโ”€โ”€ Items/         # UI components
โ”‚   โ”‚   โ””โ”€โ”€ Screens/       # App screens
โ”‚   โ”œโ”€โ”€ android/           # Android-specific files
โ”‚   โ”œโ”€โ”€ ios/              # iOS-specific files
โ”‚   โ”œโ”€โ”€ images/           # Image assets
โ”‚   โ””โ”€โ”€ pubspec.yaml
โ””โ”€โ”€ vercel.json           # Deployment configuration

๐Ÿ› ๏ธ Installation & Setup

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn
  • Flutter SDK (for mobile app)
  • Android Studio / VS Code

Web Application Setup

  1. Clone the repository
git clone https://github.com/Premkolte/MicroMart.git
cd MicroMart
  1. Navigate to web application directory
cd MERN-Website
  1. Install dependencies
npm install
  1. Start development server
npm run dev
  1. Build for production
npm run build

Mobile Application Setup

  1. Navigate to Flutter app directory
cd Android-App
  1. Install Flutter dependencies
flutter pub get
  1. Run the app
flutter run
  1. Build APK
flutter build apk

๐Ÿ“ฑ Screenshots

Web Application

Landing Page

Landing Page

Collections

Collections

Product Details

Product Details

Cart Modal

Cart Modal

Shopping Bag

Shopping Bag

๐Ÿš€ Deployment

Web Application (Vercel)

The web application is automatically deployed to Vercel when changes are pushed to the main branch.

Deployment URL: https://micro-mart-nk302zcbt-premkoltes-projects.vercel.app

Mobile Application

The Flutter app can be built and distributed through:

  • Google Play Store (Android)
  • Apple App Store (iOS)
  • Direct APK distribution

๐Ÿค Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“ Available Scripts

Web Application

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint

Mobile Application

  • flutter run - Run the app
  • flutter build apk - Build Android APK
  • flutter build ios - Build iOS app
  • flutter test - Run tests

๐Ÿ› Issues & Support

If you encounter any issues or have questions, please create an issue in this repository.

๐Ÿ“„ License

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

๐Ÿ‘จโ€๐Ÿ’ป Author

Prem Kolte


โญ If you found this project helpful, please give it a star!

Contributors

PremkolteAinirzv

Issues