Full-stack e-commerce platform for Nigeria built with Laravel 11 and React TypeScript. Features Paystack payments, admin dashboard, and Docker deployment.
# NaijaShop - E-commerce Platform
A complete e-commerce platform built with Laravel 11 (Backend API) and React with TypeScript (Frontend).
## Project Structure
```
NaijaShop/
├── backend/ # Laravel 11 API
│ ├── app/
│ │ ├── Http/
│ │ │ ├── Controllers/
│ │ │ ├── Middleware/
│ │ │ ├── Requests/
│ │ │ └── Resources/
│ │ ├── Models/
│ │ ├── Services/
│ │ ├── Notifications/
│ │ └── Policies/
│ ├── config/
│ ├── database/
│ │ ├── migrations/
│ │ ├── seeders/
│ │ └── factories/
│ └── routes/
├── frontend/ # React TypeScript App
│ ├── src/
│ │ ├── components/
│ │ ├── pages/
│ │ ├── context/
│ │ ├── hooks/
│ │ ├── services/
│ │ ├── types/
│ │ └── utils/
│ └── public/
└── README.md
```
## Features
### Customer Features
- User registration and authentication
- Email verification
- Product browsing with search and filters
- Product categories with hierarchy
- Shopping cart with persistence
- Discount coupon system
- Secure checkout process
- Paystack payment integration
- Order tracking
- Order history
- Product reviews and ratings
- Wishlist
- Recently viewed products
- Newsletter subscription
### Admin Features
- Dashboard with analytics
- Product management (CRUD, bulk actions, image uploads)
- Category management with hierarchy
- Order management with status updates
- Customer management
- Coupon management
- Sales reports
- Low stock alerts
- Refund processing
## Tech Stack
### Backend
- **Framework:** Laravel 11
- **Authentication:** Laravel Sanctum
- **Database:** MySQL
- **Payment:** Paystack
- **PDF Generation:** DomPDF
- **Image Processing:** Intervention Image
- **Queue:** Database driver
### Frontend
- **Framework:** React 18
- **Language:** TypeScript
- **Routing:** React Router v6
- **State Management:** React Context + React Query
- **Styling:** Tailwind CSS
- **HTTP Client:** Axios
- **Form Handling:** React Hook Form + Zod
- **Icons:** Luci …