patrickjambo/Isoko_Market

# Isoko Market **Connecting Communities • Empowering Trade** A trust-first, multilingual (Kinyarwanda / English / French) **marketplace + job board** for Rwandan youth, built to the _Isoko Market Web Platform Development Brief_. > Buy, sell, and find work with verified people. Phone-OTP login, mobile-money > payments, a built-in CV builder, and real-time chat — designed to work well on > slow connections and older phones. Stack: **Next.js 14 (App Router) · TypeScript (strict) · PostgreSQL · Prisma · Tailwind CSS + shadcn/ui · Server-Sent-Events real-time**. --- ## Quick start ```bash # 1. Install dependencies npm install # 2. Start the self-contained local Postgres cluster (no sudo needed, port 5544) ./scripts/db.sh start # 3. Apply the schema and seed demo data npx prisma db push npm run db:seed # 4. Run the app npm run dev # → localhost (redirects to /rw) ``` Environment is pre-configured in `.env` for local development. See `.env.example` for the full list of secrets a production deployment needs. ### Demo accounts Login is by **phone OTP**. In development the OTP is **printed to the server console** (`SMS_PROVIDER=console`) instead of being sent by SMS. | Role | Phone | Notes | | -------- | --------------- | ------------------------------ | | Admin | `0788000000` | Access `/admin` | | Seller | `0788111111` | Aline — verified | | Seller | `0788222222` | Eric — verification pending | | Employer | `0788333333` | Claudine — verified | | Buyer | `0788444444` | Jean-Paul — unverified, has CV | Log in → watch the terminal for `📱 [SMS → …] your verification code is 123456`. --- ## Scripts | Command | Purpose | | ------------------- | --------------------------------------------------- | | `npm run dev` | Dev server | | `npm …