Commerce Navigation
A shop announcement, centred wordmark, collection links, and shopping bag.
Make it yours.
Install the editable source and its dependencies into your React + Tailwind project.
Scroll horizontally for long lines
pnpm dlx shadcn@4.0.8 add http://localhost:3000/r/commerce-navigation.jsonUse it
Scroll horizontally for long lines
"use client";
import { CommerceNavigation } from "@/components/jez-ui/blocks/commerce-navigation";
export default function Example() {
return (
<>
<CommerceNavigation />
</>
);
}
Compose your own
These styled parts are included in the same install. Use children to build your layout; add className only when you want an override.
Scroll horizontally for long lines
"use client";
import {
CommerceNavigation,
CommerceNavigationAnnouncement,
CommerceNavigationToolbar,
CommerceNavigationMobileMenu,
} from "@/components/jez-ui/blocks/commerce-navigation";
export default function Example() {
return (
<CommerceNavigation>
<CommerceNavigationAnnouncement />
<CommerceNavigationToolbar />
<CommerceNavigationMobileMenu />
</CommerceNavigation>
);
}
Scroll horizontally for long lines
import { CommerceNavigation, CommerceNavigationDescription, CommerceNavigationContent, CommerceNavigationAnnouncement, CommerceNavigationToolbar, CommerceNavigationMobileMenu } from "@/components/jez-ui/blocks/commerce-navigation";Props & types
Scroll horizontally for long lines
export type CommerceNavigationOptions = {
className?: string;
cartCount?: number;
description?: React.ReactNode;
};
export type CommerceNavigationProps = Omit<
React.ComponentProps<"header">,
keyof CommerceNavigationOptions
> &
CommerceNavigationOptions;
CommerceNavigationPropsSource
View 2 source files
registry/blocks/commerce-navigation.tsx
Scroll horizontally for long lines
"use client";
import * as React from "react";
import { Search, ShoppingBag, Menu, X } from "lucide-react";
import { cn } from "../ui/utils";
export type CommerceNavigationOptions = {
className?: string;
cartCount?: number;
description?: React.ReactNode;
};
export type CommerceNavigationProps = Omit<
React.ComponentProps<"header">,
keyof CommerceNavigationOptions
> &
CommerceNavigationOptions;
function useCommerceNavigationModel({
description = "Considered objects for everyday living.",
className,
cartCount = 0,
children,
...rootProps
}: CommerceNavigationProps) {
const [open, setOpen] = React.useState(false);
return {
description,
className,
cartCount,
children,
rootProps,
open,
setOpen,
};
}
const CommerceNavigationCompositionContext = React.createContext<ReturnType<
typeof useCommerceNavigationModel
> | null>(null);
function useCommerceNavigationComposition() {
const context = React.useContext(CommerceNavigationCompositionContext);
if (!context)
throw new Error(
"CommerceNavigation parts must be inside CommerceNavigation.",
);
return context;
}
export function CommerceNavigation(props: CommerceNavigationProps) {
const model = useCommerceNavigationModel(props);
const { className, rootProps, children } = model;
return (
<CommerceNavigationCompositionContext.Provider value={model}>
<header
{...rootProps}
className={cn(
"overflow-hidden rounded-xl border border-border bg-background",
className,
)}
>
{children !== undefined ? (
children
) : (
<>
<CommerceNavigationAnnouncement />
<CommerceNavigationToolbar />
<CommerceNavigationMobileMenu />
</>
)}
</header>
</CommerceNavigationCompositionContext.Provider>
);
}
export function CommerceNavigationDescription({
className,
...props
}: React.ComponentProps<"p">) {
return (
<p
data-slot="commerce-navigation-description"
className={cn(
"bg-primary px-5 py-2 text-center text-[11px] tracking-wide text-primary-foreground",
className,
)}
{...props}
/>
);
}
export function CommerceNavigationContent({
className,
...props
}: React.ComponentProps<"div">) {
return (
<div
data-slot="commerce-navigation-content"
className={cn(
"grid grid-cols-[1fr_auto_1fr] items-center gap-4 p-5 md:p-7",
className,
)}
{...props}
/>
);
}
export function CommerceNavigationAnnouncement({
children,
...props
}: Partial<React.ComponentProps<typeof CommerceNavigationDescription>> & {
children?: React.ReactNode;
}) {
const { description } = useCommerceNavigationComposition();
return (
<CommerceNavigationDescription {...props}>
{children === undefined ? description : children}
</CommerceNavigationDescription>
);
}
export function CommerceNavigationToolbar({
children,
...props
}: Partial<React.ComponentProps<typeof CommerceNavigationContent>> & {
children?: React.ReactNode;
}) {
const { cartCount, open, setOpen } = useCommerceNavigationComposition();
return (
<CommerceNavigationContent {...props}>
{children === undefined ? (
<>
<button
aria-label={open ? "Close menu" : "Open menu"}
aria-expanded={open}
onClick={() => setOpen(!open)}
className="w-fit rounded p-2 md:hidden"
>
{open ? <X size={19} /> : <Menu size={19} />}
</button>
<nav
aria-label="Shop navigation"
className="hidden gap-5 text-xs md:flex"
>
<a
href="/templates/storefront/preview/collection"
className="hover:underline"
>
Shop all
</a>
<a
href="/templates/storefront/preview/product/studio-lamp"
className="hover:underline"
>
Lighting
</a>
</nav>
<a
href="/templates/storefront/preview"
className="font-serif text-3xl tracking-tight"
>
Objects.
</a>
<div className="flex items-center justify-end gap-3">
<a
href="/templates/storefront/preview/collection"
aria-label="Browse products"
className="grid size-9 place-items-center rounded-full hover:bg-muted"
>
<Search size={18} />
</a>
<a
href="/templates/storefront/preview/cart"
aria-label={`Shopping bag, ${cartCount} items`}
className="flex items-center gap-1 rounded p-2 hover:bg-muted"
>
<ShoppingBag size={18} />
<span className="text-xs">{cartCount}</span>
</a>
</div>
</>
) : (
children
)}
</CommerceNavigationContent>
);
}
export function CommerceNavigationMobileMenu({
children,
}: React.PropsWithChildren) {
const { open } = useCommerceNavigationComposition();
return children === undefined
? open && (
<nav
aria-label="Mobile shop navigation"
className="grid gap-4 border-t border-border p-6 text-sm md:hidden"
>
<a href="/templates/storefront/preview/collection">Shop all</a>
<a href="/templates/storefront/preview/product/studio-lamp">
Lighting
</a>
</nav>
)
: children;
}
registry/ui/utils.ts
Scroll horizontally for long lines
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";
export function cn(...values: ClassValue[]) {
return twMerge(clsx(values));
}
Dependencies
lucide-react@0.577.0 · clsx@2.1.1 · tailwind-merge@3.5.0
Accessibility & behaviour
Provide meaningful labels and preserve keyboard focus styles. Check contrast when customising theme colours.
Read the accessibility and performance guide →