@alphasquad/saleor-template-advance 0.1.0

package/SEO_AUDIT_CHECKLIST_STATUS.md

@@ -0,0 +1,244 @@
+# SEO Audit Checklist Status (Advance Template)
+
+Generated: 2026-02-10
+
+Legend: ✅ Pass, ❌ Fail, ⚠️ Partial, ⏭️ N/A or requires external tooling/deployment, ⬜ Not tested yet
+
+| ID | Priority | Status | Check | Notes |
+| --- | --- | --- | --- | --- |
+| C-001 | P0 | ✅ | Robots.txt file exists and is accessible at /robots.txt | robots.txt route exists at /robots.txt |
+| C-002 | P0 | ⚠️ | No unintentional blocking of important pages | Localhost blocks crawling; production should allow. |
+| C-003 | P1 | ✅ | Sitemap URL referenced in robots.txt | robots references /sitemap.xml |
+| C-005 | P1 | ✅ | Test/staging environments blocked | Non-prod (localhost) blocks crawling. |
+| C-008 | P0 | ✅ | XML sitemap exists at /sitemap.xml | Sitemap served at /sitemap.xml |
+| C-009 | P0 | ✅ | Sitemap is valid XML format | Valid XML output from Next metadata route |
+| C-010 | P0 | ⚠️ | All indexable pages included in sitemap | Includes key indexable routes; dynamic coverage depends on API data. |
+| C-011 | P0 | ✅ | No noindex pages in sitemap | Noindex routes excluded (cart/checkout/auth/account/search/etc). |
+| C-012 | P1 | ✅ | No redirecting URLs in sitemap | Redirects dropped by template requirement. |
+| C-013 | P0 | ⚠️ | No 404/error pages in sitemap | Dynamic URLs can go stale if upstream slugs change. |
+| C-014 | P0 | ✅ | Sitemap uses canonical URLs only | Sitemap loc uses NEXT_PUBLIC_SITE_URL |
+| C-019 | P0 | ✅ | Dynamic product pages in sitemap | Products included via dynamic sitemap. |
+| C-020 | P0 | ✅ | Dynamic category pages in sitemap | Categories included via dynamic sitemap. |
+| C-021 | P1 | ✅ | Blog/content pages in sitemap | Blog/content pages included via dynamic sitemap. |
+| C-022 | P0 | ✅ | Transactional pages excluded (cart, checkout) | Transactional pages excluded. |
+| C-023 | P1 | ✅ | Auth pages excluded (login, register) | Auth pages excluded. |
+| C-024 | P1 | ✅ | Account pages excluded | Account pages excluded. |
+| C-025 | P0 | ✅ | Important pages have index,follow (default) | Indexable pages default to index,follow. |
+| C-026 | P0 | ✅ | Cart page has noindex | Cart noindex/nofollow via metadata. |
+| C-027 | P0 | ✅ | Checkout pages have noindex | Checkout noindex/nofollow via metadata. |
+| C-028 | P1 | ✅ | Account pages have noindex | Account subtree noindex/nofollow. |
+| C-029 | P0 | ✅ | Order confirmation has noindex | Order confirmation noindex/nofollow. |
+| C-030 | P1 | ✅ | Search results page strategy defined | Search results default noindex/nofollow. |
+| C-031 | P0 | ⬜ | Filtered/sorted URLs handled (noindex or canonical) |  |
+| C-032 | P1 | ⬜ | Pagination handled correctly |  |
+| C-034 | P1 | ✅ | Payment callback pages have noindex | Payment callback/success pages noindex/nofollow. |
+| C-035 | P0 | ⚠️ | All indexable pages have canonical tags | Canonicals added on major indexable routes; verify full coverage as routes evolve. |
+| C-036 | P0 | ⚠️ | Canonical tags are self-referencing on unique pages | Generally self-referencing; validate on edge-case templates. |
+| C-037 | P0 | ✅ | Canonical tags use absolute URLs | Canonicals render as absolute URLs via metadataBase. |
+| C-038 | P0 | ✅ | metadataBase configured in Next.js | metadataBase configured in root layout. |
+| C-039 | P0 | ⬜ | HTTP canonicals point to HTTPS |  |
+| C-040 | P0 | ⬜ | www vs non-www consistency |  |
+| C-041 | P1 | ⬜ | Trailing slash consistency |  |
+| C-042 | P1 | ⬜ | Query parameters handled in canonicals |  |
+| C-043 | P1 | ⬜ | Pagination canonicals correct |  |
+| C-044 | P1 | ⬜ | Filtered URLs canonical to main page |  |
+| C-045 | P1 | ⬜ | Duplicate content has cross-canonicals |  |
+| C-046 | P0 | ⏭️ | Permanent redirects use 301 or 308 | Redirects intentionally removed from template. |
+| C-047 | P1 | ⏭️ | No redirect chains (max 1 hop) | Redirects intentionally removed from template. |
+| C-048 | P0 | ⏭️ | No redirect loops | Redirects intentionally removed from template. |
+| C-049 | P1 | ⏭️ | Old URLs redirect to new (slug changes) | Redirects intentionally removed from template. |
+| C-050 | P0 | ⏭️ | HTTP to HTTPS redirect | Handled at hosting (Vercel) / deployment layer. |
+| C-051 | P1 | ⏭️ | Non-www to www (or vice versa) redirect | Handled at hosting (Vercel) / deployment layer. |
+| U-001 | P1 | ⬜ | URLs are human-readable |  |
+| U-002 | P1 | ⬜ | URLs use hyphens (not underscores) |  |
+| U-003 | P1 | ⬜ | URLs are lowercase |  |
+| U-005 | P1 | ⬜ | URLs contain relevant keywords |  |
+| U-006 | P0 | ⬜ | No session IDs in URLs |  |
+| U-007 | P1 | ⬜ | No unnecessary parameters |  |
+| U-008 | P1 | ⬜ | Consistent URL structure across site |  |
+| U-009 | P1 | ⬜ | Product URLs use slugs (not IDs) |  |
+| U-010 | P1 | ⬜ | Category URLs use slugs |  |
+| U-011 | P1 | ⬜ | Blog URLs use slugs |  |
+| U-012 | P1 | ⬜ | Important pages within 3 clicks of homepage |  |
+| U-013 | P1 | ⬜ | Logical URL hierarchy |  |
+| U-014 | P1 | ⬜ | Flat architecture for products (not too deep) |  |
+| U-015 | P1 | ⬜ | No orphan pages (all pages linked) |  |
+| U-016 | P1 | ⬜ | Clear navigation structure |  |
+| U-017 | P1 | ⬜ | Breadcrumb navigation present |  |
+| U-018 | P1 | ⬜ | Category hierarchy is logical |  |
+| U-019 | P1 | ⬜ | Faceted navigation SEO handled |  |
+| O-001 | P0 | ⬜ | Every page has a unique title tag |  |
+| O-002 | P1 | ⬜ | Titles are 50-60 characters |  |
+| O-003 | P1 | ⬜ | Primary keyword near beginning of title |  |
+| O-005 | P0 | ⬜ | No duplicate titles across pages |  |
+| O-006 | P1 | ⬜ | Titles are compelling (encourage clicks) |  |
+| O-007 | P0 | ✅ | Product titles include product name | PDP title uses product name via generateMetadata. |
+| O-008 | P0 | ✅ | Category titles include category name | Category titles include category name. |
+| O-009 | P0 | ⬜ | Homepage title is optimized |  |
+| O-010 | P0 | ✅ | generateMetadata used for dynamic pages | generateMetadata used for key dynamic routes. |
+| O-011 | P1 | ⬜ | Every page has a meta description |  |
+| O-012 | P1 | ⬜ | Descriptions are 150-160 characters |  |
+| O-013 | P1 | ⬜ | Descriptions include primary keyword |  |
+| O-014 | P1 | ⬜ | Descriptions are unique per page |  |
+| O-016 | P1 | ⬜ | Product descriptions mention key features |  |
+| O-017 | P1 | ⬜ | Category descriptions are compelling |  |
+| O-019 | P0 | ⚠️ | Every page has exactly one H1 | One H1 on key audited pages; continue spot checks across all routes. |
+| O-020 | P0 | ⬜ | H1 contains primary keyword |  |
+| O-021 | P0 | ⬜ | H1 is visible (not hidden) |  |
+| O-022 | P1 | ⬜ | Heading hierarchy is logical (H1→H2→H3) |  |
+| O-024 | P0 | ⬜ | Headings use semantic HTML (not styled divs/p) |  |
+| O-025 | P1 | ⬜ | Subheadings describe content sections |  |
+| O-026 | P0 | ⬜ | Product pages have product name as H1 |  |
+| O-027 | P0 | ⬜ | Category pages have category name as H1 |  |
+| O-028 | P1 | ⬜ | Primary keyword in first 100 words |  |
+| O-030 | P1 | ⬜ | Content is sufficient depth (not thin) |  |
+| O-031 | P0 | ⬜ | Content is unique (not duplicated) |  |
+| O-032 | P1 | ⬜ | Product descriptions are unique |  |
+| O-033 | P1 | ⬜ | Category pages have unique content |  |
+| O-034 | P0 | ⬜ | All images have alt attributes |  |
+| O-035 | P1 | ⬜ | Alt text is descriptive |  |
+| O-039 | P1 | ⬜ | Product images have product-specific alt |  |
+| O-040 | P0 | ⬜ | No missing alt attributes |  |
+| O-041 | P1 | ⬜ | Internal links use descriptive anchor text |  |
+| O-042 | P1 | ⬜ | Important pages have adequate internal links |  |
+| O-043 | P0 | ⬜ | No broken internal links |  |
+| O-044 | P1 | ⬜ | Related products are linked |  |
+| O-045 | P1 | ⬜ | Breadcrumbs provide internal links |  |
+| O-047 | P1 | ⬜ | Navigation provides clear linking |  |
+| T-001 | P0 | ⚠️ | Critical content renders server-side (SSR/SSG) | Key pages include SSR fallbacks; interactive/catalog content still enhanced client-side. |
+| T-002 | P1 | ⚠️ | Content visible without JavaScript | Key catalog + PDP pages include visible SSR content without JS. |
+| T-003 | P0 | ⚠️ | No client-side only rendering for SEO content | Reduced client-only SEO content by adding SSR fallbacks and server-side schema. |
+| T-004 | P1 | ⬜ | Next.js Server Components used appropriately |  |
+| T-005 | P1 | ⬜ | Client components only for interactive elements |  |
+| T-006 | P1 | ⬜ | Hydration errors resolved |  |
+| T-007 | P1 | ⬜ | No render-blocking JavaScript |  |
+| T-008 | P0 | ⬜ | Valid pages return 200 |  |
+| T-009 | P0 | ✅ | Not found pages return 404 | Dynamic routes call notFound() for invalid slugs. |
+| T-010 | P1 | ✅ | Custom 404 page exists | Custom app/not-found.tsx present. |
+| T-011 | P1 | ⬜ | Server errors return 5xx |  |
+| T-012 | P0 | ✅ | No soft 404s (empty pages with 200) | Soft-404s fixed for key dynamic routes. |
+| T-013 | P1 | ⬜ | Out-of-stock products handled correctly |  |
+| T-014 | P0 | ⬜ | Images optimized (compression) |  |
+| T-015 | P1 | ⬜ | Modern image formats (WebP/AVIF) |  |
+| T-016 | P1 | ⬜ | Images lazy-loaded below fold |  |
+| T-018 | P1 | ⬜ | JavaScript minified |  |
+| T-019 | P1 | ⬜ | CSS minified |  |
+| T-020 | P1 | ⬜ | Gzip/Brotli compression enabled |  |
+| T-021 | P1 | ⬜ | Browser caching configured |  |
+| T-024 | P1 | ⬜ | Third-party scripts async/defer |  |
+| T-025 | P1 | ⬜ | Static pages pre-rendered (SSG) |  |
+| T-026 | P1 | ⬜ | Dynamic pages use ISR appropriately |  |
+| T-027 | P1 | ⚠️ | No unnecessary force-dynamic | Removed explicit force-dynamic on key pages; some routes remain dynamic due to searchParams/fetch. |
+| P-001 | P0 | ⬜ | LCP under 2.5 seconds |  |
+| P-002 | P0 | ⬜ | Hero/banner images optimized |  |
+| P-003 | P1 | ⬜ | LCP element identified and optimized |  |
+| P-004 | P1 | ⬜ | Above-fold images preloaded |  |
+| P-005 | P1 | ⬜ | Server response time (TTFB) under 600ms |  |
+| P-006 | P1 | ⬜ | Font display: swap used |  |
+| P-008 | P0 | ⬜ | INP under 200ms |  |
+| P-009 | P1 | ⬜ | No long JavaScript tasks (>50ms) |  |
+| P-010 | P1 | ⬜ | Event handlers optimized |  |
+| P-012 | P1 | ⬜ | No main thread blocking |  |
+| P-013 | P0 | ⬜ | CLS under 0.1 |  |
+| P-014 | P0 | ⬜ | Images have width/height attributes |  |
+| P-015 | P1 | ⬜ | Ads/embeds have reserved space |  |
+| P-016 | P1 | ⬜ | Fonts don't cause layout shift |  |
+| P-017 | P1 | ⬜ | Dynamic content has reserved space |  |
+| P-018 | P1 | ⬜ | Skeleton loaders prevent CLS |  |
+| P-019 | P1 | ⬜ | No content injected above viewport |  |
+| S-001 | P1 | ✅ | Organization schema present | Organization JSON-LD in root layout. |
+| S-002 | P1 | ✅ | Organization schema site-wide | Organization JSON-LD is site-wide. |
+| S-003 | P1 | ✅ | WebSite schema with SearchAction | WebSite + SearchAction JSON-LD in root layout. |
+| S-007 | P0 | ✅ | Product schema on all product pages | Product JSON-LD rendered server-side on PDP. |
+| S-008 | P0 | ⬜ | Product name in schema |  |
+| S-009 | P1 | ⬜ | Product description in schema |  |
+| S-010 | P0 | ⬜ | Product image in schema |  |
+| S-011 | P0 | ⬜ | Product price in schema |  |
+| S-012 | P0 | ⬜ | Product currency in schema |  |
+| S-013 | P0 | ⬜ | Product availability in schema |  |
+| S-014 | P1 | ⬜ | Product SKU in schema |  |
+| S-015 | P1 | ⬜ | Product brand in schema |  |
+| S-016 | P1 | ⬜ | Product MPN (part number) in schema |  |
+| S-019 | P0 | ✅ | Offer schema nested in Product | Offer nested under Product. |
+| S-021 | P1 | ⚠️ | BreadcrumbList schema on all pages | BreadcrumbList present on many key pages; not guaranteed on every route yet. |
+| S-022 | P1 | ⚠️ | Breadcrumb items have correct URLs | Breadcrumb URLs validated on major routes; continue spot checks. |
+| S-024 | P1 | ⚠️ | Breadcrumb hierarchy matches visible | Breadcrumb hierarchy matches visible UI on major routes. |
+| S-027 | P1 | ✅ | BlogPosting schema on blog posts | BlogPosting JSON-LD on blog/content posts. |
+| S-031 | P0 | ⏭️ | All schema passes Google Rich Results Test | Requires Google Rich Results Test. |
+| S-032 | P0 | ⏭️ | No schema errors in Search Console | Requires Search Console. |
+| S-034 | P1 | ✅ | JSON-LD format used (not microdata) | JSON-LD used for schema. |
+| M-001 | P0 | ⬜ | Site passes Google Mobile-Friendly Test |  |
+| M-002 | P0 | ✅ | Viewport meta tag configured | Viewport meta tag present. |
+| M-003 | P0 | ⬜ | Responsive design (not separate mobile site) |  |
+| M-004 | P0 | ⬜ | No horizontal scrolling on mobile |  |
+| M-005 | P1 | ⬜ | Text readable without zooming |  |
+| M-006 | P1 | ⬜ | Tap targets adequately sized (48x48px) |  |
+| M-007 | P1 | ⬜ | Tap targets adequately spaced |  |
+| M-008 | P1 | ⬜ | No intrusive interstitials |  |
+| M-009 | P1 | ⬜ | Forms usable on mobile |  |
+| M-010 | P0 | ⬜ | Navigation works on mobile |  |
+| M-011 | P0 | ⬜ | Same content on mobile and desktop |  |
+| M-012 | P0 | ⬜ | Same structured data on mobile |  |
+| M-013 | P0 | ⬜ | Same meta tags on mobile |  |
+| M-014 | P1 | ⬜ | Images/videos accessible on mobile |  |
+| M-015 | P0 | ⬜ | Internal links work on mobile |  |
+| E-004 | P1 | ⬜ | Technical specifications accurate |  |
+| E-005 | P0 | ⬜ | Product compatibility information correct |  |
+| E-008 | P1 | ⬜ | Brand/manufacturer information present |  |
+| E-011 | P0 | ⬜ | Contact information easily found |  |
+| E-012 | P1 | ⬜ | Physical address displayed |  |
+| E-013 | P1 | ⬜ | Phone number present |  |
+| E-014 | P0 | ⬜ | Privacy policy page exists |  |
+| E-015 | P1 | ⬜ | Terms and conditions page exists |  |
+| E-016 | P0 | ⬜ | Return/refund policy clear |  |
+| E-017 | P1 | ⬜ | Shipping information present |  |
+| E-018 | P0 | ⬜ | Secure checkout indicators |  |
+| EC-001 | P1 | ⬜ | Unique product descriptions |  |
+| EC-002 | P1 | ⬜ | Product specifications listed |  |
+| EC-003 | P1 | ⬜ | Multiple product images |  |
+| EC-004 | P0 | ⬜ | Price clearly displayed |  |
+| EC-005 | P0 | ⬜ | Availability/stock status shown |  |
+| EC-006 | P0 | ⬜ | Add to cart prominent |  |
+| EC-009 | P1 | ⬜ | Shipping information on product page |  |
+| EC-010 | P1 | ⬜ | Part numbers visible |  |
+| EC-011 | P0 | ⬜ | Vehicle fitment information (automotive) |  |
+| EC-012 | P1 | ⬜ | Category descriptions present |  |
+| EC-014 | P1 | ⬜ | Filtering options available |  |
+| EC-016 | P1 | ⬜ | Pagination implemented correctly |  |
+| EC-017 | P1 | ⬜ | Subcategories linked |  |
+| EC-018 | P1 | ⬜ | Filter URLs SEO-friendly |  |
+| EC-019 | P0 | ⬜ | Site search works correctly |  |
+| EC-020 | P1 | ⬜ | Search results relevant |  |
+| EC-021 | P1 | ⬜ | No results page helpful |  |
+| EC-023 | P1 | ⬜ | Out of stock products still accessible |  |
+| EC-024 | P0 | ⬜ | Out of stock clearly indicated |  |
+| EC-027 | P0 | ⬜ | YMM (Year/Make/Model) selector works |  |
+| EC-028 | P0 | ⬜ | Fitment data accurate |  |
+| EC-029 | P1 | ⬜ | Part numbers searchable |  |
+| EC-032 | P1 | ⬜ | Vehicle schema for fitment |  |
+| L-003 | P1 | ⬜ | NAP consistent across site |  |
+| L-007 | P1 | ⬜ | hreflang tags (if multi-language) |  |
+| L-008 | P1 | ⬜ | Correct language/region targeting |  |
+| L-009 | P1 | ⬜ | Currency localization |  |
+| SEC-001 | P0 | ⏭️ | Site uses HTTPS | Requires HTTPS deployment. |
+| SEC-002 | P0 | ⏭️ | Valid SSL certificate | Requires HTTPS deployment. |
+| SEC-003 | P0 | ⏭️ | No mixed content warnings | Requires HTTPS deployment + browser checks. |
+| SEC-004 | P1 | ⚠️ | HSTS header configured | HSTS header set in next.config.ts for production only. |
+| SOC-001 | P1 | ⚠️ | og:title on all pages | og:title is present; ensure all routes override defaults when needed. |
+| SOC-002 | P1 | ⚠️ | og:description on all pages | og:description is present; ensure all routes override defaults when needed. |
+| SOC-003 | P0 | ✅ | og:image on all pages | og:image present (defaults + per-page overrides). |
+| SOC-004 | P1 | ⚠️ | og:url on all pages | og:url present; validate correctness across all routes. |
+| SOC-009 | P1 | ⚠️ | twitter:card on all pages | twitter:card present on major routes. |
+| SOC-010 | P1 | ⚠️ | twitter:title on all pages | twitter:title present on major routes. |
+| SOC-011 | P1 | ⚠️ | twitter:description on all pages | twitter:description present on major routes. |
+| SOC-012 | P1 | ⚠️ | twitter:image on all pages | twitter:image present on major routes. |
+| A-001 | P0 | ⏭️ | Google Analytics installed | Template leaves GA/Tag Manager to project integration. |
+| A-002 | P1 | ⬜ | GA4 ecommerce tracking configured |  |
+| A-003 | P1 | ⬜ | Google Tag Manager configured |  |
+| A-004 | P1 | ⬜ | Analytics doesn't block rendering |  |
+| A-005 | P1 | ⬜ | Conversion tracking set up |  |
+| A-006 | P0 | ⏭️ | Google Search Console verified | Requires Search Console verification. |
+| A-007 | P0 | ⏭️ | Sitemap submitted to GSC | Requires Search Console submission. |
+| A-008 | P0 | ⬜ | No critical errors in GSC |  |
+| A-009 | P1 | ⬜ | Core Web Vitals monitored |  |
+| A-010 | P1 | ⬜ | Coverage report reviewed |  |

