Skip to content

Premkolte/MicroMart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •