# Expandable Preview

> A category preview where each tile expands to reveal more products on click, keeping the storefront tidy while shoppers dig into one collection at a time.

A shadcn/ui block from the [@shadcn-ui-blocks](https://www.shadcn-ui-blocks.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/shadcn-ui-blocks/ecommerce-category-preview-expandable-preview).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/ecommerce-category-preview-expandable-preview
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/ecommerce-category-preview-expandable-preview-light-4072dede890b5460.png
- Registry item: https://www.shadcn-ui-blocks.com/r/ecommerce-category-preview-expandable-preview.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://www.shadcn-ui-blocks.com/r/ecommerce-category-preview-expandable-preview.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `class-variance-authority`, `lucide-react`, `radix-ui`

## Files

### `components/blocks/ecommerce/category-preview/expandable-preview.tsx`

```tsx
import { Button } from '@/components/ui/button';
import { Badge } from '@/components/ui/badge';
import {
  Card,
  CardContent,
  CardDescription,
  CardHeader,
  CardTitle,
} from '@/components/ui/card';
import { Collapsible, CollapsibleContent } from '@/components/ui/collapsible';
import {
  ChevronDown,
  ChevronUp,
  Star,
  Package,
  Clock,
  Shield,
} from 'lucide-react';
import { useState } from 'react';

interface Feature {
  icon: typeof Star;
  title: string;
  description: string;
}

interface Category {
  name: string;
  description: string;
  image: string;
  productCount: number;
  rating: number;
  reviewCount: number;
  priceRange: string;
  features: Feature[];
  specifications: Record<string, string>;
  shipping: {
    delivery: string;
    returns: string;
    warranty: string;
  };
}

export default function ExpandablePreview() {
  const [expandedCategory, setExpandedCategory] = useState<string | null>(null);

  const categories: Category[] = [
    {
      name: 'Luxury Collection',
      description:
        'Experience the pinnacle of watchmaking with our luxury collection.',
      image: 'https://images.unsplash.com/photo-1523275335684-37898b6baf30',
      productCount: 156,
      rating: 4.9,
      reviewCount: 1250,
      priceRange: '$5,000 - $50,000+',
      features: [
        {
          icon: Star,
          title: 'Premium Materials',
          description:
            'Only the finest materials are used in our luxury timepieces',
        },
        {
          icon: Shield,
          title: 'Authenticity Guaranteed',
          description: 'Each watch comes with a certificate of authenticity',
        },
        {
          icon: Clock,
          title: 'Swiss Movement',
          description: 'Precision engineered Swiss movements in every watch',
        },
      ],
      specifications: {
        'Case Material': '18k Gold, Platinum, or Titanium',
        'Movement Type': 'Automatic or Manual',
        'Water Resistance': 'Up to 100m',
        Crystal: 'Sapphire with anti-reflective coating',
        'Strap Options': 'Leather, Metal, or Rubber',
      },
      shipping: {
        delivery: 'Free worldwide shipping with insurance',
        returns: '30-day returns with full refund',
        warranty: '5-year international warranty',
      },
    },
    {
      name: 'Sport Collection',
      description: 'Professional-grade timepieces for the active lifestyle.',
      image: 'https://images.unsplash.com/photo-1523275335684-37898b6baf30',
      productCount: 89,
      rating: 4.7,
      reviewCount: 890,
      priceRange: '$1,000 - $5,000',
      features: [
        {
          icon: Shield,
          title: 'Durability',
          description: 'Built to withstand extreme conditions',
        },
        {
          icon: Clock,
          title: 'Precision Timing',
          description: 'Accurate chronograph functions',
        },
        {
          icon: Package,
          title: 'Lightweight Design',
          description: 'Comfortable for all-day wear',
        },
      ],
      specifications: {
        'Case Material': 'Stainless Steel or Titanium',
        'Movement Type': 'Automatic or Quartz',
        'Water Resistance': 'Up to 300m',
        Crystal: 'Sapphire with anti-reflective coating',
        'Strap Options': 'Rubber or Metal',
      },
      shipping: {
        delivery: 'Free standard shipping',
        returns: '60-day returns',
        warranty: '2-year warranty',
      },
    },
  ];

  return (
    <div className="mx-auto w-full max-w-3xl space-y-6 p-6">
      {categories.map((category) => (
        <Card key={category.name} className="gap-0 overflow-hidden p-0">
          <CardHeader className="bg-muted/50 grid-rows-none border-b pt-6">
            <div className="flex items-center justify-between">
              <div>
                <CardTitle>{category.name}</CardTitle>
                <CardDescription className="mt-1.5">
                  {category.description}
                </CardDescription>
              </div>
              <Button
                variant="ghost"
                size="sm"
                onClick={() =>
                  setExpandedCategory(
                    expandedCategory === category.name ? null : category.name
                  )
                }
              >
                {expandedCategory === category.name ? (
                  <ChevronUp className="h-4 w-4" />
                ) : (
                  <ChevronDown className="h-4 w-4" />
                )}
              </Button>
            </div>
          </CardHeader>

          <CardContent className="p-0">
            {/* Preview Content */}
            <div className="relative aspect-[21/9]">
              <img
                src={category.image}
                alt={category.name}
                className="object-cover"
                sizes="(max-width: 768px) 100vw, 768px"
              />
              <div className="from-background/90 via-background/50 absolute inset-0 bg-gradient-to-t to-transparent" />
              <div className="absolute right-4 bottom-4 left-4 flex items-center justify-between">
                <div className="flex items-center gap-4">
                  <div className="flex items-center">
                    <Star className="fill-primary text-primary h-5 w-5" />
                    <span className="ml-1 font-medium">{category.rating}</span>
                    <span className="text-accent-foreground/80 ml-1 text-sm">
                      ({category.reviewCount})
                    </span>
                  </div>
                  <Badge
                    variant="outline"
                    className="bg-background/50 backdrop-blur-sm"
                  >
                    {category.productCount} products
                  </Badge>
                </div>
                <Badge
                  variant="secondary"
                  className="bg-primary/10 text-primary"
                >
                  {category.priceRange}
                </Badge>
              </div>
            </div>

            {/* Expandable Content */}
            <Collapsible
              open={expandedCategory === category.name}
              className="transition-all duration-300"
            >
              <CollapsibleContent className="space-y-6 p-6">
                {/* Features */}
                <div>
                  <h3 className="mb-4 font-semibold">Key Features</h3>
                  <div className="grid gap-4 sm:grid-cols-3">
                    {category.features.map((feature) => {
                      const Icon = feature.icon;
                      return (
                        <div
                          key={feature.title}
                          className="bg-muted/50 flex flex-col items-center rounded-lg p-4 text-center"
                        >
                          <div className="bg-primary/10 mb-3 flex h-10 w-10 items-center justify-center rounded-full">
                            <Icon className="text-primary h-5 w-5" />
                          </div>
                          <h4 className="mb-1 font-medium">{feature.title}</h4>
                          <p className="text-accent-foreground/80 text-sm">
                            {feature.description}
                          </p>
                        </div>
                      );
                    })}
                  </div>
                </div>

                {/* Specifications */}
                <div>
                  <h3 className="mb-4 font-semibold">Specifications</h3>
                  <div className="grid gap-4 sm:grid-cols-2">
                    {Object.entries(category.specifications).map(
                      ([key, value]) => (
                        <div
                          key={key}
                          className="bg-muted/50 flex justify-between rounded-lg p-3"
                        >
                          <span className="text-sm font-medium">{key}</span>
                          <span className="text-accent-foreground/80 text-sm">
                            {value}
                          </span>
                        </div>
                      )
                    )}
                  </div>
                </div>

                {/* Shipping & Returns */}
                <div>
                  <h3 className="mb-4 font-semibold">Shipping & Returns</h3>
                  <div className="grid gap-4 sm:grid-cols-3">
                    <div className="bg-muted/50 rounded-lg p-4">
                      <Package className="text-primary mb-2 h-5 w-5" />
                      <div className="mb-1 font-medium">Delivery</div>
                      <p className="text-accent-foreground/80 text-sm">
                        {category.shipping.delivery}
                      </p>
                    </div>
                    <div className="bg-muted/50 rounded-lg p-4">
                      <Clock className="text-primary mb-2 h-5 w-5" />
                      <div className="mb-1 font-medium">Returns</div>
                      <p className="text-accent-foreground/80 text-sm">
                        {category.shipping.returns}
                      </p>
                    </div>
                    <div className="bg-muted/50 rounded-lg p-4">
                      <Shield className="text-primary mb-2 h-5 w-5" />
                      <div className="mb-1 font-medium">Warranty</div>
                      <p className="text-accent-foreground/80 text-sm">
                        {category.shipping.warranty}
                      </p>
                    </div>
                  </div>
                </div>

                <Button className="w-full">View All Products</Button>
              </CollapsibleContent>
            </Collapsible>
          </CardContent>
        </Card>
      ))}
    </div>
  );
}
```

### `components/ui/button.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const buttonVariants = cva(
  "group/button inline-flex shrink-0 items-center justify-center rounded-md border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground hover:bg-primary/80",
        outline:
          "border-border bg-background shadow-xs hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
        secondary:
          "bg-secondary text-secondary-foreground hover:bg-secondary/80 aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
        ghost:
          "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
        destructive:
          "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
        link: "text-primary underline-offset-4 hover:underline",
      },
      size: {
        default:
          "h-9 gap-1.5 px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        xs: "h-6 gap-1 rounded-[min(var(--radius-md),8px)] px-2 text-xs in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
        sm: "h-8 gap-1 rounded-[min(var(--radius-md),10px)] px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5",
        lg: "h-10 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        icon: "size-9",
        "icon-xs":
          "size-6 rounded-[min(var(--radius-md),8px)] in-data-[slot=button-group]:rounded-md [&_svg:not([class*='size-'])]:size-3",
        "icon-sm":
          "size-8 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-md",
        "icon-lg": "size-10",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Button({
  className,
  variant = "default",
  size = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"button"> &
  VariantProps<typeof buttonVariants> & {
    asChild?: boolean
  }) {
  const Comp = asChild ? Slot.Root : "button"

  return (
    <Comp
      data-slot="button"
      data-variant={variant}
      data-size={size}
      className={cn(buttonVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Button, buttonVariants }
```

### `components/ui/badge.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const badgeVariants = cva(
  "group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
        secondary:
          "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
        destructive:
          "bg-destructive/10 text-destructive focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20",
        outline:
          "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
        ghost:
          "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
        link: "text-primary underline-offset-4 hover:underline",
      },
    },
    defaultVariants: {
      variant: "default",
    },
  }
)

function Badge({
  className,
  variant = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"span"> &
  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
  const Comp = asChild ? Slot.Root : "span"

  return (
    <Comp
      data-slot="badge"
      data-variant={variant}
      className={cn(badgeVariants({ variant }), className)}
      {...props}
    />
  )
}

export { Badge, badgeVariants }
```

### `components/ui/card.tsx`

```tsx
import * as React from "react"

import { cn } from "@/lib/utils"

function Card({
  className,
  size = "default",
  ...props
}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
  return (
    <div
      data-slot="card"
      data-size={size}
      className={cn(
        "group/card flex flex-col gap-6 overflow-hidden rounded-xl bg-card py-6 text-sm text-card-foreground shadow-xs ring-1 ring-foreground/10 has-[>img:first-child]:pt-0 data-[size=sm]:gap-4 data-[size=sm]:py-4 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
        className
      )}
      {...props}
    />
  )
}

function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-header"
      className={cn(
        "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-6 group-data-[size=sm]/card:px-4 has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-6 group-data-[size=sm]/card:[.border-b]:pb-4",
        className
      )}
      {...props}
    />
  )
}

function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-title"
      className={cn(
        "font-heading text-base leading-normal font-medium group-data-[size=sm]/card:text-sm",
        className
      )}
      {...props}
    />
  )
}

