# Shadcn Wishlist blocks

> Wishlist and favorites list interfaces with product cards and save-for-later actions.

- Type: Pro blocks (eCommerce)
- Page: https://web.dev.reui.io/blocks/ecommerce/wishlist
- Blocks: 6
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## When to use

- A saved items page in a shopper account, with prices, savings and add to cart on each product
- Price drop, back in stock and low stock badges that flag which saved products to buy now
- Named collections or priority groups that sort saved products by occasion, recipient or intent to buy

## When not to use

- A dashboard side panel of metrics, transactions or integrations, with nothing to buy: use the [List blocks](https://web.dev.reui.io/blocks/application/list.md)
- A lone price drop or low stock label on a product tile you already render: use [Badge](https://web.dev.reui.io/components/badge.md) (`get_component("badge")`)
- A back office table of records narrowed by field, operator and value chips: use the [Filtering blocks](https://web.dev.reui.io/blocks/data-grid/filtering.md)

## Agent notes

- Every root seeds `useState` with the demo constants in components/data.tsx and saves nothing; load and persist the list through your own wishlist API
- Every Share control is a stub, a button with no `onClick` or the no-op `handleShare`; wire it to your share link or clipboard flow
- Each page.tsx adds a `min-h-svh` wrapper and each root sets its own max width and `h1`; drop the wrapper and keep one `h1` in your storefront layout

## Blocks

- [Bulk Action Wishlist](https://web.dev.reui.io/blocks/ecommerce/wishlist/wishlist-1.md): Wishlist List View With Multi-Select Bulk Actions, Stock Status, and Price-Drop Signal Badges. Best for checkbox rows with a select all toolbar that swaps to bulk remove and add to cart, under a signal count and savings summary.
- [Restock Alert Wishlist](https://web.dev.reui.io/blocks/ecommerce/wishlist/wishlist-2.md): Saved-items wishlist grid with price-drop and restock signal badges plus status tabs. Best for portrait 4:5 photo cards that gray out unavailable items, with status tabs that disable at zero and a Restock Alert On state.
- [Move-to-Cart Wishlist](https://web.dev.reui.io/blocks/ecommerce/wishlist/wishlist-3.md): Wishlist Grid With Stock and Price-Drop Signal Badges and Tab Filters. Best for square cards that leave the list on Move To Cart, with amount off and units left badges, a Sale tab and a detail caption.
- [Wishlist Boards](https://web.dev.reui.io/blocks/ecommerce/wishlist/wishlist-4.md): Wishlist Collections Grid with 2x2 Cover Mosaic Cards and Filter Tabs. Best for board level browsing with no product rows, each board a 2x2 photo mosaic, plus Shared and Recently Updated tabs.
- [Priority Wishlist](https://web.dev.reui.io/blocks/ecommerce/wishlist/wishlist-5.md): Priority-Grouped Wishlist with Stock Status and Savings Summary. Best for must Have, Save For Later and Maybe sections, a button that cycles an item to the next priority and a total that skips unavailable items.
- [Collection Rail Wishlist](https://web.dev.reui.io/blocks/ecommerce/wishlist/wishlist-6.md): Multi-Collection Wishlist with Cover-Stacked Collection Rail. Best for a two pane layout where a rail of stacked cover tiles picks one collection and the pane adds all its products to cart.

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.
