Skip to content

mdriaz60000/bike-store-client

Repository files navigation

🚲 BikeStore - Modern E-commerce Platform

React TypeScript Tailwind CSS Redux Vite

A modern, responsive e-commerce platform for bike enthusiasts

🌐 Live Demo β€’ πŸ“– Documentation β€’ πŸ› Report Bug


✨ Features

πŸ›οΈ Shopping Experience

  • Product Catalog: Browse through an extensive collection of bikes
  • Advanced Search: Find bikes by category, price, and specifications
  • Product Details: Comprehensive product information with high-quality images
  • Shopping Cart: Seamless add-to-cart functionality with real-time updates
  • Secure Checkout: Streamlined checkout process with order confirmation

πŸ‘€ User Management

  • User Registration & Login: Secure authentication system
  • Profile Management: Update personal information and preferences
  • Order History: Track past purchases and order status
  • Wishlist: Save favorite bikes for later purchase

πŸ” Admin Dashboard

  • Product Management: Add, edit, and delete bike listings
  • Order Management: Process and track customer orders
  • User Management: Monitor user accounts and activities
  • Analytics: Sales reports and performance metrics
  • Inventory Control: Manage stock levels and availability

🎨 User Interface

  • Responsive Design: Optimized for desktop, tablet, and mobile
  • Dark/Light Mode: Toggle between themes for better user experience
  • Modern UI: Clean, intuitive interface with smooth animations
  • Accessibility: WCAG compliant design for all users

πŸ› οΈ Tech Stack

Frontend

  • React 18 - Modern UI library with hooks
  • TypeScript - Type-safe development
  • Tailwind CSS - Utility-first CSS framework
  • Redux Toolkit - State management
  • React Router - Client-side routing
  • Framer Motion - Smooth animations
  • Shadcn/ui - Modern component library

Development Tools

  • Vite - Fast build tool and dev server
  • ESLint - Code linting and formatting
  • PostCSS - CSS processing
  • Bun - Package manager and runtime

πŸš€ Quick Start

Prerequisites

  • Node.js (v18 or higher)
  • npm, yarn, or bun package manager

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/bike-store-client.git
    cd bike-store-client
  2. Install dependencies

    npm install
    # or
    yarn install
    # or
    bun install
  3. Start the development server

    npm run dev
    # or
    yarn dev
    # or
    bun dev
  4. Open your browser Navigate to http://localhost:5173


πŸ“± Screenshots

Home Page Product Details Admin Dashboard
Home Product Admin

πŸ” Admin Access

For testing the admin features, use these credentials:

  • Email: riaz@gmail.com
  • Password: 202020

πŸ“ Project Structure

bike-store-client/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/          # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ layout/         # Layout components
β”‚   β”‚   β”œβ”€β”€ shared/         # Shared components
β”‚   β”‚   └── ui/             # UI components
β”‚   β”œβ”€β”€ pages/              # Page components
β”‚   β”œβ”€β”€ redux/              # Redux store and slices
β”‚   β”œβ”€β”€ Hook/               # Custom React hooks
β”‚   β”œβ”€β”€ routes/             # Routing configuration
β”‚   └── types/              # TypeScript type definitions
β”œβ”€β”€ public/                 # Static assets
└── package.json           # Dependencies and scripts

🎯 Key Features

For Customers

  • βœ… Browse and search bikes by category
  • βœ… Add items to cart and checkout
  • βœ… User registration and authentication
  • βœ… Order tracking and history
  • βœ… Responsive design for all devices
  • βœ… Dark/light theme toggle

For Administrators

  • βœ… Complete product management
  • βœ… Order processing and tracking
  • βœ… User management and analytics
  • βœ… Inventory control
  • βœ… Sales reporting dashboard

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a 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

Development Guidelines

  • Follow TypeScript best practices
  • Use meaningful commit messages
  • Test your changes thoroughly
  • Update documentation as needed

πŸ“„ License

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


πŸ™ Acknowledgments

  • Shadcn/ui for the beautiful component library
  • Tailwind CSS for the utility-first styling
  • Vite for the fast development experience
  • Redux Toolkit for state management

πŸ“ž Support

If you have any questions or need help:


Made with ❀️ by [Your Name]

⬆ Back to top

About

Modern eCommerce UI for a bike store with cart, auth, and dashboard.

Topics

Resources

Stars

Watchers

Forks

Contributors