# mock.shop

mock.shop is an auth-free Shopify Storefront GraphQL API backed by mock reference stores. Point an agent at it to build and test a storefront against realistic commerce data (products, collections, and carts) with no API keys and no setup.

## Start here

1. Read `https://mock.shop/llms.txt` for every published store and what it sells.
2. Pick a store. Each one serves the Storefront API at `https://<store>.mock.shop/api` and describes its own catalog at `https://<store>.mock.shop/llms.txt`. The bare apex `https://mock.shop/api` serves the default store.
3. Send GraphQL as an HTTP `POST` with a JSON body. The catalog answers without an access token; the `X-Shopify-Storefront-Access-Token: public` header below is the same header a real store expects, and it is what unlocks metafields:

```sh
curl -sS -X POST https://mock.shop/api \
  -H "Content-Type: application/json" \
  -H "X-Shopify-Storefront-Access-Token: public" \
  -d '{"query":"{ shop { name } products(first: 3) { nodes { title handle } } }"}'
```

The endpoint mirrors the Shopify Storefront API, so a query written against mock.shop runs unchanged against a real Shopify store. Build the storefront with [Shopify Hydrogen](https://shopify.dev/docs/storefronts/headless/hydrogen), deploy it on [Oxygen](https://shopify.dev/docs/storefronts/headless/hydrogen/deployments), and see the [Storefront API reference](https://shopify.dev/docs/api/storefront) for the full schema.