arad-arisman/CLAUDE.md

@AGENTS.md

Arad Arisman — Meshkee backend integration

This site is a Next.js storefront for aradarisman.com, backed by the Meshkee Website API (https://api.meshkee.com/api/v1, docs at https://api.meshkee.com/docs/website). All backend access goes through src/lib/meshkee.ts — do not call the API directly from components/pages.

• Products (getProducts, getProduct) and blog posts (getPosts, getPost) are fetched live, tenant-scoped to TENANT_DOMAIN (aradarisman.com). Blog field names (Post type) are inferred from the Product/Category naming convention since no tenant has published posts to verify against yet — accessors fall back across plausible field names (postTitle, postContent, etc.). Re-check against a real published post once one exists and simplify the fallbacks if the guess was wrong.
• Category tiles are derived from live products (getCategorySummary), not the raw /categories endpoint — that taxonomy has duplicate entries sharing the same display name under different ids (backend data-entry artifact). The summary merges by name and links to whichever id holds the most products under that name.

Static image slots (business-managed overrides)

getStaticImageSlots / getStaticImageSlot(key) read /tenants/{domain}/website/static-images — named slots the business owner can fill with their own images from the Meshkee dashboard. Current mapping:

Slot key	Kind	Component	Fallback when empty/unset
slider	list	HeroSlider	3 local photos in hero-slider-*.jpg with authored copy
categories	list	CategoryShowcase	photo cards derived from live product categories
four-icon-image	list(4)	Features	4 local icons + authored copy, per-index override
about-us	single	About	local hero-2.jpg
brands	list	Partners	6 local partner logos

Rule: a slot with zero images (or a failed fetch) must never break the page — always fall back to the existing local/derived content. getStaticImageSlots already swallows fetch errors and returns [].

Each StaticImageItem carries url, optional titleFa/subtext/ linkUrl, and its own width/height. Respect slot.aspectRatio ("21:9" etc, via aspectRatioToCss) for slot-driven image containers instead of hardcoding a Tailwind aspect class — if you resize/recrop a local fallback image during development, update the corresponding component's fallback styling and the catalog entry in src/app/meshkee/static-image-slots/route.ts to match, since slot-driven and fallback images render through the same container and must not look broken when swapped.

Dashboard catalog (required for Refresh)

The Meshkee dashboard Refresh button does not invent slots. It imports keys from this site:

GET https://aradarisman.com/meshkee/static-image-slots

That route is src/app/meshkee/static-image-slots/route.ts. Until it is deployed and the dashboard Refresh is clicked, /tenants/aradarisman.com/website/static-images returns { items: [] } and the storefront correctly shows fallbacks.

Do not invent upload/CMS APIs. Owners add images in the Meshkee dashboard after Refresh has imported the catalog.