Skip to content
Back

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
  1. Fellside Goods
  2. Products
10 products

10 of 10 products

The code is part of Oxyn Pro

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.

Get Pro

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.

Terminal
oxyn add product-list

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Sample

Sample data, the page as an inset card beside the sidebar.

  1. Fellside Goods
  2. Products
10 products

10 of 10 products

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Flat

The same view with the page edge to edge.

  1. Fellside Goods
  2. Products
10 products

10 of 10 products

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Loading

Skeletons where the data lands.

  1. Fellside Goods
  2. Products
10 products
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Empty

A first run: what will show here and how to start.

  1. Fellside Goods
  2. Products
0 products

No products yet

Add your first product or import a catalogue from a spreadsheet.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Filtered

Outerwear under $200 with Clear filters.

  1. Fellside Goods
  2. Products
10 products

1 of 10 products

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Listview

The catalogue as a table.

  1. Fellside Goods
  2. Products
10 products

10 of 10 products

ProductCollectionStockPrice
OuterwearIn stock$289.00
OuterwearIn stock$165.00
Outerwear5 left$224.00
KnitwearIn stock$98.00
KnitwearIn stock$124.00
KnitwearIn stock$32.00
FootwearIn stock$138.00
Footwear4 left$245.00
BagsIn stock$58.00
BagsIn stock$112.00
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Nomatch

A search with no products and a way back.

  1. Fellside Goods
  2. Products
10 products

0 of 10 products

No products match

Try another colour or price, or clear the filters.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

ProductListScreen

PropTypeDefaultDescription
layoutString"inset"`inset` or `flat`.
stateString"sample"A state key.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabCollections, search, swatches, filters, then the products
EscapeClear 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 ProductListScreen from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: ProductListEl in oxyn_gpui.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI