Storefront Setup
Create the public storefront customers use to browse products and start clean orders.
The storefront is the first operating surface for most sellers and resellers. It is the page customers open from WhatsApp, Instagram, TikTok, Nova, or a shared product link.
Create a storefront
From /onboard, choose Seller or Reseller, then continue to /onboard/storefront.
The setup flow asks for:
| Field | Purpose |
|---|---|
| Category | Helps group the store and fetch relevant product categories. |
| Logo | Gives the storefront a recognizable identity. |
| Store name | The public name customers see. |
| Phone | The contact number for order coordination. |
| Store link | The public uraibu.com handle. |
| Primary color | Used for storefront accents and preview styling. |
| Media aspect ratio | Controls how product images appear in the catalog grid. |
Use a short store link that customers can remember and type. A good link looks like
freshbakes.uraibu.com, not fresh-bakes-nairobi-branch-2.uraibu.com.After creation
When the storefront is created, Uraibu should route the seller into quickstart setup:
/onboard/storefront/{reference}/products
/onboard/storefront/{reference}/delivery
/onboard/storefront/{reference}/payments
The reference should come from the backend in production. During prototyping it can be derived from the store handle, but the API should eventually own it.
Product readiness checklist
Before sharing the store publicly, add:
- at least three products
- clear prices
- useful product images
- options customers usually ask about
- delivery or pickup rules
- payment instructions
Suggested API response
When a storefront is created, return the next step so the frontend does not hard-code onboarding logic:
{
"reference": "freshbakes",
"status": "draft",
"nextStep": "products",
"nextUrl": "/onboard/storefront/freshbakes/products"
}