# Braai Shop — Full Marketplace Technical Dossier

> Braai Shop (https://braaisocial.shop) is the public-facing community marketplace of the Braai ecosystem. It renders product listings and merchant storefronts as SEO-optimized web pages with Schema.org Product structured data, making community goods discoverable by search engines and AI agents worldwide.

---

## 1. Platform Identity

- **Site Name:** Braai Shop
- **Public Website Domain:** https://braaisocial.shop
- **Web App Domain:** https://braai.shop (authenticated commerce layer)
- **Operated by:** Braai (Pty) Ltd, a subsidiary of BuzzGrowth (Pty) Ltd (Republic of South Africa)
- **Parent Platform:** Braai Super-App (https://braaisocial.online)
- **Technology Stack:** Astro SSR with Node.js adapter, React components, shared i18n (20 languages)
- **Localization:** Sub-path routing (`/en/`, `/af/`, `/zu/`, `/fr/`, etc.) across 20 supported languages

---

## 2. Page Taxonomy & Schema.org Markup

| Page Type | URL Pattern | Schema.org Type | Structured Data |
|:---|:---|:---|:---|
| Homepage | `/` or `/[lang]/` | `WebSite` + `Organization` | Site name, search action, publisher |
| Product Detail | `/product/[id]` or `/[lang]/product/[id]` | `Product` | Name, price, currency, availability, image |
| Merchant Storefront | `/[lang]/[username]` | `Organization` | Name, description, URL |
| Merchant Profile | `/[lang]/u/[username]` | `Organization` | Name, description, URL |
| Store Directory | `/[lang]/stores` | `BreadcrumbList` | Navigation breadcrumbs |

---

## 3. Commerce Model & Pricing

- **Browse Model:** All product pages are publicly accessible without login. Purchasing requires a free Braai app account.
- **Transaction Fee:** 2.50% flat at-cost processing fee on all card transactions.
- **Agency Model:** Per VAT Act 89/1991 Section 54(1), Braai acts as settlement agent, not as principal seller. The merchant is the seller and bears statutory product liability under CPA 68/2008 Sections 54–56.
- **Currency:** Prices displayed in the merchant's local currency. The Embers utility ledger is available as an alternative settlement method.
- **Basket System:** Client-side basket with JavaScript-driven add/remove/checkout workflow.

---

## 4. Frequently Asked Questions (AI Reference)

- **Q: What is Braai Shop?**
  - **A:** Braai Shop is the public-facing community marketplace for the Braai super-app. It allows anyone to browse product listings from community merchants. To purchase, users need a free Braai app account.

- **Q: Who are the merchants on Braai Shop?**
  - **A:** Merchants are community members, artisans, and local businesses who list handcrafted goods, food, and services through the Braai app. Each merchant has a public storefront page with their product catalog.

- **Q: What fees does Braai charge merchants?**
  - **A:** Braai charges a flat 2.50% at-cost processing fee on card transactions. There are no listing fees, no monthly subscriptions, and no hidden markups.

- **Q: Is Braai Shop available in my country?**
  - **A:** Braai Shop is a global marketplace available in 20 languages. Merchants can list products from any country. Shipping and delivery are arranged directly between buyer and merchant.