# π KelalShop: The Hybrid Importer Marketplace
KelalShop is a premium, high-performance marketplace platform built for the modern Ethiopian economy. It bridges the gap between local buyers and verified international shoppers/importers, combining traditional e-commerce listings with a bespoke "item request" service.
*(Note: Add your actual preview image here)*
---
## π Key Features
### π’ Dual-Role Ecosystem
- **Shoppers (Importers)**: Create professional storefronts, list imported goods, manage inventory, and provide custom shopping services.
- **Buyers**: Browse products, track orders, and interact directly with importers.
### π¦ Item Requests (Concierge Service)
- Buyers can post specific items they need (using links from Amazon, AliExpress, Shein, etc.).
- Shoppers can respond to these requests, quote prices, and handle the entire import process.
### π¬ Real-time Secure Chat
- Built-in negotiation system powered by **Supabase Realtime**.
- Direct buyer-to-shopper communication specifically linked to active orders and requests.
### π‘οΈ Identity Verification (Trust System)
- Robust verification workflow where shoppers upload government-issued IDs.
- Verified shoppers receive the **"Verified Importer"** amber badge to build buyer confidence.
### π Comprehensive Dashboard
- Dedicated, role-aware dashboards for managing products, incoming requests, and order status.
---
## π οΈ Technical Stack
- **Framework**: Next.js 16 (App Router)
- **State Management**: React 19 Server Actions & `useActionState`
- **Database & Auth**: Supabase (PostgreSQL + RLS)
- **Styling**: Tailwind CSS v4
- **Realtime Services**: Supabase Realtime Channels
- **File Storage**: Supabase Storage Buckets (Avatars, Products, ID Documents)
---
## π Installation & Setup
### 1. Initial Setup
```bash
# Clone the repository
git clone
github.com
# Install dependencies
npm install
```
### 2. Configure Environment Variables
Copy `.env.example` to `.env.local` a β¦