Marketplace Platform

Stlm

Full-stack marketplace platform for Kuwait's food-delivery and e-commerce ecosystem, built on a config-driven GCC commerce core — Kuwait-first, engineered to span the Gulf, where a new brand or market ships as a deployment profile rather than a fork. Six interconnected portals spanning 87 production-ready pages — from consumer storefronts with TAP Payments (mada, KNET, Apple Pay) to partner dashboards, per-market tax compliance including ZATCA (Fatoora) Phase-2 e-invoicing for Saudi Arabia, and a courier mobile app with iOS Live Activities for real-time delivery tracking.

● Production ⚙ Config-Driven Core 🌍 GCC-ready · Kuwait-first 🇸🇦 ZATCA (Fatoora) Phase-2 💱 TAP Payments (mada, KNET, Apple Pay)

Pages Built

Portals

API-Connected

Languages

380+

CDN Images

100%

Production Ready

Portal Breakdown

Portal	Pages	API Connected	Status
Customer Storefront	37	16	✅ Ready
Authentication	7	6	✅ Ready
Customer Account	8	8	✅ Ready
Admin Dashboard	16	16	✅ Ready
Partner Portal	13	12	✅ Ready
Courier App	6	6	✅ Ready
Total	87	64	100% Production

Architecture

🌐

Web — Customer Storefront

Next.js 16.1 with App Router. Tailwind CSS v4, Radix UI, shadcn/ui. 4-language i18n (EN, AR RTL, Hindi, Filipino). Real-time order tracking via Socket.IO.

Next.js 16.1React 19.2Tailwind v4next-intlSocket.IO

⚙

API — Backend

Express.js with TypeScript. Prisma ORM on PostgreSQL. JWT + refresh tokens (httpOnly cookies). TAP Payments split payments with commission. WhatsApp Commerce via Meta Cloud API.

Express.js 4.21Prisma 5.22Socket.IOTAP PaymentsWhatsApp APIPuppeteer

📱

Mobile — React Native

Expo SDK 55 with native modules. iOS Live Activities via ActivityKit + SwiftUI Widget Extension. Push notifications with expo-server-sdk + APNs.

Expo SDK 55React NativeLive ActivitiesPush Notifications

🗃

Shared Packages

Monorepo with Turbo 2.3. Shared database (Prisma), types, UI components, and utilities (currency KWD 3-decimal, date Kuwait timezone).

Turbo 2.3npm workspacesPrismaShared Types

⚙

Config-Driven GCC Core

One codebase, many storefronts across the GCC. A new brand or market ships as a deployment profile (env + config), never a fork. Pluggable provider seams swap payment rails (TAP: mada/KNET) and tax-compliance backends per market — including ZATCA (Fatoora) Phase-2 e-invoicing for Saudi Arabia.

GCC MarketsConfig ProfilesProvider SeamsZATCA e-invoicingTurborepo

Platform Gallery

Multi-screen overview — vendor portal, mobile app, customer storefront & marketplace homepage

App Store screenshots — delivery, store browsing, checkout, vendor pages & order tracking

Key Features

Config-Driven Multi-Brand Core

New brands and markets launch as deployment profiles, not code forks — one engine, many storefronts, themed and configured per market.

Pluggable Provider Seams

Payment and e-invoicing providers swap per market behind a stable interface — TAP (mada/KNET) across the GCC, ZATCA (Fatoora) Phase-2 e-invoicing for Saudi Arabia — so processors and tax compliance vary by country without touching core logic.

Multi-Vendor Marketplace

Order splitting by vendor, commission system, vendor payouts, separate tracking per vendor order.

TAP Payments

mada (KSA), KNET (Kuwait), credit/debit cards, Apple Pay, Google Pay, 3D Secure. Split payments with marketplace commission.

WhatsApp Commerce

Meta Cloud API v21.0 — catalog sync, order webhooks, payment links, team notifications, OTP verification.

iOS Live Activities

Lock Screen + Dynamic Island real-time order tracking via ActivityKit + SwiftUI Widget Extension.

Real-Time Tracking

Socket.IO for order status updates. Live delivery tracking. Push notifications via Expo + APNs.

Bilingual Invoices

Puppeteer-generated PDF invoices with English/Arabic side-by-side. Auto-sent via email on order completion.

4-Language i18n

English, Arabic (full RTL), Hindi, Filipino. next-intl with locale-based routing.

Cloudflare R2 CDN

380+ product images served via R2. Optimized delivery with global edge caching.

CI/CD Pipeline

Monorepo CI gate (turbo build + test) on every push, PR-based workflow, and a dedicated mobile build pipeline. Typecheck + Prisma validation before merge.

Deployment

Frontend

Auto-deploy from main branch. Preview deploys on PRs.

Next.jsAuto-deploy

Backend

Docker, auto-deploy via GitHub Actions when API or packages change.

DockerGitHub Actions

Database

Managed PostgreSQL.

PostgreSQL