Full-stack e-commerce platform for Oshocks Junior Bike Shop. React frontend with Tailwind CSS, Laravel backend with MySQL database. Features: product catalog, shopping cart, user authentication, multi-vendor support, M-Pesa & Stripe payment integration, live chat, and comprehensive admin/seller dashboards. Built for Kenya's cycling marketplace.
# Oshocks Junior Bike Shop
> Kenya's Premier Cycling E-Commerce Marketplace
A comprehensive multi-vendor e-commerce platform for cycling products in Kenya, combining the functionality of Amazon and Alibaba with local payment integration and marketplace features.
## 🎯 Project Vision
Oshocks Junior Bike Shop is building Kenya's central hub for cycling enthusiasts—a fully-featured marketplace that connects bicycle sellers with customers nationwide. Starting as an online extension of a physical cycling shop in Nairobi, the platform is designed to scale into a thriving multi-vendor ecosystem.
## ✨ Key Features
### For Customers
- **Advanced Product Discovery** - Intelligent search and filtering across thousands of products
- **Personalized Experience** - User accounts with shopping carts, wishlists, and order history
- **Product Reviews & Ratings** - Community-driven feedback system
- **Live Chat Support** - Real-time customer assistance via Tawk.to
- **Mobile-First Design** - Seamless experience across all devices
### For Sellers
- **Vendor Dashboards** - Complete inventory and order management
- **Product Listing Tools** - Easy product creation with image uploads
- **Sales Analytics** - Track performance and revenue
- **Order Fulfillment** - Streamlined order processing workflow
### Payment & Transactions
- **M-Pesa Integration** - Safaricom Daraja API for mobile money
- **Card Payments** - Stripe/Flutterwave for international transactions
- **Secure Processing** - PCI-compliant payment handling
- **Email Notifications** - Automated order confirmations and updates
## 🏗️ Architecture
### Frontend
- **Framework**: React.js 18.x
- **Styling**: Tailwind CSS
- **State Management**: Redux / React Context API
- **Deployment**: Vercel / Netlify
### Backend
- **Framework**: Laravel 10.x (PHP)
- **API**: RESTful architecture
- **Authentication**: Laravel Sanctum / Passport
- **Deployment**: Railway.app / Render.com
### Database
- **Primary DB**: MySQL
- **Cachin …