---
title: Routes
description: Every URL in the storefront and its purpose.
type: reference
---

# Routes



## Pages

| Route                              | Description                                                                                        |
| ---------------------------------- | -------------------------------------------------------------------------------------------------- |
| `/`                                | Home page with hero, products grid, info section                                                   |
| `/products/[handle]`               | Product detail page; `?color=…&size=…` option params select a variant                              |
| `/collections`                     | All-collections index; each card links to a collection, image falls back to its first product      |
| `/collections/[handle]`            | Collection listing with filters, sort, pagination                                                  |
| `/collections/all`                 | Virtual "All Products" listing; synthesized since Shopify's Storefront API has no `all` collection |
| `/search`                          | Search results (same grid as collections)                                                          |
| `/cart`                            | Full cart page with related products                                                               |
| `/blogs/[blogHandle]`              | Shopify blog listing with latest articles                                                          |
| `/blogs/[blogHandle]/[postHandle]` | Shopify article with localized rich text and SEO metadata                                          |
| `/pages/[handle]`                  | Shopify Page with localized rich text and SEO metadata                                             |
| `/policies/[handle]`               | Configured Shopify store policy                                                                    |

## API routes

| Route                        | Description                                    |
| ---------------------------- | ---------------------------------------------- |
| `POST /api/webhooks/shopify` | Shopify webhook handler for cache invalidation |
| `GET /api/draft`             | Draft mode toggle for content preview          |
| `POST /api/chat`             | Guarded AI SDK shopping-assistant stream       |

## Variant URLs

Product variant selection uses one query parameter per option, keyed by the lowercased option name:

| URL                                    | Purpose                                                   |
| -------------------------------------- | --------------------------------------------------------- |
| `/products/:handle?color=Blue&size=XS` | Opens the product page with the matching variant selected |
| `/products/:handle`                    | No options selected — renders the first available variant |


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)