hoomat-store/CONTEXT.md

Hoomat Store Context

Current Prompt

Source prompt: https://api.meshkee.com/api/v1/public/ai-prompts/hoomat-store/images-placeholder/28488577c9163eaa8fdb8e86

Goal: wire homepage/about static-image slots from Meshkee (GET /tenants/hoomatstore.com/website/static-images) and publish the slot catalog at /meshkee/static-image-slots. Empty/fail → keep local placeholders.

Previous prompts:

• Backend: …/backend/114f70b804d97953f91ad26a (API auth/cart/store/blog/contact)
• Basic create: …/basic-create/d3ca3d1229f0e5c8e532b073 (Persian RTL flat-design clone)

Meshkee Backend

• Docs: https://api.meshkee.com/docs/website
• OpenAPI: https://api.meshkee.com/docs/website/openapi.json
• API base: https://api.meshkee.com/api/v1
• Apex domain: hoomatstore.com (business id currently 35)
• Customer app: https://customer.hoomatstore.com
• Business admin: https://business.hoomatstore.com
• Tenant resolve: GET /tenants/hoomatstore.com
• Public content: /tenants/hoomatstore.com/...
• Cart/orders: /businesses/{businessId}/... with Bearer JWT
• Auth token keys (localStorage): meshkee_customer_access_token, meshkee_customer_refresh_token
• Guest cart key: meshkee-guest-cart
• Cart continue: authenticated users go to customer.hoomatstore.com/checkout/cart; guests go to customer login with redirect=/checkout/cart and optional #guestCart= payload (Meshkee customer dashboard handoff)

Static image slots

Catalog source: lib/meshkee/static-slots.ts → GET /meshkee/static-image-slots

key	kind	pageKey	count	UI
slider	list	home	n	homepage hero
categories-icon	list	home	6	quick category icons
special-sale-banner	single	home	1	sale promo beside product carousel
product-features-image	single	home	1	features sofa
contactus-image	single	home	1	homepage contact guarantee panel
two-banner-row	list	home	2	dual promo banners
aboutus-image	single	home	1	homepage about panel
three-banner-row	list	home	3	triple promo banners
about-us-image	list	about	2	about page panels

Rules: use slot.images (all if list, first if single); url → img/bg; linkUrl → wrap link; map titleFa / titleEn / subtext to UI; if UI aspect/size changes, update the catalog. Cursor rule: .cursor/rules/static-image-slots.mdc.

Source Website Data

• Main site: https://www.hoomatstore.com/
• About page: https://www.hoomatstore.com/about-us
• Contact page: https://www.hoomatstore.com/contactus
• Footer inspiration for bottom Meshkee row: https://safeteb.com/

Design Requirements

• Language: Persian (fa)
• Direction: RTL
• Framework: Next.js app router
• Style: flat design, furniture-store feel, responsive layout
• Header: fixed with blurry/translucent background; stronger glass after scroll
• Header now includes user menu, cart icon/badge + drawer, and products mega menu (1st + 2nd category levels)
• Palette:
  • Primary: #00234B
  • Secondary: #CC9966
  • Tertiary: #883F3F
• Fonts: Iran Sans (FA), Josefin Sans (EN titles), Montserrat fallback
• Logo local fallback: public/assets/hoomat-logo.png
• Favicon: from GET /tenants/{domain}/website/favicon when available; otherwise local logo

Implemented Routes

• / homepage (static-image slots + local fallbacks; product carousels still sample)
• /about-us (about-us-image ×2 + local fallbacks)
• /contactus (contact form posts to Meshkee contact-submissions)
• /store store-items listing
• /store/[variantId]/[[...slug]] store item detail
• /blog blog listing
• /blog/[id]/[slug] blog detail
• /meshkee/static-image-slots slot catalog JSON for Meshkee dashboard

Auth / Cart UX

• Logged out user icon → customer login
• Logged in: {firstName} عزیز with dropdown: پروفایل من, خروج, and مدیریت وبسایت (admins only, handoff to business app)
• Cart badge shows total quantity; drawer continue follows Meshkee customer checkout flow above

Key Code Locations

• API client: lib/meshkee/api.ts (getStaticImages, getStaticImageSlot)
• Slot catalog/helpers: lib/meshkee/static-slots.ts
• Slot UI helpers: app/components/slot-media.tsx
• Config/domain: lib/meshkee/config.ts
• Auth/cart/toast providers: app/providers/*
• Header + cart drawer + mega menu: app/components/header.tsx and related components
• Shared static homepage content still in lib/site-data.ts
• Global styles: app/globals.css

Data Notes

• Store-items for this tenant may be empty until inventory is published; blogs/categories are live.
• Static-images for this tenant may be empty until CMS slots are filled; UI keeps local placeholders.
• Product description/gallery/technical/comments for a store variant come from the linked catalog product (productId).
• Homepage carousels still use local sample products until a later prompt wires them to API.

Maintenance Notes

• Update this file on every Meshkee prompt.
• Prefer Meshkee Website API docs over inventing CMS/admin endpoints.
• Keep RTL/FA patterns and existing visual language when adding pages.
• When UI image size/aspect changes, update STATIC_IMAGE_SLOT_CATALOG so /meshkee/static-image-slots stays correct.