# Masonry List

> A masonry grid fitting product cards of varying heights into tight columns. Works well for mixed imagery in lookbooks and curated collections.

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-product-list-masonry-list).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/ecommerce-product-list-masonry-list
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/ecommerce-product-list-masonry-list-light-7aa0fedb3dab7c8f.png
- Registry item: https://www.shadcn-ui-blocks.com/r/ecommerce-product-list-masonry-list.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-product-list-masonry-list.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/product-list/masonry-list.tsx`

```tsx
import { Button } from '@/components/ui/button';
import { Heart, Star, Sparkles } from 'lucide-react';

interface ProductItem {
  aspect: string;
  badge: string | null;
  size: 'sm' | 'md' | 'lg';
}

interface CardStyles {
  title: string;
  description: string;
  price: string;
}

export default function MasonryList() {
  // More varied aspect ratios and dynamic content
  const items: ProductItem[] = [
    { aspect: 'aspect-[2/3]', badge: 'New', size: 'lg' },
    { aspect: 'aspect-square', badge: 'Sale', size: 'sm' },
    { aspect: 'aspect-[3/4]', badge: null, size: 'md' },
    { aspect: 'aspect-[4/5]', badge: 'Trending', size: 'lg' },
    { aspect: 'aspect-[3/4]', badge: null, size: 'sm' },
    { aspect: 'aspect-[1/1]', badge: 'Limited', size: 'md' },
    { aspect: 'aspect-[4/3]', badge: null, size: 'lg' },
    { aspect: 'aspect-[3/4]', badge: 'Sale', size: 'sm' },
    { aspect: 'aspect-[2/3]', badge: null, size: 'md' },
    { aspect: 'aspect-[1/1]', badge: 'New', size: 'lg' },
    { aspect: 'aspect-[3/4]', badge: null, size: 'sm' },
    { aspect: 'aspect-[4/5]', badge: 'Trending', size: 'md' },
  ];

  const getBadgeStyles = (badge: string | null): string => {
    switch (badge) {
      case 'New':
        return 'bg-primary text-primary-foreground';
      case 'Sale':
        return 'bg-destructive text-destructive-foreground';
      case 'Trending':
        return 'bg-secondary text-secondary-foreground';
      case 'Limited':
        return 'bg-accent text-accent-foreground';
      default:
        return '';
    }
  };

  const getCardStyles = (size: 'sm' | 'md' | 'lg'): CardStyles => {
    switch (size) {
      case 'lg':
        return {
          title: 'text-lg font-semibold',
          description: 'block',
          price: 'text-xl',
        };
      case 'md':
        return {
          title: 'font-medium',
          description: 'hidden sm:block',
          price: 'text-lg',
        };
      case 'sm':
        return {
          title: 'text-sm font-medium',
          description: 'hidden',
          price: 'text-base',
        };
    }
  };

  return (
    <div className="mx-auto w-full max-w-7xl p-6">
      <div className="columns-1 gap-6 space-y-6 [column-fill:_balance] sm:columns-2 lg:columns-3 xl:columns-4">
        {items.map((item, i) => (
          <div key={i} className="break-inside-avoid">
            <div className="group bg-card overflow-hidden rounded-xl border shadow-sm transition-shadow duration-300 hover:shadow-lg">
              <div className={`relative ${item.aspect} bg-muted`}>
                <img
                  src="https://images.unsplash.com/photo-1523275335684-37898b6baf30"
                  alt="Product image"
                  className="object-cover transition-transform group-hover:scale-105"
                  sizes="(max-width: 768px) 100vw, (max-width: 1200px) 33vw, 25vw"
                />
                <Button
                  size="icon"
                  variant="ghost"
                  className="bg-background/80 absolute top-2 right-2 h-8 w-8 rounded-full opacity-0 backdrop-blur-sm transition-opacity group-hover:opacity-100"
                >
                  <Heart className="h-4 w-4" />
                </Button>
                {item.badge && (
                  <div
                    className={`absolute top-2 left-2 px-2 py-1 ${getBadgeStyles(
                      item.badge
                    )} flex items-center gap-1 rounded-md text-sm font-medium`}
                  >
                    {item.badge === 'Trending' && (
                      <Sparkles className="h-3.5 w-3.5" />
                    )}
                    {item.badge}
                  </div>
                )}
              </div>
              <div className="p-4">
                <div className="space-y-2">
                  <div className="min-w-0">
                    <h3 className={getCardStyles(item.size).title}>
                      Classic Leather Watch
                    </h3>
                    <p
                      className={`text-muted-foreground mt-1 text-sm ${
                        getCardStyles(item.size).description
                      }`}
                    >
                      Premium crafted timepiece with genuine leather strap
                    </p>
                    <div className="mt-2 flex items-center gap-1">
                      <Star className="fill-primary text-primary h-3.5 w-3.5" />
                      <span className="text-sm">4.9</span>
                      <span className="text-muted-foreground text-sm">
                        (128)
                      </span>
                    </div>
                  </div>
                  <div className="flex items-baseline gap-2">
                    <div
                      className={`font-medium ${
                        getCardStyles(item.size).price
                      }`}
                    >
                      $299
                    </div>
                    <div className="text-muted-foreground text-sm line-through">
                      $399
                    </div>
                  </div>
                </div>
                <div className="mt-4">
                  <Button size="sm" className="w-full">
                    Add to Cart
                  </Button>
                </div>
              </div>
            </div>
          </div>
        ))}
      </div>
    </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 }
```