# Storefront Shell

Frame shared by every page of an online store: announcement, header with search and cart, footer.

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

## Install

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

## Metadata

- **Level:** layout
- **Category:** layout
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** announcement-bar, header-search-autocomplete, wishlist-and-order-links, cart-button-with-count, side-cart-drawer, skip-link, footer-link-columns
- **Intents:** navigate, manage-collection
- **Suits domains:** ecommerce, marketing
- **Interaction:** click, typeahead, dialog, keyboard-focus, dismiss
- **Screen role:** overview
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** frame shared by every page of an online store: announcement, header with search and cart, footer, storefront shell with a side cart that opens after add to cart, e-commerce header with predictive search, wishlist, orders and cart count
- **Avoid when:** admin back office for the shop owner (use an admin shell with a sidebar)
- **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, marketing-announcement-bar, marketing-footer, search-autocomplete, search-faceted-sidebar