Product listPro
Work screens / Product list: a shop's catalogue. Collections with counts, a search, colour swatches, an Under $150 filter, a sort (Featured, price either way, Newest) and Grid / List. Cards show the price (sale prices struck through), rating, colours and stock in words and colour; open one for its product page.
oxyn add product-list- Fellside Goods
- Products
10 of 10 products
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Find a product in a shop catalogue by collection, colour and price, and open it.
When not to use
- Mail folders with counts and labels beside a message list: use Inbox sidebar instead.
- The app frame: use App shell instead.
- An assistant docked beside a page: use AI side panel instead.
Installation
Product list is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add product-listUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Sample
Sample data, the page as an inset card beside the sidebar.
- Fellside Goods
- Products
10 of 10 products
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Flat
The same view with the page edge to edge.
- Fellside Goods
- Products
10 of 10 products
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Loading
Skeletons where the data lands.
- Fellside Goods
- Products
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Empty
A first run: what will show here and how to start.
- Fellside Goods
- Products
No products yet
Add your first product or import a catalogue from a spreadsheet.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Filtered
Outerwear under $200 with Clear filters.
- Fellside Goods
- Products
1 of 10 products
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Listview
The catalogue as a table.
- Fellside Goods
- Products
10 of 10 products
| Product | Collection | Stock | Price |
|---|---|---|---|
| Outerwear | In stock | $289.00 | |
| Outerwear | In stock | $165.00 | |
| Outerwear | 5 left | $224.00 | |
| Knitwear | In stock | $98.00 | |
| Knitwear | In stock | $124.00 | |
| Knitwear | In stock | $32.00 | |
| Footwear | In stock | $138.00 | |
| Footwear | 4 left | $245.00 | |
| Bags | In stock | $58.00 | |
| Bags | In stock | $112.00 |
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Nomatch
A search with no products and a way back.
- Fellside Goods
- Products
0 of 10 products
No products match
Try another colour or price, or clear the filters.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
ProductListScreen
| Prop | Type | Default | Description |
|---|---|---|---|
layout | String | "inset" | `inset` or `flat`. |
state | String | "sample" | A state key. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Collections, search, swatches, filters, then the products |
| Escape | Clear the search |
Accessibility
- The result count is a status region; swatches are toggle buttons named with their colour.
- Stock is written out (In stock, 3 left, Sold out), not only coloured.
Responsive behaviour
- Authored on the 1440 × 900 canvas: a 248 px sidebar, the page as an inset card and, where the screen has one, a 328 px right card in the gutter.
- Under 960 px the sidebar becomes a drawer from the header's menu button and the right card hides.
- Under 640 px header actions turn into icon buttons, grids drop to one column and labels ellipsise.
Edge cases (spec)
Authored on the 1440 × 900 stage and scaled to its column; /full renders at the real viewport. Under 960 px the sidebar is a drawer from the header's menu button (Escape or the scrim closes it) and the right card hides. Under 640 px header actions become icon buttons and the meta line hides. scripts/ovl.py finds no text overlap at 1440, 768 and 390 in light and dark. Under 640 px the grid is two columns and ratings hide on cards.
Notes for AI
- Import
ProductListScreenfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
ProductListElinoxyn_gpui. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.