Skip to content

Frontend showcase of MuscleAdda - Modern React.js e-commerce platform for fitness supplements. Production backend privately hosted.

License

Notifications You must be signed in to change notification settings

tabrez-rabbani/MuscleAdda

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ‹οΈ MuscleAdda - Frontend Showcase

React Vite JavaScript License

🎯 Project Overview

MuscleAdda is a modern, responsive e-commerce platform specialized in fitness supplements and muscle-building products. This repository contains the frontend implementation built with React.js, showcasing modern web development practices, clean UI/UX design, and seamless user experience.

⚠️ Note: This repository contains only the frontend code for portfolio demonstration purposes. The backend API, database, and admin panel are privately hosted as this is a production application currently serving real customers.

✨ Key Features

πŸ›οΈ E-Commerce Functionality

  • Product Catalog: Browse through extensive supplement collections
  • Product Details: Comprehensive product information with images
  • Shopping Cart: Add, remove, and manage cart items
  • Combo Deals: Special product combination offers
  • Order Management: Track and manage customer orders
  • User Authentication: Secure login/registration system

🎨 User Experience

  • Responsive Design: Optimized for all device sizes
  • Modern UI/UX: Clean, intuitive interface design
  • Fast Loading: Optimized performance with Vite
  • Interactive Components: Smooth animations and transitions
  • Search & Filter: Easy product discovery
  • Contact & Support: Customer service integration

πŸ“± Pages Implemented

  • Home: Landing page with featured products
  • Supplements: Product catalog with categories
  • Product Detail: Individual product information
  • Cart: Shopping cart management
  • Orders: Order history and tracking
  • About Us: Company information
  • Contact: Customer support
  • Privacy Policy: Legal compliance
  • Delivery: Shipping information

πŸ› οΈ Technology Stack

Frontend Framework

  • React.js (v18.2.0) - Modern JavaScript library
  • Vite (v5.1.0) - Fast build tool and dev server
  • React Router DOM (v6.22.0) - Client-side routing

UI/UX Libraries

  • React Icons (v5.0.1) - Icon components
  • React Responsive Carousel (v3.2.23) - Image sliders
  • React Toastify (v10.0.4) - Notification system
  • React Intersection Observer (v9.8.0) - Scroll animations

API & State Management

  • Axios (v1.6.7) - HTTP client for API calls
  • React Context API - Global state management
  • Custom Hooks - Reusable logic components

Security & Validation

  • React Google reCAPTCHA (v3.1.0) - Spam protection
  • DOMPurify (v3.0.8) - XSS protection
  • React Helmet Async (v2.0.4) - SEO optimization

Development Tools

  • ESLint - Code quality and consistency
  • Terser - Code minification
  • Vite Plugins - Development enhancement

πŸ—οΈ Project Structure

frontend/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/          # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ Navbar/         # Navigation component
β”‚   β”‚   β”œβ”€β”€ LoginPopup/     # Authentication modal
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ pages/              # Route components
β”‚   β”‚   β”œβ”€β”€ Home/           # Landing page
β”‚   β”‚   β”œβ”€β”€ Supplements/    # Product catalog
β”‚   β”‚   β”œβ”€β”€ Cart/           # Shopping cart
β”‚   β”‚   β”œβ”€β”€ MyOrders/       # Order management
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ Context/            # Global state management
β”‚   β”œβ”€β”€ assets/             # Static resources
β”‚   β”œβ”€β”€ App.jsx             # Main app component
β”‚   └── main.jsx            # Application entry point
β”œβ”€β”€ public/                 # Public assets
β”œβ”€β”€ package.json            # Dependencies and scripts
└── vite.config.js          # Build configuration

πŸš€ Quick Start

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn

Installation

# Clone the repository
git clone [repository-url]
cd muscle-adda-frontend

# Navigate to frontend directory
cd frontend

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

πŸ”’ Security & Privacy

Why Backend is Private?

  • Production Environment: This is a live e-commerce platform serving real customers
  • Sensitive Data: Contains payment gateways, user data, and business logic
  • Security: API keys, database connections, and admin functionalities are protected
  • Compliance: Maintains data privacy and security standards

What's Included Here?

  • βœ… Complete frontend implementation
  • βœ… UI/UX components and design
  • βœ… React architecture and patterns
  • βœ… API integration structure
  • βœ… Responsive design implementation

What's Private?

  • πŸ”’ Backend API and database
  • πŸ”’ Admin panel and dashboard
  • πŸ”’ Payment processing logic
  • πŸ”’ User data and analytics
  • πŸ”’ Production deployment configs

🎨 Key Highlights

πŸ’» Development Skills Demonstrated

  • Modern React Patterns: Hooks, Context API, Custom Hooks
  • Responsive Design: Mobile-first approach
  • Performance Optimization: Code splitting, lazy loading
  • API Integration: RESTful API consumption
  • State Management: Complex application state handling
  • Security Practices: XSS protection, input validation
  • SEO Optimization: Meta tags, semantic HTML

🎯 Business Features

  • E-commerce Flow: Complete shopping experience
  • User Management: Authentication and profile management
  • Order Processing: Cart to checkout flow
  • Product Management: Dynamic product display
  • Content Management: Dynamic content rendering

πŸ“± Live Demo

Note: As this is a production application, the live demo with backend functionality is not publicly accessible. This repository demonstrates the frontend implementation and development skills.

For live demo access or backend code review, please contact:

🀝 Contact

Developer: [Tabrez Rabbani]

πŸ“„ License

This project is proprietary software. The source code is provided for portfolio demonstration purposes only.

All rights reserved. No part of this software may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the developer.

For licensing inquiries, please contact the developer.


⭐ If you're a recruiter or potential collaborator, I'd love to discuss this project and demonstrate the complete application including backend functionality in a private setting!

About

Frontend showcase of MuscleAdda - Modern React.js e-commerce platform for fitness supplements. Production backend privately hosted.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published