README.md

metadata

title: Cellex Web
emoji: 🛍️
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Nigeria's

Cellex — Nigeria's #1 Social Commerce Marketplace

Next.js 16 (App Router) frontend for the Cellex platform — a Nigerian social ecommerce marketplace with live shopping, group buys, AI-powered discovery, and unified WhatsApp + Telegram cross-platform shopping.

What's inside

• Buyer flow: home, product detail, cart, checkout, PalmPay bank-transfer payment, orders, wishlist, profile
• Discovery: categories, search, seller storefronts, video feed, trending, AI recommendations
• Live shopping: browse live sessions, watch with real-time chat, featured product buy
• Group buys: Pinduoduo-style group discounts unlocked at target count
• Cross-platform: link WhatsApp bot with unified cart, Telegram channel alerts
• Seller center: dashboard, product CRUD, orders, profile, go-live, product videos, 24h stories

Architecture

• Frontend: Next.js 16 App Router + React + TypeScript + Tailwind CSS 4 + shadcn/ui
• Backend: 27 Supabase Edge Functions (Deno) — unchanged from prior phases
• Auth: HTTP-only cookies → web_sessions table → JWT verify in edge functions
• Payment: PalmPay bank transfer with Gmail-IMAP auto-verification (Render bot)
• AI: Qwen2.5-72B powering product recommendations and shopping assistant

Deployment

This Space uses the Docker SDK. The Dockerfile:

1. Builds the Next.js app with output: "standalone"
2. Copies the standalone server + static assets to a slim Node 20 image
3. Serves on port 7860 (HF Spaces default)

Environment variables (set in HF Space settings)

SUPABASE_URL=https://tcwdbokruvlizkxcpkzj.supabase.co
SUPABASE_ANON_KEY=...   (Supabase anon key)
SUPABASE_SERVICE_KEY=... (optional, only if you upload videos via web-server)
GMAIL_EMAIL=...         (optional, only if running payment verifier here)
GMAIL_APP_PASSWORD=...

Note: Most existing edge functions, the payment verifier, and WhatsApp/Telegram bots are NOT run here — they continue running on Render / Supabase. This Space only hosts the Next.js web frontend.