# Paper Haven Books

[Paper Haven Books](https://books.mock.shop/llms.txt) is a [mock.shop](https://www.mock.shop/) sample store for building against a bookstore with stationery and reading gifts before a real Shopify store is ready. The catalog includes paperback and hardcover books, an anthology, a memoir, journals, pens, mugs, bookends, and candles. There are 60 products across five collections. Products have two to three variants each, with product-specific choices for building selectors.

mock.shop is an auth-free Shopify Storefront GraphQL API backed by sample reference stores. Find out more about [mock.shop sample stores](https://www.shopify.com/blog/mock-shop).

## When to use this store

Choose Paper Haven Books when you want to build a bookstore with stationery and reading gifts alongside paperback and hardcover books.

Use Paper Haven Books for:

- A bookstore that also sells journals, pens, mugs, and reading gifts
- Product pages with binding, paper, format, or capacity choices specific to each item
- Collections and carts mixing books with stationery and home accessories

Choose another mock.shop store if you need combined size and color selectors or a book-only catalog. Browse <https://mock.shop/llms.txt> to find a store that matches your catalog.

## Example Paper Haven Books query

Here’s an example GraphQL `POST` request that retrieves options and variant prices for one product from <https://books.mock.shop/api>:

```bash
curl https://books.mock.shop/api \
  -H 'Content-Type: application/json' \
  --data '{"query":"{ product(handle: \"elegant-ceramic-mug\") { id title options { name values } variants(first: 50) { pageInfo { hasNextPage } nodes { id title selectedOptions { name value } price { amount currencyCode } compareAtPrice { amount currencyCode } availableForSale } } } }"}'
```

This query retrieves Elegant Ceramic Mug, including option values, variant IDs, selected options, availability, and current and compare-at prices. Use the selected variant’s ID and price when adding it to a cart.

The endpoint doesn't require authentication or an access token. Read <https://books.mock.shop/llms.txt> for catalog details and store-specific instructions.

## What this catalog lets you test

Build book, stationery, and reading gift pages with collection browsing and mixed-item carts. Elegant Ceramic Mug uses Capacity (8oz, 12oz, 16oz). Use those returned values to build its selector. Prices stay the same across each product’s variants. Fifteen products have compare-at prices for sale displays. Collections such as The Morning Ritual Collection and Quiet Study Essentials support themed browsing. Other products use Binding, Lead Hardness, Tip Size, Paper Weight, or Format. Some sample products have ebook names, but all products require shipping in the saved data. Neither the names nor shipping flags establish digital delivery.

Preview the catalog in a storefront by opening <https://books.hydrogen.mock.shop> in a browser.

![Paper Haven Books product page for an elegant ceramic mug with book-stack illustration, $18.50, with studio shots on cream and marble and a person reading outdoors](images/paper-haven-books-elegant-ceramic-mug-20260911.webp)

## Build with an AI coding tool

To build a bookstore and reading gift storefront with Paper Haven Books using Claude, ChatGPT, Cursor, Lovable, or another AI assistant, copy the prompt below. It gives the assistant the store domain and directs it to the catalog instructions before it starts writing code.

```text
Build me a Hydrogen storefront using books.mock.shop as the store domain. Setup instructions: books.mock.shop/llms.txt
```

Shopify also provides a [mock.shop starter project](https://github.com/Shopify/mock-shop-starter): a Hydrogen storefront with product pages, collection browsing, and a working cart already connected to mock.shop. You or your AI coding tool can customize this code instead of building those pieces from scratch.

Follow the repository’s setup instructions, then set `PUBLIC_STORE_DOMAIN=books.mock.shop` in `.env` and restart the dev server to use Paper Haven Books’ catalog. Leave `PUBLIC_STOREFRONT_API_TOKEN` empty; mock.shop doesn’t require a token.

## Move to a real Shopify store

mock.shop uses fictional, read-only catalog data. Cart operations work, and checkout is mocked: no payment is taken and no real order is placed. The Customer Account API isn’t supported.

When you’re ready to launch, point your storefront at a Shopify store and add that store’s public Storefront API token. If you don’t have a Shopify store yet, [start a Shopify free trial](https://www.shopify.com/free-trial) to create one.

Read the [mock.shop developer documentation](https://shopify.dev/docs/storefronts/headless/mock-shop) for setup and migration details.

## Store facts

| | |
|---|---|
| Store handle | `books` |
| Catalog model | Bookstore with stationery and reading gifts |
| Products | 60 |
| Collections | 5 |
| Categories | 12 |
| Variants per product | 2–3 |
| Compare-at prices | 15 products |
| Requires shipping | All products |
| API endpoint | <https://books.mock.shop/api> |
| Store instructions | <https://books.mock.shop/llms.txt> |
| Browser preview | <https://books.hydrogen.mock.shop> |