# Portfolio Gallery

> A portfolio layout that pairs project images with titles and short notes. Use it to present work, case studies, or a creative showcase to clients.

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/marketing-gallery-portfolio-gallery).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/marketing-gallery-portfolio-gallery
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/marketing-gallery-portfolio-gallery-light-907650044d0b417c.png
- Registry item: https://www.shadcn-ui-blocks.com/r/marketing-gallery-portfolio-gallery.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://www.shadcn-ui-blocks.com/r/marketing-gallery-portfolio-gallery.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/marketing/gallery/portfolio-gallery.tsx`

```tsx
import * as React from 'react';
import { Button } from '@/components/ui/button';
import { Eye, Tag } from 'lucide-react';

interface PortfolioImage {
  src: string;
  alt: string;
  width: number;
  height: number;
  category: string;
  size: 'small' | 'medium' | 'large';
}

export default function PortfolioGallery() {
  const [filter, setFilter] = React.useState<string | null>(null);

  // Images with their categories and size variations for portfolio layout
  const images = React.useMemo<PortfolioImage[]>(
    () => [
      {
        src: 'https://images.unsplash.com/photo-1627483297886-49710ae1fc22?q=80&w=1470&auto=format&fit=crop',
        alt: 'Minimalist white kitchen with marble countertops',
        width: 1470,
        height: 980,
        category: 'Interior',
        size: 'large',
      },
      {
        src: 'https://images.unsplash.com/photo-1600585152220-90363fe7e115?q=80&w=1470&auto=format&fit=crop',
        alt: 'Modern living room with accent furniture',
        width: 1470,
        height: 980,
        category: 'Interior',
        size: 'medium',
      },
      {
        src: 'https://images.unsplash.com/photo-1600596542815-ffad4c1539a9?q=80&w=1475&auto=format&fit=crop',
        alt: 'Contemporary house exterior with landscaping',
        width: 1475,
        height: 983,
        category: 'Exterior',
        size: 'medium',
      },
      {
        src: 'https://images.unsplash.com/photo-1600585152915-d208bec867a1?q=80&w=1470&auto=format&fit=crop',
        alt: 'Modern dining room with pendant lighting',
        width: 1470,
        height: 980,
        category: 'Interior',
        size: 'small',
      },
      {
        src: 'https://images.unsplash.com/photo-1600607688969-a5bfcd646154?q=80&w=1470&auto=format&fit=crop',
        alt: 'Minimalist bathroom with freestanding tub',
        width: 1470,
        height: 980,
        category: 'Interior',
        size: 'small',
      },
      {
        src: 'https://images.unsplash.com/photo-1600566753086-00f18fb6b3ea?q=80&w=1470&auto=format&fit=crop',
        alt: 'Luxury high-rise apartment building exterior',
        width: 1470,
        height: 980,
        category: 'Exterior',
        size: 'large',
      },
      {
        src: 'https://images.unsplash.com/photo-1600121848594-d8644e57abab?q=80&w=1470&auto=format&fit=crop',
        alt: 'Open concept kitchen and living area',
        width: 1470,
        height: 980,
        category: 'Interior',
        size: 'medium',
      },
      {
        src: 'https://images.unsplash.com/photo-1613977257592-4871e5fcd7c4?q=80&w=1374&auto=format&fit=crop',
        alt: 'Modern residential architecture with large windows',
        width: 1374,
        height: 916,
        category: 'Exterior',
        size: 'medium',
      },
      {
        src: 'https://images.unsplash.com/photo-1616486338812-3dadae4b4ace?q=80&w=1632&auto=format&fit=crop',
        alt: 'Elegant home office with wooden desk and natural lighting',
        width: 1632,
        height: 1088,
        category: 'Interior',
        size: 'small',
      },
      {
        src: 'https://images.unsplash.com/photo-1600210492486-724fe5c67fb0?q=80&w=1474&auto=format&fit=crop',
        alt: 'Contemporary garden and landscape design',
        width: 1474,
        height: 983,
        category: 'Landscape',
        size: 'medium',
      },
    ],
    []
  );

  // Extract all unique categories
  const categories = React.useMemo(() => {
    const categorySet = new Set<string>();
    images.forEach((image) => categorySet.add(image.category));
    return Array.from(categorySet);
  }, [images]);

  // Filter images based on selected category
  const filteredImages = React.useMemo(() => {
    if (!filter) return images;
    return images.filter((image) => image.category === filter);
  }, [images, filter]);

  return (
    <div className="w-full p-4 md:p-6">
      {/* Category filter */}
      <div className="mb-8 flex flex-col items-center">
        <h2 className="mb-6 text-center text-2xl font-bold">
          Design Portfolio
        </h2>
        <div className="flex flex-wrap justify-center gap-2">
          <Button
            variant={filter === null ? 'default' : 'outline'}
            size="sm"
            onClick={() => setFilter(null)}
            className="gap-1.5 rounded-full"
          >
            <Tag className="h-3.5 w-3.5" />
            <span>All Projects</span>
          </Button>
          {categories.map((category) => (
            <Button
              key={category}
              variant={filter === category ? 'default' : 'outline'}
              size="sm"
              onClick={() => setFilter(category)}
              className="gap-1.5 rounded-full"
            >
              <Tag className="h-3.5 w-3.5" />
              <span>{category}</span>
            </Button>
          ))}
        </div>
      </div>

      {/* Portfolio grid with varying image sizes */}
      <div className="grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3">
        {filteredImages.map((image, index) => {
          // Set different spans for different sized images
          const spanClasses = {
            small: '',
            medium: 'sm:col-span-1 md:col-span-1',
            large: 'sm:col-span-2 md:col-span-2',
          };

          return (
            <div
              key={index}
              className={`group relative overflow-hidden rounded-lg ${spanClasses[image.size]}`}
            >
              <div className="relative aspect-square sm:aspect-auto sm:h-64 md:h-80">
                <img
                  src={image.src}
                  alt={image.alt}
                  sizes="(max-width: 640px) 100vw, (max-width: 1024px) 50vw, 33vw"
                  className="object-cover transition-transform duration-500 group-hover:scale-105"
                />

                {/* Overlay with details */}
                <div className="absolute inset-0 flex flex-col items-center justify-center bg-black/60 p-4 opacity-0 backdrop-blur-sm transition-opacity duration-300 group-hover:opacity-100">
                  <h3 className="mb-2 text-center text-xl font-bold text-white">
                    {image.alt}
                  </h3>

                  <span className="mb-4 rounded-full bg-white/20 px-3 py-1 text-xs text-white">
                    {image.category}
                  </span>

                  <Button
                    size="sm"
                    variant="secondary"
                    className="mt-2 gap-1.5"
                  >
                    <Eye className="h-4 w-4" />
                    <span>View Project</span>
                  </Button>
                </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 }
```