# Joyful Gatherings Studio

[Joyful Gatherings Studio](https://family-pod.mock.shop/llms.txt) is a [mock.shop](https://www.mock.shop/) sample store for building against a family-celebration apparel catalog with color and size options before a real Shopify store is ready. It includes T-shirts, loungewear sets, bridal accessories, and milestone accessories. The catalog has 30 products across 4 collections. Every product requires shipping and has 12 variants from Color and Size options. Two distinct taxonomy categories share the display name T-Shirts.

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 Joyful Gatherings Studio when you’re building a family-celebration clothing shop with T-shirts, occasion accessories, and color and size selectors.

Use Joyful Gatherings Studio for:

- Family-celebration apparel storefronts with multi-option variants
- Category facets keyed by taxonomy ID rather than display name
- Product pages and cart items with selected color and size combinations

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

## Example Joyful Gatherings Studio query

Here’s an example GraphQL `POST` request that retrieves two T-shirt products with their taxonomy category IDs and display names from <https://family-pod.mock.shop/api>:

```bash
curl https://family-pod.mock.shop/api \
  -H 'Content-Type: application/json' \
  --data '{"query":"{ activewearTee: product(handle: \"graphic-t-shirt\") { id handle title category { id name } } clothingTee: product(handle: \"vintage-inspired-cotton-t-shirt\") { id handle title category { id name } } }"}'
```

This query returns product IDs, handles, titles, and taxonomy category IDs and names for each. `graphic-t-shirt` returns `category.name: "T-Shirts"` with ID `gid://shopify/TaxonomyCategory/aa-1-13-8`; `vintage-inspired-cotton-t-shirt` returns the same display name with the distinct ID `gid://shopify/TaxonomyCategory/aa-1-1-2-2`. Adapt the query for your storefront needs.

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

## What this catalog lets you test

Build a family-celebration apparel store with collection browsing, color and size selectors, and selected-variant cart items. The example query also gives you two T-shirts with the same category label but different taxonomy IDs, useful for testing category filters. Within Sun-Drenched Reunion Tees, each category contains four products. Keying a category facet by name would merge them into one group of eight; keying by ID preserves two groups of four. Across all 30 products, nine distinct category IDs map to eight distinct display names. The `category.name` field alone doesn't distinguish taxonomy paths, and the API doesn't return ancestor breadcrumbs from `category { name }`; check the store's `llms.txt` for full path descriptions.

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

![Joyful Gatherings Studio's Graphic T-Shirt product page with a product image, color and size selectors, and an Add to cart button.](images/joyful-gatherings-studio-graphic-t-shirt-20260911.webp)

## Build with an AI coding tool

To build a family-celebration apparel storefront with Joyful Gatherings Studio 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 family-pod.mock.shop as the store domain. Setup instructions: family-pod.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=family-pod.mock.shop` in `.env` and restart the dev server to use Joyful Gatherings Studio’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 | `family-pod` |
| Catalog model | Family-celebration apparel with color and size variants |
| Products | 30 |
| Collections | 4 |
| Categories | 9 |
| Variants per product | 12 |
| Compare-at prices | 7 products |
| Requires shipping | All products |
| API endpoint | <https://family-pod.mock.shop/api> |
| Store instructions | <https://family-pod.mock.shop/llms.txt> |
| Browser preview | <https://family-pod.hydrogen.mock.shop> |