asvisioned-commits/biker

Biker - Zimbabwe's trust-first peer-to-peer logistics platform # 🚴 Biker **Zimbabwe's trust-first peer-to-peer logistics platform.** Send items, buy groceries, pick up food, run errands — all with protected payments, verified riders, and provable delivery chains. ## The Core Promise | 🛡️ Money protected | ✓ Riders verified | 📸 Delivery provable | ⚖️ Disputes resolvable | 👁️ Everything visible | |---|---|---|---|---| ## Tech Stack - **Frontend**: Next.js 16 (App Router), TypeScript, CSS Modules - **Auth**: Supabase Auth (Google OAuth, Email, Phone OTP) - **Database**: Supabase (PostgreSQL + RLS + Realtime) - **Design System**: "Calm Trust" — semantic tokens, Inter font, layered shadows - **Maps**: Leaflet.js (coming soon) ## Services | Service | Description | |---|---| | 📦 **Send Item** | Point-to-point delivery with proof chain | | 🛒 **Buy For Me** | Shopping + delivery with receipt OCR | | 🏪 **Pick Up Order** | Collect from merchants | | 📄 **Document Run** | Queue at offices, return with documents | | ⏳ **Queue Service** | Wait in line on your behalf | | 📍 **Multi-Stop** | Multiple pickups/dropoffs in one trip | ## Speed Modes | Mode | Description | |---|---| | 🚴 Standard | Regular delivery | | ⚡ Biker Jet | Priority dispatch, fastest rider, premium rate | | 📅 Scheduled | Book for a future time slot | ## Protection Levels | Level | What's Protected | |---|---| | None | Cash on delivery — no escrow | | 🛡️ Protected | PIN-verified delivery, escrow hold, dispute eligible | | 🛡️+ Protect Plus | Insurance, priority dispute, photo+signature required | ## Getting Started ```bash # Install dependencies npm install # Set up environment cp .env.example .env.local # Add your Supabase URL, anon key, and Google OAuth credentials # Run development server npm run dev ``` ## Environment Variables ```env NEXT_PUBLIC_SUPABASE_URL=your-project-url NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key NEXT_PUBLIC_DEV_MODE=true # Set false in production ``` ## Project Structure ``` src/ ├── app/ │ ├── auth/callback/ # OAuth call …