AsoSphere/Show-Room

Immersive 3D fashion marketplace connecting African designers to the diaspora. Browse garments in a walkable WebGL showroom, pay in USDC, and funds are held in Soroban smart contract escrow until DHL confirms delivery. Built with Next.js 15, React Three Fiber, Stellar, and PostgreSQL.  AsoSphere Immersive 3D storefronts for African designers selling to the diaspora — with on-chain escrow that holds funds until the courier confirms delivery. Browse an Ankara piece in-world, pay from anywhere, get exactly what you saw — or get your money back. --- ## Table of Contents 1. What it is 2. Architecture overview 3. Project structure 4. Getting started 5. Environment variables 6. Running the app 7. Demo routes 8. Soroban contracts 9. API reference 10. 3D asset pipeline 11. Deployment 12. Roadmap --- ## What it is AsoSphere solves the trust gap that blocks diaspora fashion commerce: | Problem | Our fix | |---|---| | Buyers pay via bank transfer and get burned | Soroban escrow holds funds until DHL confirms delivery | | Flat photos misrepresent garments | Every product is a walkable 3D model | | No way to tell a real designer from a scam account | On-chain verified identity + public scam-flag registry | | Card processors freeze African seller accounts | USDC payouts to Stellar wallet; NGN off-ramp via SEP-24 anchor | **Three pillars:** - **See it properly** — walkable in-browser 3D showroom, GLB/Draco/KTX2 models, fabric hotspots, true-scale measurements - **Pay safely** — Soroban smart contract escrow, DHL oracle attestation, 48h buyer inspection window - **Know the seller** — ID + studio video verification, completed-escrow count, public flag registry --- ## Architecture overview ``` ┌─────────────────────────────────────────────────────────┐ │ Frontend — Next.js 15 App Router (TypeScript) │ │ ├─ 3D: React Three Fiber + drei (GLB/Draco/KTX2) │ │ ├─ 2D fallback catalog (server components) │ │ ├─ Auth: localStorage UUID + Freighter wallet │ │ └─ State: Zustand + TanStack Query │ ├─────────────────────────────────────────────────────────┤ │ Backend — Next.js API routes (Node.js runtime) │ │ ├─ Catalog, orders, users, evidence (Postgres) │ │ ├─ Deli …