# Storefront Orders

Customer order history with a tracking timeline for the selected order.

- id: `storefront-orders`
- Page: https://agentic-ui-kit.com/components/storefront-orders
- Live preview: https://agentic-ui-kit.com/storefront/account/orders?piece=storefront-orders

## Install

```bash
agentic-ui add storefront-orders
npx shadcn@4.17.0 add @agentic-ui/storefront-orders
```

## Metadata

- **Level:** page
- **Category:** page
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** order-list, status-filter, order-search, tracking-timeline, route-map, deep-link-to-order, placed-orders-appear
- **Intents:** track-status, explore-detail
- **Suits domains:** ecommerce, marketing
- **Interaction:** toggle-button, search, select-item, history-state
- **Screen role:** overview
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** customer order history with a tracking timeline for the selected order, my orders page with status filters, search and a delivery map, order tracking page that opens a given order from the confirmation link
- **Avoid when:** back office order management (use ecommerce-order-list)
- **Preserve when adapting:** single-h1-per-page, section-order, link-integrity
- **Replace when adapting:** brand-copy, content-data, links
- **Adaptation effort:** low
- **Coupling:** medium
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button
- **npm dependencies:** next, lucide-react, next-themes
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Used in:** Online Store (blueprint)
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** commerce-cart-drawer, commerce-order-tracking, commerce-reviews-block, commerce-variant-picker, lib-primitives, search-faceted-sidebar