Homepage & Sections
The homepage is the store entry at/. Theme developers decide layout; Join Markt supplies store + products.
Goals
- Brand / hero
- Path to browse or buy (product grid or CTA →
/products) - Trust (policies, support links)
- Fast first paint — avoid huge client bundles on Nunjucks; code-split on Vite
Nunjucks homepage (templates/home.njk)
Optional: settings-driven featured IDs
Insettings.json:
Vite homepage
Default template:src/pages/LandingPage.tsx (or equivalent route /).
Pattern:
- Read
useStore()/ storefront bootstrap. - Render Visual Builder sections when present (Hero, Features, Product grid).
- Fallback static layout if no section config.
- Headline, subcopy, CTAs
- Optional hero image (
imageUrl,showImage,imageScale) - Search / stats toggles
products to cards linking to /product/:slug.
Developers customize section components in the theme; sellers edit content in Visual Builder without touching code.
Recommended homepage sections
Empty & loading states
Always handle:- Loading — skeleton while storefront API resolves (Vite)
- Empty catalog — “No products yet” instead of a blank grid
- Hidden products — respect platform visibility; do not show drafts