Connect Meshkee-managed imagery and publish sitemap metadata

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-26 18:45:00 +03:30
parent e664acb854
commit 00126e5777
10 changed files with 535 additions and 29 deletions
@@ -0,0 +1,43 @@
+# Saman Andish Website Context
+
+## Project
+
+- Persian RTL storefront for Saman Andish, built with Next.js 16, React 19, and TypeScript.
+- Apex domain: `samanandish.com`.
+- Local design assets live in `public/assets`; local fonts live in `public/fonts`.
+- Public routes currently include `/`, `/about-us`, and `/contact-us`.
+
+## Meshkee API
+
+- Canonical documentation: `https://api.meshkee.com/docs/website`
+- API base: `https://api.meshkee.com/api/v1`
+- Optional client configuration:
+  - `NEXT_PUBLIC_MESHKEE_API_URL`
+  - `NEXT_PUBLIC_MESHKEE_DOMAIN`
+- `app/lib/meshkee.ts` owns the public static-image contract and homepage fetch.
+- The homepage fetches `pageKey=home` once, matches slots by key, and keeps local images whenever the API is unavailable or a slot is empty.
+
+## Homepage Static-Image Slots
+
+- `slider`: unbounded list, `17:5`, recommended width 1920.
+- `three-categories`: fixed list of 3, `3:2`, recommended width 900.
+- `about-us-images`: fixed list of 2, `1:1`, recommended width 900.
+- The dashboard-importable catalog is served by `GET /meshkee/static-image-slots`.
+- If a rendered image size or crop ratio changes, update the corresponding catalog entry in `app/meshkee/static-image-slots/route.ts`.
+
+## Sitemap and SEO
+
+- Do not add `public/sitemap.xml`, `public/robots.txt`, `app/sitemap.ts`, or `app/robots.ts`; nginx proxies these URLs to Meshkee.
+- `GET /meshkee/sitemap-config.json` is force-generated during the production build by scanning public static `app/**/page.*` routes.
+- Auth, account, admin, cart, checkout, dynamic, and Meshkee integration routes are excluded from the static-page config.
+- The sitemap base URL uses `NEXT_PUBLIC_SITE_URL`, then `SITE_URL`, with `https://samanandish.com` as the fallback.
+- Product, category, blog, and portfolio detail pages must use Meshkee canonical `{id}/{Persian-title-slug}` URLs when those routes are implemented.
+- Every crawlable page must have unique metadata, exactly one H1, structured H2/H3 headings, and meaningful image alt text.
+- After deployment, use Business Dashboard → Website → Settings → Sync sitemap config.
+
+## Verification
+
+- Run `npm run lint`.
+- Run `npm run build`.
+- Verify `/meshkee/static-image-slots` returns the three slot definitions.
+- Verify `/meshkee/sitemap-config.json` lists `/`, `/about-us`, and `/contact-us`.