saleor-template-basic

Basic Saleor storefront template (Next.js App Router) with:

• Product browsing (homepage, category/search, PDP)
• YMM (Year/Make/Model) via PartsLogic
• Dealer locator (always reachable; shows a "not configured" state if missing env)
• Static CMS pages (Saleor Pages)
• Newsletter pop-up (CMS-backed)
• Inquiries and applications (forms post to /api/form-submission)
• No auth, no cart, no checkout, no payments

Requirements

• Node.js 20+
• Yarn
• A Saleor instance (GraphQL endpoint)
• PartsLogic (for YMM + search)

Setup

1. Copy .env.example to .env.local and fill in values.
2. Install and run:

yarn install
yarn dev

Saleor CMS Page Slugs (Expected)

These routes render content from Saleor Pages by slug:

• /terms-and-conditions -> terms-and-conditions
• /shipping-returns -> shipping-returns
• /privacy-policy -> privacy-policy (optional, but included)

Newsletter:

• Newsletter is a pop-up that pulls content from the Saleor Page slug newsletter.

These slugs power the form UIs (metadata-driven fields):

• Contact page uses a Saleor Page with slug contact
• Dealer application uses slug dealer-application
• Product inquiry modal uses slug item-inquiry

Form submissions post to /api/form-submission. By default it only logs and can optionally forward to a webhook (see ALLOWED_WEBHOOK_DOMAINS).

SMTP (optional):

• If SMTP_HOST, SMTP_PORT, SMTP_FROM, and SMTP_TO are set, submissions will also be emailed via SMTP.

Notes

• NEXT_PUBLIC_API_URL should be a full Saleor GraphQL endpoint (ending in /graphql/).
• If you use remote images (logo/media), set NEXT_PUBLIC_IMAGE_HOSTS so next/image can load them.