# BrightHue Harbor

[BrightHue Harbor](https://craft-supplies.mock.shop/llms.txt) is a [mock.shop](https://www.mock.shop/) sample store for building against a collection-organized craft-supplies catalog before a real Shopify store is ready. It includes weaving kits, painting supplies, drawing surfaces, and sculpting materials. The catalog has 60 products across 5 collections. Forty-eight products return no category, but every product belongs to a collection. The remaining 12 products share one category.

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 BrightHue Harbor when you’re building an arts-and-crafts supply shop with collections for browsing weaving, painting, drawing, and sculpting products.

Use BrightHue Harbor for:

- Craft-supplies storefronts organized into collections
- Product cards that handle `category: null` without dropping the product
- Separate rendering of collection membership, product type, and taxonomy

Choose another mock.shop store if you need multi-option products or nonshipping digital goods. Browse <https://mock.shop/llms.txt> to find a store that matches your catalog.

## Example BrightHue Harbor query

Here’s an example GraphQL `POST` request that retrieves one uncategorized product and one categorized product with their collections from <https://craft-supplies.mock.shop/api>:

```bash
curl https://craft-supplies.mock.shop/api \
  -H 'Content-Type: application/json' \
  --data '{"query":"{ withoutCategory: product(handle: \"natural-fiber-weaving-kit\") { id handle title category { name } productType collections(first: 5) { pageInfo { hasNextPage } nodes { title handle } } } withCategory: product(handle: \"creative-canvas-educational-toy-kit\") { id handle title category { name } productType collections(first: 5) { pageInfo { hasNextPage } nodes { title handle } } } }"}'
```

This query returns product IDs, handles, titles, categories, product types, and collection membership. Natural Fiber Weaving Kit returns `category: null` and belongs to `textured-fiber-weaves`; Creative Canvas Educational Toy Kit returns the category Art & Craft Kits and belongs to `pigmented-studio-essentials`. Adapt the query for your storefront needs.

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

## What this catalog lets you test

Build collection navigation and product cards for a craft-supplies shop. Use the two products to test both a category label and its missing-value fallback, while retaining each product in its collection. Natural Fiber Weaving Kit has the product type Textured Fiber Weaves, but that string isn’t a replacement taxonomy category. Across all five collections, 48 uncategorized products and 12 categorized products let you check that collection browsing doesn’t depend on `category.name` being present.

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

![BrightHue Harbor’s Natural Fiber Weaving Kit with three product images, Lace, Worsted, and Chunky Weight options, and an Add to cart button.](images/brighthue-harbor-natural-fiber-weaving-kit-20260911.webp)

## Build with an AI coding tool

To build a craft-supplies storefront with BrightHue Harbor 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 craft-supplies.mock.shop as the store domain. Setup instructions: craft-supplies.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=craft-supplies.mock.shop` in `.env` and restart the dev server to use BrightHue Harbor’s 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 | `craft-supplies` |
| Catalog model | Craft supplies organized into collections, with product-specific options |
| Products | 60 |
| Collections | 5 |
| Categories | 1 |
| Variants per product | 2–3 |
| Compare-at prices | 18 products |
| Requires shipping | All products |
| API endpoint | <https://craft-supplies.mock.shop/api> |
| Store instructions | <https://craft-supplies.mock.shop/llms.txt> |
| Browser preview | <https://craft-supplies.hydrogen.mock.shop> |