33-44-53/harar-artisans-marketplace

# Harar City Artisans Digital Broker A modern web-based marketplace platform connecting Ethiopian artisans with global buyers, featuring secure transactions, mobile-first design, and comprehensive management tools. ## 🌟 Features ### Core User Roles - **Artisans (Sellers)**: Product management, order tracking, sales analytics - **Buyers (Customers)**: Product browsing, secure checkout, order history - **Brokers/Admins**: Platform management, user verification, dispute resolution ### Key Functionality - **Product Management**: Upload images, manage inventory, real-time tracking - **Secure Payments**: Telebirr, CBE Birr, Bank Transfer, Cash on Delivery - **Order Management**: Real-time status updates, delivery tracking - **User Authentication**: Role-based access control, secure sessions - **Mobile-First Design**: Responsive UI optimized for all devices - **Search & Filtering**: Advanced product discovery with AI-powered recommendations ## 🛠 Tech Stack - **Frontend**: React 19, TypeScript - **Styling**: Tailwind CSS with custom Ethiopian-inspired design tokens - **Routing**: React Router DOM - **State Management**: React Context API - **Icons**: Lucide React - **Build Tool**: Vite - **Package Manager**: npm ## 🚀 Quick Start ### Prerequisites - Node.js 18+ - npm or yarn ### Installation 1. **Clone the repository** ```bash git clone cd artisan-connect ``` 2. **Install dependencies** ```bash npm install ``` 3. **Start development server** ```bash npm run dev ``` 4. **Open in browser** Navigate to `localhost` ### Demo Accounts Test the platform with these demo credentials: - **Admin**: admin@harar.com / password - **Artisan**: artisan@harar.com / password - **Buyer**: buyer@harar.com / password ## 📱 Key Pages & Features ### Public Pages - **Home**: Hero section, featured products, platform statistics - **Products**: Advanced filtering, search, grid/list views - **Product Detail**: Image gallery, artisan info, reviews, add to cart - **Login/Reg …