# Colorway Catalog block

> Ecommerce product grid with filters, sort, color swatches, and wishlist

Shoppable catalog with category, availability, sale, and color filters, price/newest/featured sort, per-card color swatches with image variants, and wishlist toggle. shadcn Card, Button, Select, Switch; ReUI Badge. Storefronts, apparel, shop pages.

- Type: Pro block
- Category: [Product Card](https://web.dev.reui.io/blocks/ecommerce/product-card.md)
- Page: https://web.dev.reui.io/blocks/ecommerce/product-card/product-card-2
- MCP: `get_block("product-card-2")`
- Built with: Badge, Breadcrumb, Button, Card, Field, Popover, Select, Switch
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Colorway swatches on each tile that swap its photo, plus a color family chip filter beside category, stock and sale filters

## Agent notes

- Each `colors` entry needs a swatch `className`, a `name` and its own `image`; the tile photo is the `selectedColor` image, so add a photo per color
- Filters read `category`, `availability` and `colorFamilies`, and Sale only keys off `discountBadge`; a real catalog needs those fields
- Sorting uses `priceValue`, `featuredRank` and `releaseRank`, while `price` is display text only; keep the numeric fields in step

## When not to use

- Collections to browse into, filtered by a toolbar, with nothing priced: use [Filterable Collections](https://web.dev.reui.io/blocks/ecommerce/category-card/category-card-2.md) (`get_block("category-card-2")`)
- A saved items page with bulk actions and price drop signals: use [Bulk Action Wishlist](https://web.dev.reui.io/blocks/ecommerce/wishlist/wishlist-1.md) (`get_block("wishlist-1")`)

## Install

```bash
npx shadcn@latest add @reui/product-card-2
```

## About Product Card blocks

### When to use

- A catalog or collection page of items for sale, from a plain tile grid to one with filters and sort
- A similar items or latest arrivals row that pages through 4 tiles at a time with arrow buttons
- A single item quick buy panel with a size or finish picker beside add to bag and wishlist buttons

### When not to use

- Dashboard or admin tiles for metrics, records or settings, with nothing for sale: use the [Card blocks](https://web.dev.reui.io/blocks/application/card.md)
- Departments or collections to browse into, with no per item price or buy control: use the [Category Card blocks](https://web.dev.reui.io/blocks/ecommerce/category-card.md)
- A full page for one item with its gallery, spec tables, reviews and related items: use the [Product Detail blocks](https://web.dev.reui.io/blocks/ecommerce/product-detail.md)

### Agent notes

- `ProductCard` takes no props and renders demo items defined in its own files; add a prop to pass in your catalog
- Every `price` and `compareAtPrice` is a preformatted dollar string; format amounts and currency before you pass them
- Each page.tsx wraps `ProductCard` in a padded `min-h-svh` wrapper; strip it when the block sits inside your storefront layout

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.