MELA — an Ethiopian digital ecosystem connecting freelancers, creators, entrepreneurs, traders, and communities through one identity, marketplace, social network, and digital platform.
# OG — One Identity, Every Community
A modern clone of the **OG ecosystem (ogf4m)** — a unified community platform bringing **Freelancing, Dropshipping, and Trading** together under one sovereign identity and handle.
The application is built with **Next.js 15, React 19, TypeScript, Tailwind CSS, Supabase, and Clerk**, with a dual-mode architecture that allows the entire application to run locally without external credentials.
## 🌐 Published Website
**Live Demo:**
ogf4m-eth.web.app
The project is deployed and publicly available for demonstration.
---
## ✨ Features
* 🔐 Authentication with Clerk
* 👤 Sovereign user identity and `@handle`
* 🏠 Personalized dashboard
* 💼 Freelancing marketplace
* 🧙 Freelancing wizard
* 📦 Gigs and marketplace management
* 💰 Invoices with ETB support
* 💬 Direct messaging
* 🌐 Community rooms
* 📝 Community posts and comments
* ❤️ Post interactions and likes
* 👥 Followers and following
* 📈 Trading community with waitlist
* ⚙️ Profile and account settings
* 🛡️ Admin functionality
* 🖼️ Profile/avatar upload
* 🏆 `mela` reputation score
* 📱 Responsive modern interface
* 🎨 Custom OG visual design system
* 📴 Fully functional local/demo mode without credentials
---
## 🚀 Running Locally
Clone the repository and install dependencies:
```bash
npm install
```
Start the development server:
```bash
npm run dev
```
Open:
```text
localhost
```
The project can run immediately in **local demo mode** without configuring Supabase or Clerk.
---
## 🧪 Demo Mode
The application automatically falls back to a local adapter when the required production environment variables are not configured.
Demo mode uses:
* `localStorage`
* Seeded demo users
* Seeded gigs
* Seeded communities
* Seeded room posts
* Local application state
This allows the complete interface to be explored without external services.
### Demo Flow
1. Start the application.
2. Open `
localhost`.
3. Use the available demo/sign-in flow.
4. Select a ` …