package/SEO_AUDIT_REPORT.md

@@ -0,0 +1,66 @@
+# SEO Audit Report (Advance Template)
+
+Scope: `/Users/arslankhan/Sites/projects/saleor-store-front/saleor-template-advance`
+
+Last updated: 2026-02-10
+
+Audit checklist source:
+- `/Users/arslankhan/Sites/projects/saleor-store-front/saleor-template-advance/docs/SEO-Audit-Critical.md`
+
+Checklist status file (generated, 236 checks):
+- `/Users/arslankhan/Sites/projects/saleor-store-front/saleor-template-advance/SEO_AUDIT_CHECKLIST_STATUS.md`
+
+Regenerate checklist status:
+```bash
+cd /Users/arslankhan/Sites/projects/saleor-store-front/saleor-template-advance
+node scripts/seo-audit/generate-checklist.mjs
+```
+
+## Test Environment
+
+- Local `yarn build && yarn start`
+- `.env.local` with `NEXT_PUBLIC_SITE_URL=http://localhost:3000`
+
+## Key Fixes Implemented During This Audit
+
+- Product SEO metadata fixed:
+  - PDP meta description is now plaintext (not raw Editor.js JSON) via `extractTextFromEditorJs`.
+  - PDP now has page-specific OpenGraph/Twitter tags (title/description/url/image).
+- Product schema moved server-side:
+  - Product JSON-LD + BreadcrumbList JSON-LD now render on the server for crawlability.
+  - Removed client-side `useEffect` injection of schema scripts to avoid “JS-only” structured data.
+- SSR fallbacks for SEO-critical catalog pages:
+  - Added server-rendered fallback content for `/products/all`, `/category/[slug]`, `/brand/[id]`, and `/product/[id]` so key content is visible without JavaScript.
+  - Implemented progressive-enhancement helpers (`.ssr-only` / `.js-only`) driven by `document.documentElement.dataset.js`.
+- Social tags coverage expanded:
+  - Added OpenGraph/Twitter per-page metadata to major indexable static routes and key collections.
+- Forms/indexation hygiene:
+  - `/request-return` explicitly `noindex,nofollow`.
+- Menu URL normalization:
+  - Internal Saleor menu links normalized to relative URLs for local/dev domain mismatches (expanded for `/request-return` + `/account`).
+
+## Current Action Items
+
+P0
+- Finish structured data correctness coverage across *all* key indexable pages (breadcrumbs in particular).
+- Continue reducing “JS-only content” on pages that remain client-first beyond the SSR fallbacks.
+
+P1
+- Faceted navigation SEO strategy:
+  - Ensure filters/sort/pagination have stable canonicals and avoid indexing parameterized URLs.
+- Performance / CWV follow-ups:
+  - Remove unnecessary `force-dynamic` routes where ISR is sufficient.
+  - Confirm LCP images use `next/image` with correct sizing and priority on hero/LCP element.
+- Complete remaining “Not tested yet” checks in `SEO_AUDIT_CHECKLIST_STATUS.md` with additional local automation and/or deployment verification.
+
+## Notes / Evidence (Local)
+
+- `robots.txt` (localhost):
+  - Currently returns `Disallow: /` (intentional for non-prod). Production behavior depends on `NEXT_PUBLIC_SITE_URL`.
+- Sitemap exclusions validated:
+  - Confirmed `/cart`, `/checkout`, `/account/*`, `/search`, `/order-confirmation`, `/authorize-net-success`, `/request-return` not present in `/sitemap.xml`.
+- Meta robots validated:
+  - Confirmed `noindex,nofollow` present for `/cart`, `/checkout`, `/search`, `/account/login`, `/order-confirmation`, `/authorize-net-success`, `/request-return`.
+- PDP metadata + schema validated:
+  - Confirmed `<meta name="description">` is plaintext.
+  - Confirmed `Product` + `Offer` JSON-LD and `BreadcrumbList` JSON-LD present in initial HTML.

