Product Detail New
A product page section with a zoomable gallery, frame and size pickers with stock, quantity, an add-to-cart button with states, a delivery estimate and details.
Installation
01
Install with the shadcn CLI. The NiceUI theme comes along the first time.
$ npx shadcn@latest add https://niceui.dev/r/commerce-product-detail.json02
Or copy the source below (4 files). Dependencies: lucide-react.
Source
components/niceui/commerce/ProductDetail.tsx
import { useEffect, useRef, useState } from 'react';
import { Check, ChevronDown, LoaderCircle, Minus, Plus, RotateCcw, ShoppingBag, Star, Truck } from 'lucide-react';
import { cn } from '@/lib/cn';
import { PRODUCTS, artistOf, money, type Product } from './data';
import { Print } from './Print';
type AddState = 'idle' | 'adding' | 'added';
export type ProductDetailProps = { product: Product; onAdd?: (p: Product, opts: { frame: string; size: string; qty: number }) => void; className?: string };
function deliveryWindow() {
const d = new Date();
const from = new Date(d.getTime() + 3 * 864e5);
const to = new Date(d.getTime() + 5 * 864e5);
const f = (x: Date) => x.toLocaleDateString('en-US', { weekday: 'short', month: 'short', day: 'numeric' });
return `${f(from)} – ${f(to)}`;
}
export function ProductDetail({ product: p, onAdd, className }: ProductDetailProps) {
const shots = [p.art[0], p.art[1], (p.art[0] + 2) % 12, (p.art[1] + 3) % 12];
const [shot, setShot] = useState(0);
const [frame, setFrame] = useState(p.swatches[0]);
const [size, setSize] = useState(p.sizes.find((s) => s.stock)!.label);
const [qty, setQty] = useState(1);
const [state, setState] = useState<AddState>('idle');
const [open, setOpen] = useState<string | null>('Details');
const [zoom, setZoom] = useState<{ x: number; y: number } | null>(null);
const timers = useRef<number[]>([]);
useEffect(() => () => timers.current.forEach(clearTimeout), []);
const stock = p.sizes.find((s) => s.label === size)!.stock;
const add = () => {
if (state !== 'idle') return;
setState('adding');
timers.current.push(window.setTimeout(() => (setState('added'), onAdd?.(p, { frame: frame.name, size, qty })), 700));
timers.current.push(window.setTimeout(() => setState('idle'), 2400));
};
const sections: [string, string][] = [
['Details', `Archival pigment print on 310gsm cotton rag. Signed and numbered by ${artistOf(p)}. Edition of 250.`],
['Framing', 'Solid timber frame, museum glass with 99% UV protection, acid-free mount. Arrives ready to hang.'],
['Shipping & returns', 'Free shipping over $150. Packed flat in a reinforced crate. Free returns within 30 days.'],
];
return (
<div className={cn('grid w-full gap-6 rounded-2xl bg-ink-900 p-4 shadow-card sm:p-5 md:grid-cols-[minmax(0,1.05fr)_minmax(0,1fr)] md:gap-8', className)}>
{/* gallery */}
<div className="min-w-0">
<div
className="relative aspect-[4/5] cursor-zoom-in overflow-hidden rounded-xl"
onPointerMove={(e) => {
if (e.pointerType !== 'mouse') return;
const r = e.currentTarget.getBoundingClientRect();
setZoom({ x: ((e.clientX - r.left) / r.width) * 100, y: ((e.clientY - r.top) / r.height) * 100 });
}}
onPointerLeave={() => setZoom(null)}
>
<div className="absolute inset-0 transition-transform duration-300 ease-out" style={{ transform: zoom ? 'scale(1.9)' : 'scale(1)', transformOrigin: zoom ? `${zoom.x}% ${zoom.y}%` : 'center' }}>
<Print key={shots[shot]} art={shots[shot]} frame={frame.hex} className="h-full w-full animate-fade-in" />
</div>
{p.badge && <span className="absolute left-3 top-3 rounded-full bg-rose-500 px-2 py-0.5 text-[10.5px] font-medium text-white">{p.badge}</span>}
<span className="absolute bottom-3 right-3 rounded-full bg-black/50 px-2 py-0.5 font-mono text-[10px] text-white/80 backdrop-blur">Hover to zoom</span>
</div>
<div className="mt-3 grid grid-cols-4 gap-2" role="tablist" aria-label="Product images">
{shots.map((a, i) => (
<button
key={i}
role="tab"
aria-selected={shot === i}
aria-label={`Image ${i + 1}`}
onClick={() => setShot(i)}
className={cn('focus-ring overflow-hidden rounded-lg ring-1 transition-all', shot === i ? 'ring-2 ring-brand-300' : 'opacity-60 ring-white/10 hover:opacity-100')}
>
<Print art={a} frame={frame.hex} className="aspect-square" />
</button>
))}
</div>
</div>
{/* info */}
<div className="min-w-0">
<p className="font-mono text-[10.5px] uppercase tracking-[0.16em] text-ink-500">{p.kind} · {artistOf(p)}</p>
<h3 className="mt-2 text-2xl font-semibold tracking-tight text-ink-50">{p.name}</h3>
<div className="mt-2 flex flex-wrap items-center gap-3 text-[13px]">
<span className="flex items-center gap-0.5">
{[0, 1, 2, 3, 4].map((i) => (
<Star key={i} className={cn('h-3.5 w-3.5', i < Math.round(p.rating) ? 'fill-amber-300 text-amber-300' : 'text-ink-600')} />
))}
</span>
<span className="text-ink-400">{p.rating.toFixed(1)} · {p.reviews} reviews</span>
</div>
<p className="mt-4 flex items-baseline gap-2">
<span className="text-2xl font-medium tabular-nums text-ink-50">{money(p.price * qty)}</span>
{p.compareAt && <span className="text-sm tabular-nums text-ink-500 line-through">{money(p.compareAt * qty)}</span>}
</p>
<fieldset className="mt-5">
<legend className="text-[12px] text-ink-400">Frame · <span className="text-ink-100">{frame.name}</span></legend>
<div className="mt-2 flex gap-2">
{p.swatches.map((s) => (
<button
key={s.name}
onClick={() => setFrame(s)}
aria-pressed={frame.name === s.name}
className={cn('focus-ring flex items-center gap-2 rounded-full border px-3 py-1.5 text-[12.5px] transition-colors', frame.name === s.name ? 'border-brand-400/60 bg-brand-500/10 text-ink-50' : 'border-white/10 text-ink-300 hover:border-white/20')}
>
<span className="h-3 w-3 rounded-full ring-1 ring-white/20" style={{ background: s.hex }} />
{s.name}
</button>
))}
</div>
</fieldset>
<fieldset className="mt-4">
<legend className="text-[12px] text-ink-400">Size</legend>
<div className="mt-2 grid grid-cols-4 gap-2">
{p.sizes.map((s) => (
<button
key={s.label}
disabled={!s.stock}
onClick={() => setSize(s.label)}
aria-pressed={size === s.label}
className={cn(
'focus-ring relative rounded-lg border py-2 text-[13px] font-medium transition-colors',
size === s.label ? 'border-brand-400/60 bg-brand-500/10 text-ink-50' : 'border-white/10 text-ink-300 hover:border-white/20',
!s.stock && 'cursor-not-allowed text-ink-600 line-through hover:border-white/10',
)}
>
{s.label}
</button>
))}
</div>
<p className={cn('mt-2 text-[12px]', stock <= 4 ? 'text-amber-300' : 'text-emerald-300')}>{stock <= 4 ? `Only ${stock} left in ${size}` : 'In stock, ships today'}</p>
</fieldset>
<div className="mt-5 flex gap-2">
<div className="flex items-center rounded-xl bg-white/5 shadow-hairline">
<button aria-label="Decrease quantity" onClick={() => setQty((q) => Math.max(1, q - 1))} className="focus-ring grid h-11 w-10 place-items-center text-ink-300 hover:text-ink-50">
<Minus className="h-3.5 w-3.5" />
</button>
<span className="w-6 text-center font-mono text-sm tabular-nums text-ink-50" aria-live="polite">{qty}</span>
<button aria-label="Increase quantity" onClick={() => setQty((q) => Math.min(stock, q + 1))} className="focus-ring grid h-11 w-10 place-items-center text-ink-300 hover:text-ink-50">
<Plus className="h-3.5 w-3.5" />
</button>
</div>
<button
onClick={add}
className={cn('focus-ring flex h-11 flex-1 items-center justify-center gap-2 rounded-xl text-sm font-medium transition-all active:scale-[0.98]', state === 'added' ? 'bg-emerald-500 text-white' : 'bg-brand-400 text-ink-950 hover:bg-brand-300')}
>
{state === 'adding' ? <LoaderCircle className="h-4 w-4 animate-spin" /> : state === 'added' ? <><Check className="h-4 w-4" /> Added to cart</> : <><ShoppingBag className="h-4 w-4" /> Add to cart</>}
</button>
</div>
<div className="mt-4 space-y-1.5 text-[12.5px] text-ink-400">
<p className="flex items-center gap-2"><Truck className="h-3.5 w-3.5 text-ink-500" /> Arrives <span className="text-ink-100">{deliveryWindow()}</span></p>
<p className="flex items-center gap-2"><RotateCcw className="h-3.5 w-3.5 text-ink-500" /> Free 30-day returns</p>
</div>
<div className="mt-5 divide-y divide-white/5 border-y border-white/5">
{sections.map(([title, body]) => {
const on = open === title;
return (
<div key={title}>
<button onClick={() => setOpen(on ? null : title)} aria-expanded={on} className="focus-ring flex w-full items-center justify-between py-3 text-left text-[13px] font-medium text-ink-100">
{title}
<ChevronDown className={cn('h-4 w-4 text-ink-500 transition-transform duration-300', on && 'rotate-180')} />
</button>
<div className={cn('grid transition-all duration-300 ease-smooth', on ? 'grid-rows-[1fr] opacity-100' : 'grid-rows-[0fr] opacity-0')}>
<p className="overflow-hidden pb-3 text-[12.5px] leading-relaxed text-ink-400">{body}</p>
</div>
</div>
);
})}
</div>
</div>
</div>
);
}
export function ProductDetailDemo() {
return (
<div className="w-full max-w-4xl">
<ProductDetail product={PRODUCTS[1]} />
</div>
);
}components/niceui/commerce/data.ts
import { ARTWORKS, artwork } from '@/components/niceui/gallery/art';
export type Swatch = { name: string; hex: string };
export type Product = {
id: number;
name: string;
kind: string;
price: number;
compareAt?: number;
badge?: 'New' | 'Sale' | 'Limited';
rating: number;
reviews: number;
art: [number, number];
swatches: Swatch[];
sizes: { label: string; stock: number }[];
};
const FRAMES: Swatch[] = [
{ name: 'Oak', hex: '#c8a27a' },
{ name: 'Black', hex: '#1c1c1f' },
{ name: 'White', hex: '#f1efe9' },
];
const SIZES = [
{ label: 'A4', stock: 12 },
{ label: 'A3', stock: 4 },
{ label: 'A2', stock: 0 },
{ label: 'A1', stock: 2 },
];
export const PRODUCTS: Product[] = [
{ id: 0, name: 'Low Tide, Dawn', kind: 'Giclée print', price: 68, badge: 'New', rating: 4.9, reviews: 214, art: [0, 6], swatches: FRAMES, sizes: SIZES },
{ id: 1, name: 'Neon Bloom', kind: 'Framed print', price: 96, compareAt: 128, badge: 'Sale', rating: 4.7, reviews: 98, art: [1, 8], swatches: FRAMES.slice(0, 2), sizes: SIZES },
{ id: 2, name: 'Glass Lagoon', kind: 'Canvas', price: 142, rating: 4.8, reviews: 61, art: [2, 7], swatches: FRAMES, sizes: SIZES },
{ id: 3, name: 'Copper Dunes', kind: 'Giclée print', price: 74, badge: 'Limited', rating: 5, reviews: 33, art: [3, 11], swatches: FRAMES.slice(1), sizes: SIZES },
{ id: 4, name: 'Fog Study No. 4', kind: 'Framed print', price: 88, rating: 4.6, reviews: 120, art: [4, 10], swatches: FRAMES, sizes: SIZES },
{ id: 5, name: 'Green Hour', kind: 'Canvas', price: 118, compareAt: 150, badge: 'Sale', rating: 4.8, reviews: 76, art: [5, 9], swatches: FRAMES.slice(0, 2), sizes: SIZES },
];
export const img = (artId: number, w = 600, h = 750) => artwork(artId, w, h);
export const artistOf = (p: Product) => ARTWORKS[p.art[0]].artist;
export const money = (n: number) => `$${n.toFixed(n % 1 ? 2 : 0)}`;components/niceui/gallery/art.ts
/*
* Procedural artwork for the gallery demos: soft landscapes and abstract mesh
* gradients with film grain, rendered once to data URLs. Swap `src` for real
* photos in your app — every gallery component just takes image URLs.
*/
export type Artwork = { id: number; title: string; artist: string; place: string; year: number; tone: 'warm' | 'cool' | 'dusk' | 'mono' };
const PALETTES: string[][] = [
['#0b1d3a', '#1f4e79', '#f2a65a', '#f7d9a8'],
['#120c26', '#4b2a77', '#e66b9d', '#ffd1b3'],
['#06222b', '#0f5f6b', '#7fd1c7', '#e8f6f1'],
['#1b1410', '#5b3a26', '#d98c4a', '#f6e1c3'],
['#0e0f13', '#2b2f3a', '#8a93a6', '#e6e8ee'],
['#0a1a12', '#1f5134', '#9cc98a', '#f1f7da'],
['#1a0f14', '#6b1f3a', '#ef6f5e', '#ffd8a8'],
['#071426', '#123f73', '#5aa9e6', '#d6ecff'],
['#191325', '#3b2d5c', '#b39ddb', '#f3e9ff'],
['#201608', '#6e4a12', '#e0b34a', '#fff1c4'],
['#0b1216', '#29424f', '#6fa3b8', '#f0e6d2'],
['#170b0b', '#4a1414', '#c84b31', '#f5c26b'],
];
export const ARTWORKS: Artwork[] = [
{ id: 0, title: 'Low Tide, Dawn', artist: 'Mira Okafor', place: 'Comporta', year: 2025, tone: 'warm' },
{ id: 1, title: 'Neon Bloom', artist: 'Ilya Varga', place: 'Kyoto', year: 2024, tone: 'dusk' },
{ id: 2, title: 'Glass Lagoon', artist: 'Sana Iqbal', place: 'Faroe Islands', year: 2025, tone: 'cool' },
{ id: 3, title: 'Copper Dunes', artist: 'Teo Marchetti', place: 'Merzouga', year: 2023, tone: 'warm' },
{ id: 4, title: 'Fog Study No. 4', artist: 'Lena Brandt', place: 'Dolomites', year: 2024, tone: 'mono' },
{ id: 5, title: 'Green Hour', artist: 'Ravi Menon', place: 'Munnar', year: 2025, tone: 'cool' },
{ id: 6, title: 'Ember Coast', artist: 'Noor Haddad', place: 'Big Sur', year: 2024, tone: 'warm' },
{ id: 7, title: 'Blue Hour Harbour', artist: 'Jonas Weber', place: 'Bergen', year: 2025, tone: 'cool' },
{ id: 8, title: 'Lavender Field', artist: 'Camille Roy', place: 'Valensole', year: 2023, tone: 'dusk' },
{ id: 9, title: 'Golden Ridge', artist: 'Aiko Tanaka', place: 'Hokkaido', year: 2025, tone: 'warm' },
{ id: 10, title: 'Salt Flats', artist: 'Diego Alvarez', place: 'Uyuni', year: 2024, tone: 'mono' },
{ id: 11, title: 'Red Canyon', artist: 'Hana Kobayashi', place: 'Arizona', year: 2025, tone: 'warm' },
];
let seedState = 1;
const rand = () => {
seedState = (seedState * 1664525 + 1013904223) >>> 0;
return seedState / 4294967296;
};
const cache = new Map<string, string>();
/** A deterministic artwork as a data URL. `kind` picks a landscape or an abstract mesh. */
export function artwork(id: number, w = 960, h = 640, kind: 'landscape' | 'mesh' = id % 3 === 1 ? 'mesh' : 'landscape'): string {
const key = `${id}-${w}-${h}-${kind}`;
const hit = cache.get(key);
if (hit) return hit;
if (typeof document === 'undefined') return '';
const c = document.createElement('canvas');
c.width = w;
c.height = h;
const g = c.getContext('2d');
if (!g) return '';
seedState = (id + 1) * 9973;
const [deep, mid, hot, light] = PALETTES[id % PALETTES.length];
const sky = g.createLinearGradient(0, 0, 0, h);
sky.addColorStop(0, deep);
sky.addColorStop(0.55, mid);
sky.addColorStop(1, kind === 'mesh' ? deep : hot);
g.fillStyle = sky;
g.fillRect(0, 0, w, h);
// soft light blobs
const blobs = kind === 'mesh' ? 6 : 3;
for (let i = 0; i < blobs; i++) {
const x = rand() * w;
const y = rand() * h * (kind === 'mesh' ? 1 : 0.6);
const r = (0.25 + rand() * 0.45) * Math.max(w, h);
const rg = g.createRadialGradient(x, y, 0, x, y, r);
rg.addColorStop(0, [hot, light, mid][i % 3] + 'cc');
rg.addColorStop(1, 'transparent');
g.globalCompositeOperation = 'screen';
g.fillStyle = rg;
g.fillRect(0, 0, w, h);
}
g.globalCompositeOperation = 'source-over';
if (kind === 'landscape') {
// sun
const sx = (0.25 + rand() * 0.5) * w;
const sy = h * (0.38 + rand() * 0.12);
const sr = Math.min(w, h) * (0.07 + rand() * 0.05);
const glow = g.createRadialGradient(sx, sy, 0, sx, sy, sr * 5);
glow.addColorStop(0, light + 'aa');
glow.addColorStop(1, 'transparent');
g.fillStyle = glow;
g.fillRect(0, 0, w, h);
g.fillStyle = light;
g.beginPath();
g.arc(sx, sy, sr, 0, Math.PI * 2);
g.fill();
// ridges, back to front
for (let layer = 0; layer < 4; layer++) {
const base = h * (0.5 + layer * 0.12);
const amp = h * (0.12 - layer * 0.02);
const f1 = 1.5 + rand() * 2;
const f2 = 4 + rand() * 4;
const ph = rand() * 10;
g.beginPath();
g.moveTo(0, h);
for (let x = 0; x <= w; x += 4) {
const u = x / w;
const y = base - amp * (0.6 * Math.sin(u * f1 * Math.PI + ph) + 0.3 * Math.sin(u * f2 * Math.PI + ph * 2) + 0.1 * Math.sin(u * 23 + ph));
g.lineTo(x, y);
}
g.lineTo(w, h);
g.closePath();
const t = layer / 3;
const lg = g.createLinearGradient(0, base - amp, 0, h);
lg.addColorStop(0, mix(mid, deep, 0.25 + t * 0.6));
lg.addColorStop(1, mix(deep, '#000000', t * 0.5));
g.fillStyle = lg;
g.globalAlpha = 0.92;
g.fill();
g.globalAlpha = 1;
}
} else {
// flowing ribbons
for (let i = 0; i < 3; i++) {
g.beginPath();
const y0 = h * (0.2 + rand() * 0.6);
g.moveTo(-50, y0);
g.bezierCurveTo(w * 0.3, y0 - h * (rand() - 0.5), w * 0.7, y0 + h * (rand() - 0.5), w + 50, y0 + h * (rand() - 0.5) * 0.6);
g.lineWidth = Math.min(w, h) * (0.08 + rand() * 0.12);
g.strokeStyle = [light, hot, mid][i] + '55';
g.filter = `blur(${Math.round(Math.min(w, h) * 0.04)}px)`;
g.stroke();
g.filter = 'none';
}
}
// vignette
const vg = g.createRadialGradient(w / 2, h / 2, Math.min(w, h) * 0.3, w / 2, h / 2, Math.max(w, h) * 0.75);
vg.addColorStop(0, 'transparent');
vg.addColorStop(1, 'rgba(0,0,0,0.45)');
g.fillStyle = vg;
g.fillRect(0, 0, w, h);
// film grain
const img = g.getImageData(0, 0, w, h);
const d = img.data;
for (let i = 0; i < d.length; i += 4) {
const n = (rand() - 0.5) * 18;
d[i] += n;
d[i + 1] += n;
d[i + 2] += n;
}
g.putImageData(img, 0, 0);
const url = c.toDataURL('image/jpeg', 0.86);
cache.set(key, url);
return url;
}
function mix(a: string, b: string, t: number) {
const pa = parseInt(a.slice(1), 16);
const pb = parseInt(b.slice(1), 16);
const ch = (s: number) => Math.round(((pa >> s) & 255) * (1 - t) + ((pb >> s) & 255) * t);
return `rgb(${ch(16)},${ch(8)},${ch(0)})`;
}components/niceui/commerce/Print.tsx
import { cn } from '@/lib/cn';
import { img } from './data';
/** A framed print on a soft studio wall — the product shot used across the shop demos. */
export function Print({ art, frame = '#1c1c1f', className, zoom = 1 }: { art: number; frame?: string; className?: string; zoom?: number }) {
const light = frame === '#f1efe9';
return (
<div className={cn('relative grid place-items-center overflow-hidden bg-gradient-to-b from-[#1a1b1f] to-[#101114]', className)}>
<div className="absolute inset-x-0 bottom-0 h-1/3 bg-gradient-to-t from-black/40 to-transparent" />
<div
className="relative w-[62%] p-[3.2%] shadow-[0_24px_40px_-16px_rgba(0,0,0,0.8)] transition-transform duration-500 ease-smooth"
style={{ background: frame, transform: `scale(${zoom})` }}
>
<div className={cn('p-[7%]', light ? 'bg-white' : 'bg-[#f6f4ef]')}>
<img src={img(art)} alt="" draggable={false} className="block aspect-[4/5] w-full object-cover" />
</div>
</div>
</div>
);
}