# BRB Store — AI context

Persian RTL storefront for **brb-store.com** (فروشگاه و تعمیرگاه لوازم خانگی برادران برقعی، قم).
Next.js App Router rebuild of the original WillaMall/BeTheme site. Keep this file current — other AI tools read it first.

Live DNS for `www.brb-store.com` currently serves a different tenant; source of truth for copy, images, and palette is the archived original at `https://www.brb-store.ir/` (Wayback 2022) plus `Ai-data/prompt.txt`.

## Stack

- Next.js 16 (App Router, Turbopack) + React 19 + TypeScript + Tailwind v4
- Locale: `fa`, direction: `rtl`
- Fonts: Vazirmatn (Persian) + Montserrat (English kickers). Original site used **BYekan-Edited** + **IRANSans** + **Montserrat**; those files were not recoverable from Wayback (`WillaMall_SP/assets/Fonts/...` 404).
- Icons: Lucide, tinted with brand red (original used WillaMall `WMi-*` icon font, not archived).
- Dev: `npm run dev`

## Brand

| Token | Value | Source |
| --- | --- | --- |
| Brand red | `#e7432b` | BeTheme `color-red` |
| Brand dark | `#c93621` | hover |
| Ink | `#1a1a1a` | |
| Muted | `#6c6363` | original about text |
| Paper | `#f6f3f1` | |
| Footer copy bar | `#efefef` | original `.footer_copy` |

Logo: oval **BRB** (black top / red bottom, “Borgheei Brothers”) at `public/images/brand/logo.png` and `src/assets/images/logo/logo.png`. Favicon from original `.ico`.

Design language comes from the original BeTheme Carpenter homepage, not a generic banner stack:

- Full-bleed kitchen photography with a **white 92% caption card** (the original slider’s 430px white panel), red 3px bar, Montserrat kicker.
- «قطعات ما» header: red bar + English kicker, title, short catalog note.
- Parts grid: **4 columns**, image cards with a **frosted glass** caption box on the photo (`backdrop-filter`), hover zoom + search icon.
- Red (`#e7432b`) as accent — numbers, icons, underlines — not a wash over every photo.
- Story: فروش / قطعات / تعمیرات, ۳۰+ years, two Qom branches, wholesale.
- Homepage **blog carousel** after the three-banner row: snap-scroll cards, arrows, link to `/blog`. Copy lives in `lib/data.ts` (`blogPosts`) until Meshkee.
- Original **category hover carousel** (`CategoryShowcase`): centered «دسته بندی ها» header, tall photo cards, dark bottom bar that expands on hover with «تماس با ما». Data: `showcaseCategories`.

Product tiles stay on **white backgrounds**. Lifestyle extras: `public/images/lifestyle/`.

## Routes (this pass)

Clone **only** these pages:

| Path | Content |
| --- | --- |
| `/` | Homepage + static image slots |
| `/about` | About us (original `/AboutUs`) |
| `/contact` | Contact us (original `/ContactUs`) |
| `/blog` | Article list (local placeholders until Meshkee blog is wired) |
| `/blog/[slug]` | Article detail |
| `/meshkee/static-image-slots` | Slot catalog for the dashboard Refresh button |

Account / user icon → `https://customer.brb-store.com` (`NEXT_PUBLIC_CUSTOMER_PORTAL_URL`). Do not build a local login page.

## Homepage order

`Hero` → `Services` (3 icons) → `CategoryShowcase` → `AboutPreview` → five-banner (2-col + 3-col) → `BlogCarousel` → `two-banner-row` → `Stats` → `WideBanner` → `Branches`.

Caption bars on photos use dark glossy glass (`lib/glossy.ts` `glossyBar`). Hover the card to expand the bar and show `subtext`.

## Static image slots (wired)

`GET /tenants/brb-store.com/website/static-images?pageKey=home`. Catalog: `GET /meshkee/static-image-slots` from `STATIC_IMAGE_SLOTS` in `lib/static-images.ts`. Client: `overlaySlotImages` / `pickSlot`. Empty/fail → local placeholder. `url` → `<img src>`, `linkUrl` → wrap in a link, `titleFa` / `titleEn` / `subtext` → caption. Use `slot.aspectRatio`.

If a slot’s CSS size or ratio changes, update `aspectRatio` and `recommendedWidth` in `STATIC_IMAGE_SLOTS` in the same change.

| key | kind | itemCount | ratio | Local fallback |
| --- | --- | --- | --- | --- |
| `slider` | list | null | 2:1 | `slides` peek carousel, center `1280px` |
| `three-icon-image` | list | 3 | 1:1 | Lucide icons if slot empty |
| `categories` | list | null | 14:23 | `showcaseCategories` tall cards |
| `about-us-image` | single | 1 | 4:3 | `public/images/about/store.jpg` |
| `five-banner-section` | list | 5 | 2:1 | `twoBannerRow` + `threeBannerRow` |
| `two-banner-row` | list | 2 | 2:1 | `bannersBelowSlider` (after blog) |
| `full-row-image` | single | 1 | 32:9 | `public/images/banners/wide.jpg` |
| `two-branch-image` | list | 2 | 2:1 | `branches` photos |

Do not invent upload APIs.

## Original business data (valid — do not invent replacements)

**About:** 30+ years. Sells home appliances, spare parts, and repairs small appliances (vacuum, meat grinder, fan, juicer, mill, steam iron, kettle, mixer, blender, microwave, …). Wholesale and retail, Iran and abroad. Open to manufacturers/traders.

**Branches**

1. قم، خیابان سی متری کیوانفر، روبروی داروخانه الهادی
2. قم، بلوار صدوقی، خیابان امام حسین (ع)، نبش کوچه ۲۱

**Phones:** 0912-309-3407، 0912-651-7619، 025-36604454، 025-32404070، تلفکس 0253-6638866  
**Telegram:** https://t.me/borgheeibrothers  
**Email display:** Alireza borghei20@gmail.com (`alirezaborghei20@gmail.com`)  
**Map:** 34.6564, 50.8696

**Part categories (homepage):** vacuum, juicer/blender/mill, steam cleaner, meat grinder, iron, microwave/toaster, kettle, fan/evaporative cooler, food processor/chopper/hand blender/mixer, battery, bearing, collector.

Appliance mega-menu (household + industrial) is copied from the original header; links currently go to `/#parts` until the catalog is connected.

## Meshkee

Docs: https://api.meshkee.com/docs/website  
OpenAPI: https://api.meshkee.com/docs/website/openapi.json  
Base: `https://api.meshkee.com/api/v1`  
Tenant domain: `brb-store.com` (`NEXT_PUBLIC_WEBSITE_DOMAIN` / `WEBSITE_DOMAIN`).

Wired: homepage static images (`Ai-data/prompt-images-slot.txt`).

Later: `Ai-data/prompt-connect-backend.txt` — products, blog, portfolio, customer portal.

Public reads only. Do not invent CMS/upload/dashboard APIs. Product images are white-bg and will be read from the backend.

## Local content

All copy and nav live in `lib/data.ts`. Downloaded originals are under `public/images/`. Sample lifestyle photos: `assets/sample images/` (copied to `public/images/lifestyle/`).