package/eslint.config.mjs

@@ -0,0 +1,16 @@
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const eslintConfig = [
+  ...compat.extends("next/core-web-vitals", "next/typescript"),
+];
+
+export default eslintConfig;

package/next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/next.config.ts

@@ -0,0 +1,109 @@
+import type { NextConfig } from "next";
+
+function uniq<T>(items: T[]) {
+  return Array.from(new Set(items));
+}
+
+function toHost(urlOrHost?: string | null): string | null {
+  if (!urlOrHost) return null;
+  const raw = urlOrHost.trim();
+  if (!raw) return null;
+
+  // Allow passing a bare hostname (e.g. "cdn.example.com") or a URL.
+  try {
+    if (/^https?:\/\//i.test(raw)) return new URL(raw).hostname;
+  } catch {
+    // fall through
+  }
+  return raw.replace(/^https?:\/\//i, "").replace(/\/.*$/, "");
+}
+
+function getRemoteImageHosts(): string[] {
+  const envHosts = (process.env.NEXT_PUBLIC_IMAGE_HOSTS || "")
+    .split(",")
+    .map((s) => s.trim())
+    .filter(Boolean)
+    .map((h) => toHost(h))
+    .filter((h): h is string => Boolean(h));
+
+  // Common: allow images from the Saleor API hostname (media URLs).
+  const saleorHost = toHost(process.env.NEXT_PUBLIC_API_URL);
+
+  // Common asset/CDN hosts used by these templates.
+  const assetsHost = toHost(process.env.NEXT_PUBLIC_ASSETS_BASE_URL);
+  const partsLogicHost = toHost(process.env.NEXT_PUBLIC_PARTSLOGIC_URL);
+
+  // This host is used by PartsLogic category backgrounds in WSM deployments.
+  const wsmAssetsHost = "wsm-saleor-assets.s3.us-west-2.amazonaws.com";
+
+  return uniq(
+    [saleorHost, assetsHost, partsLogicHost, wsmAssetsHost, ...envHosts].filter(
+      Boolean
+    ) as string[]
+  );
+}
+
+const nextConfig: NextConfig = {
+  eslint: {
+    // This template ships with existing warnings; don't block `next build` on lint.
+    ignoreDuringBuilds: true,
+  },
+  // Configure headers for Apple Pay domain association file
+  async headers() {
+    const securityHeaders =
+      process.env.NODE_ENV === "production"
+        ? [
+            // HSTS is only meaningful over HTTPS and should not be enabled for localhost.
+            {
+              key: "Strict-Transport-Security",
+              value: "max-age=31536000; includeSubDomains; preload",
+            },
+            { key: "X-Content-Type-Options", value: "nosniff" },
+            { key: "X-Frame-Options", value: "SAMEORIGIN" },
+            { key: "Referrer-Policy", value: "strict-origin-when-cross-origin" },
+          ]
+        : [];
+
+    return [
+      {
+        source: '/.well-known/apple-developer-merchantid-domain-association',
+        headers: [
+          {
+            key: 'Content-Type',
+            value: 'application/octet-stream',
+          },
+          {
+            key: 'Cache-Control',
+            value: 'public, max-age=3600',
+          },
+        ],
+      },
+      ...(securityHeaders.length
+        ? [
+            {
+              source: "/(.*)",
+              headers: securityHeaders,
+            },
+          ]
+        : []),
+    ];
+  },
+  images: {
+    remotePatterns: [
+      {
+        protocol: "http", // for local dev server
+        hostname: "localhost",
+        port: "8000",
+        pathname: "/media/**",
+      },
+      // Explicit allowlist for template consumers
+      ...getRemoteImageHosts().map((hostname) => ({
+        protocol: "https" as const,
+        hostname,
+        pathname: "/**",
+      })),
+    ],
+  },
+};
+
+export default nextConfig;

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@alphasquad/saleor-template-advance",
+  "version": "0.1.0",
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@apollo/client": "^3.13.9",
+    "@next/third-parties": "^15.5.4",
+    "@types/googlemaps": "^3.43.3",
+    "clsx": "^2.1.1",
+    "country-state-city": "^3.2.1",
+    "graphql": "^16.11.0",
+    "jwt-decode": "^4.0.0",
+    "next": "15.4.10",
+    "nodemailer": "^8.0.1",
+    "postcss": "^8.5.6",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-google-recaptcha": "^3.1.0",
+    "react-google-recaptcha-v3": "^1.11.0",
+    "react-international-phone": "^4.6.0",
+    "react-paginate": "^8.3.0",
+    "swiper": "^11.2.10",
+    "tailwind-merge": "^3.3.1",
+    "zustand": "^5.0.7"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3",
+    "@tailwindcss/postcss": "^4.1.11",
+    "@types/node": "^20",
+    "@types/nodemailer": "^7.0.9",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@types/react-google-recaptcha": "^2.1.9",
+    "eslint": "^9",
+    "eslint-config-next": "15.4.5",
+    "tailwindcss": "^4.1.11",
+    "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/postcss.config.mjs

@@ -0,0 +1,5 @@
+const config = {
+  plugins: ["@tailwindcss/postcss"],
+};
+
+export default config;

package/public/.well-known/apple-developer-merchantid-domain-association

@@ -0,0 +1 @@
+7B227073704964223A2241443631324543383841333039314132314539434132433035304439454130353741414535444341304542413237424243333838463239344231353534434233222C2276657273696F6E223A312C22637265617465644F6E223A313731353237313630333931352C227369676E6174757265223A223330383030363039326138363438383666373064303130373032613038303330383030323031303133313064333030623036303936303836343830313635303330343032303133303830303630393261383634383836663730643031303730313030303061303830333038323033653333303832303338386130303330323031303230323038313636333463386230653330353731373330306130363038326138363438636533643034303330323330376133313265333032633036303335353034303330633235343137303730366336353230343137303730366336393633363137343639366636653230343936653734363536373732363137343639366636653230343334313230326432303437333333313236333032343036303335353034306230633164343137303730366336353230343336353732373436393636363936333631373436393666366532303431373537343638366637323639373437393331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533333031653137306433323334333033343332333933313337333433373332333735613137306433323339333033343332333833313337333433373332333635613330356633313235333032333036303335353034303330633163363536333633326437333664373032643632373236663662363537323264373336393637366535663535343333343264353035323466343433313134333031323036303335353034306230633062363934663533323035333739373337343635366437333331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533333035393330313330363037326138363438636533643032303130363038326138363438636533643033303130373033343230303034633231353737656465626436633762323231386636386464373039306131323138646337623062643666326332383364383436303935643934616634613534313162383334323065643831316633343037653833333331663163353463336637656233323230643662616435643465666634393238393839336537633066313361333832303231313330383230323064333030633036303335353164313330313031666630343032333030303330316630363033353531643233303431383330313638303134323366323439633434663933653465663237653663346636323836633366613262626664326534623330343530363038326230363031303530353037303130313034333933303337333033353036303832623036303130353035303733303031383632393638373437343730336132663266366636333733373032653631373037303663363532653633366636643266366636333733373033303334326436313730373036633635363136393633363133333330333233303832303131643036303335353164323030343832303131343330383230313130333038323031306330363039326138363438383666373633363430353031333038316665333038316333303630383262303630313035303530373032303233303831623630633831623335323635366336393631366536333635323036663665323037343638363937333230363336353732373436393636363936333631373436353230363237393230363136653739323037303631373237343739323036313733373337353664363537333230363136333633363537303734363136653633363532303666363632303734363836353230373436383635366532303631373037303663363936333631363236633635323037333734363136653634363137323634323037343635373236643733323036313665363432303633366636653634363937343639366636653733323036663636323037353733363532633230363336353732373436393636363936333631373436353230373036663663363936333739323036313665363432303633363537323734363936363639363336313734363936663665323037303732363136333734363936333635323037333734363137343635366436353665373437333265333033363036303832623036303130353035303730323031313632613638373437343730336132663266373737373737326536313730373036633635326536333666366432663633363537323734363936363639363336313734363536313735373436383666373236393734373932663330333430363033353531643166303432643330326233303239613032376130323538363233363837343734373033613266326636333732366332653631373037303663363532653633366636643266363137303730366336353631363936333631333332653633373236633330316430363033353531643065303431363034313439343537646236666435373438313836383938393736326637653537383530376537396235383234333030653036303335353164306630313031666630343034303330323037383033303066303630393261383634383836663736333634303631643034303230353030333030613036303832613836343863653364303430333032303334393030333034363032323130306336663032336362323631346262333033383838613136323938336531613933663130353666353066613738636462396261346361323431636331346532356530323231303062653363643064666431363234376636343934343735333830653964343463323238613130383930613361316463373234623862346362383838393831386263333038323032656533303832303237356130303330323031303230323038343936643266626633613938646139373330306130363038326138363438636533643034303330323330363733313162333031393036303335353034303330633132343137303730366336353230353236663666373432303433343132303264323034373333333132363330323430363033353530343062306331643431373037303663363532303433363537323734363936363639363336313734363936663665323034313735373436383666373236393734373933313133333031313036303335353034306130633061343137303730366336353230343936653633326533313062333030393036303335353034303631333032353535333330316531373064333133343330333533303336333233333334333633333330356131373064333233393330333533303336333233333334333633333330356133303761333132653330326330363033353530343033306332353431373037303663363532303431373037303663363936333631373436393666366532303439366537343635363737323631373436393666366532303433343132303264323034373333333132363330323430363033353530343062306331643431373037303663363532303433363537323734363936363639363336313734363936663665323034313735373436383666373236393734373933313133333031313036303335353034306130633061343137303730366336353230343936653633326533313062333030393036303335353034303631333032353535333330353933303133303630373261383634386365336430323031303630383261383634386365336430333031303730333432303030346630313731313834313964373634383564353161356532353831303737366538383061326566646537626165346465303864666334623933653133333536643536363562333561653232643039373736306432323465376262613038666437363137636538386362373662623636373062656338653832393834666635343435613338316637333038316634333034363036303832623036303130353035303730313031303433613330333833303336303630383262303630313035303530373330303138363261363837343734373033613266326636663633373337303265363137303730366336353265363336663664326636663633373337303330333432643631373037303663363537323666366637343633363136373333333031643036303335353164306530343136303431343233663234396334346639336534656632376536633466363238366333666132626266643265346233303066303630333535316431333031303166663034303533303033303130316666333031663036303335353164323330343138333031363830313462626230646561313538333338383961613438613939646562656264656261666461636232346162333033373036303335353164316630343330333032653330326361303261613032383836323636383734373437303361326632663633373236633265363137303730366336353265363336663664326636313730373036633635373236663666373436333631363733333265363337323663333030653036303335353164306630313031666630343034303330323031303633303130303630613261383634383836663736333634303630323065303430323035303033303061303630383261383634386365336430343033303230333637303033303634303233303361636637323833353131363939623138366662333563333536636136326266663431376564643930663735346461323865626566313963383135653432623738396638393866373962353939663938643534313064386639646539633266653032333033323264643534343231623061333035373736633564663333383362393036376664313737633263323136643936346663363732363938323132366635346638376137643162393963623962303938393231363130363939306630393932316430303030333138323031383833303832303138343032303130313330383138363330376133313265333032633036303335353034303330633235343137303730366336353230343137303730366336393633363137343639366636653230343936653734363536373732363137343639366636653230343334313230326432303437333333313236333032343036303335353034306230633164343137303730366336353230343336353732373436393636363936333631373436393666366532303431373537343638366637323639373437393331313333303131303630333535303430613063306134313730373036633635323034393665363332653331306233303039303630333535303430363133303235353533303230383136363334633862306533303537313733303062303630393630383634383031363530333034303230316130383139333330313830363039326138363438383666373064303130393033333130623036303932613836343838366637306430313037303133303163303630393261383634383836663730643031303930353331306631373064333233343330333533303339333133363332333033303333356133303238303630393261383634383836663730643031303933343331316233303139333030623036303936303836343830313635303330343032303161313061303630383261383634386365336430343033303233303266303630393261383634383836663730643031303930343331323230343230633364366466616634636131326539643331666630363161636563303536613232653131386261333262633934346664323166336231373838363634646634363330306130363038326138363438636533643034303330323034343733303435303232313030633961346263306665316537366332356636343136303264306238313462363666643264376534623263636537343138633132343532313866356230353963363032323036623632373361383536363830633738313064303131333538666463383563633764303730656531393736333234316537356336636237353732326164303930303030303030303030303030227D

package/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/public/footer/facebook.tsx

@@ -0,0 +1,34 @@
+export const facebook = (
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256">
+    <rect width={256} height={256} fill="none" />
+    <circle
+      cx={128}
+      cy={128}
+      r={96}
+      fill="black"
+      stroke="currentColor"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeWidth={16}
+    />
+    <path
+      d="M168,88H152a24,24,0,0,0-24,24V224"
+      fill="black"
+      stroke="currentColor"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeWidth={16}
+    />
+    <line
+      x1={96}
+      y1={144}
+      x2={160}
+      y2={144}
+      fill="black"
+      stroke="currentColor"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeWidth={16}
+    />
+  </svg>
+);

package/public/footer/instagram.tsx

@@ -0,0 +1,27 @@
+export const Instagram = (
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256">
+    <rect width={256} height={256} fill="none" />
+    <circle
+      cx={128}
+      cy={128}
+      r={40}
+      fill="none"
+      stroke="black"
+      strokeMiterlimit={10}
+      strokeWidth={16}
+    />
+    <rect
+      x={32}
+      y={32}
+      width={192}
+      height={192}
+      rx={48}
+      fill="none"
+      stroke="black"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeWidth={16}
+    />
+    <circle cx={180} cy={76} r={12} />
+  </svg>
+);

package/public/footer/mail.tsx

@@ -0,0 +1,5 @@
+export const Mail = (
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 640">
+    <path d="M125.4 128C91.5 128 64 155.5 64 189.4C64 190.3 64 191.1 64.1 192L64 192L64 448C64 483.3 92.7 512 128 512L512 512C547.3 512 576 483.3 576 448L576 192L575.9 192C575.9 191.1 576 190.3 576 189.4C576 155.5 548.5 128 514.6 128L125.4 128zM528 256.3L528 448C528 456.8 520.8 464 512 464L128 464C119.2 464 112 456.8 112 448L112 256.3L266.8 373.7C298.2 397.6 341.7 397.6 373.2 373.7L528 256.3zM112 189.4C112 182 118 176 125.4 176L514.6 176C522 176 528 182 528 189.4C528 193.6 526 197.6 522.7 200.1L344.2 335.5C329.9 346.3 310.1 346.3 295.8 335.5L117.3 200.1C114 197.6 112 193.6 112 189.4z" />
+  </svg>
+);

package/public/footer/x.tsx

@@ -0,0 +1,35 @@
+export const X = (
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256">
+    <rect width={256} height={256} fill="none" />
+    <polygon
+      points="48 40 96 40 208 216 160 216 48 40"
+      fill="none"
+      stroke="black"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeWidth={16}
+    />
+    <line
+      x1="113.88"
+      y1="143.53"
+      x2={48}
+      y2={216}
+      fill="black"
+      stroke="black"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeWidth={16}
+    />
+    <line
+      x1={208}
+      y1={40}
+      x2="142.12"
+      y2="112.47"
+      fill="black"
+      stroke="black"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeWidth={16}
+    />
+  </svg>
+);

package/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>