# mock.shop guides

Guides for building against mock.shop, the auth-free Shopify Storefront API
playground backed by mock reference stores.

Start with [`/llms.txt`](/llms.txt) for the public directory of stores and the
API recipe.

- [Search the mock-shop directory](shop-directory.md): ranked catalog discovery
  for agents, browsers, and server integrations, with no credentials.
- [Build a Hydrogen storefront](hydrogen.md): start with a matching mock.shop
  catalog, keep Hydrogen's commerce integration, and connect a real store later.

## Illustrating a guide

![How a docs image is served](images/docs-images.png)

That diagram is committed at `content/docs/guides/images/docs-images.png` and
embedded with the relative link `images/docs-images.png`, so one line of
markdown renders in the GitHub blob view and on this page alike. The rules live
in `content/README.md`: raster formats only, an `images/` directory beside the
page, roughly twice the display width so it stays sharp on a dense screen, and
ink that reads on both a light and a dark background.