function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-description"
      className={cn("text-sm text-muted-foreground", className)}
      {...props}
    />
  )
}

function CardAction({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-action"
      className={cn(
        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
        className
      )}
      {...props}
    />
  )
}

function CardContent({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-content"
      className={cn("px-6 group-data-[size=sm]/card:px-4", className)}
      {...props}
    />
  )
}

function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="card-footer"
      className={cn(
        "flex items-center rounded-b-xl px-6 group-data-[size=sm]/card:px-4 [.border-t]:pt-6 group-data-[size=sm]/card:[.border-t]:pt-4",
        className
      )}
      {...props}
    />
  )
}

export {
  Card,
  CardHeader,
  CardFooter,
  CardTitle,
  CardAction,
  CardDescription,
  CardContent,
}
```

### `components/ui/collapsible.tsx`

```tsx
"use client"

import { Collapsible as CollapsiblePrimitive } from "radix-ui"

function Collapsible({
  ...props
}: React.ComponentProps<typeof CollapsiblePrimitive.Root>) {
  return <CollapsiblePrimitive.Root data-slot="collapsible" {...props} />
}

function CollapsibleTrigger({
  ...props
}: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleTrigger>) {
  return (
    <CollapsiblePrimitive.CollapsibleTrigger
      data-slot="collapsible-trigger"
      {...props}
    />
  )
}

function CollapsibleContent({
  ...props
}: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleContent>) {
  return (
    <CollapsiblePrimitive.CollapsibleContent
      data-slot="collapsible-content"
      {...props}
    />
  )
}

export { Collapsible, CollapsibleTrigger, CollapsibleContent }
```