# Gallery 6

> Captioned photographs in a looping carousel (from Marbrook)

A shadcn/ui block from the [@cnippet-blocks](https://blocks.cnippet.dev/?utm_source=shadcn.exchange) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/cnippet-blocks/gallery-6).

- Page, with a live preview: https://shadcn.exchange/r/cnippet-blocks/gallery-6
- Screenshot: https://shadcn.exchange/shot/cnippet-blocks/gallery-6/light.png
- Registry item: https://blocks.cnippet.dev/r/gallery-6.json
- Categories: gallery
- Listed: 2026-11-01, source last changed 2026-11-01

## Install

```bash
npx shadcn@latest add https://shadcn.exchange/r/cnippet-blocks/gallery-6.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: `lucide-react`
- Registry items: `@cnippet/carousel`, `@cnippet/utils`

## Files

### `registry/default/sections/gallery-6/index.tsx`

```tsx
"use client";

import { ArrowUpRight } from "lucide-react";
import Image from "next/image";
import Link from "next/link";

import {
  Carousel,
  CarouselContent,
  CarouselItem,
  CarouselNext,
  CarouselPrevious,
} from "@/components/ui/carousel";
import { cn } from "@/lib/utils";

import type { Surface } from "../_types/common";
import type { GalleryCarouselContent } from "../_types/gallery";
import { defaultGallery6Content } from "./data";
import { SectionHeader, surfaceClass, toneFor } from "./section-header";

const arrowClasses =
  "static size-12 translate-x-0 translate-y-0 border-input bg-background text-primary shadow-none before:shadow-none hover:bg-muted";

/** Captioned photographs in a looping carousel, arrows beside the header. */
export default function Gallery6({
  content = defaultGallery6Content,
  surface = "default",
}: {
  content?: GalleryCarouselContent;
  surface?: Surface;
}) {
  return (
    <section className={cn("py-20 sm:py-28", surfaceClass[surface])}>
      <Carousel
        className="mx-auto flex max-w-7xl flex-col gap-10 px-5 sm:px-8 lg:px-12"
        opts={{ align: "start", loop: true }}
      >
        <SectionHeader
          action={
            <div className="flex items-center gap-2">
              <CarouselPrevious className={arrowClasses} variant="outline" />
              <CarouselNext className={arrowClasses} variant="outline" />
            </div>
          }
          description={content.description}
          eyebrow={content.eyebrow}
          title={content.title}
          tone={toneFor(surface)}
        />

        <CarouselContent className="-ml-4">
          {content.items.map((item) => (
            <CarouselItem
              className="basis-[88%] pl-4 sm:basis-1/2 lg:basis-[38%]"
              key={item.title}
            >
              <figure className="group">
                <div className="relative aspect-3/2 overflow-hidden rounded-lg">
                  <Image
                    alt={item.image.alt}
                    className="object-cover transition-transform duration-700 ease-out group-hover:scale-105"
                    fill
                    sizes="(min-width: 1024px) 38vw, (min-width: 640px) 50vw, 88vw"
                    src={item.image.src}
                  />
                </div>
                <figcaption className="mt-4 flex items-start justify-between gap-4">
                  <div>
                    <p className="font-display text-primary text-xl">
                      {item.title}
                    </p>
                    <p className="mt-0.5 text-muted-foreground text-sm">
                      {item.description}
                    </p>
                  </div>
                  {item.href && (
                    <Link
                      aria-label={`View ${item.title}`}
                      className="mt-1 shrink-0 text-muted-foreground/70 transition-colors hover:text-primary"
                      href={item.href}
                    >
                      <ArrowUpRight className="size-5" />
                    </Link>
                  )}
                </figcaption>
              </figure>
            </CarouselItem>
          ))}
        </CarouselContent>
      </Carousel>
    </section>
  );
}
```

### `registry/default/sections/gallery-6/data.ts`

```ts
import type { GalleryCarouselContent } from "../_types/gallery";

export const defaultGallery6Content: GalleryCarouselContent = {
  description: "Photographed in natural light, on site, by our own team.",
  eyebrow: "Inside the portfolio",
  items: [
    {
      description: "Open-plan living, harbour aspect",
      href: "/properties/blackwood-house",
      image: {
        alt: "Blackwood House",
        src: "https://res.cloudinary.com/qgiongel/image/upload/q_auto/f_auto/v1786954292/templates/estate/marbrook/cndn_marbrook016.jpg",
      },
      title: "Blackwood House",
    },
    {
      description: "Marble island, skylit kitchen",
      href: "/properties/alder-row-cottage",
      image: {
        alt: "Alder Row Cottage",
        src: "https://res.cloudinary.com/qgiongel/image/upload/q_auto/f_auto/v1786954292/templates/estate/marbrook/cndn_marbrook017.jpg",
      },
      title: "Alder Row Cottage",
    },
    {
      description: "Formal dining, courtyard beyond",
      href: "/properties/the-coastline-villa",
      image: {
        alt: "Vantage Lane",
        src: "https://res.cloudinary.com/qgiongel/image/upload/q_auto/f_auto/v1786954292/templates/estate/marbrook/cndn_marbrook018.jpg",
      },
      title: "Vantage Lane",
    },
    {
      description: "Family room, west light",
      href: "/properties/cedar-park-lodge",
      image: {
        alt: "Cedar Park Lodge",
        src: "https://res.cloudinary.com/qgiongel/image/upload/q_auto/f_auto/v1786954292/templates/estate/marbrook/cndn_marbrook019.jpg",
      },
      title: "Cedar Park Lodge",
    },
    {
      description: "Garden flat, original joinery",
      href: "/properties/lantern-yard-garden-flat",
      image: {
        alt: "Old Town Apartment",
        src: "https://res.cloudinary.com/qgiongel/image/upload/q_auto/f_auto/v1786954292/templates/estate/marbrook/cndn_marbrook020.jpg",
      },
      title: "Old Town Apartment",
    },
    {
      description: "Reception room, pool view",
      href: "/properties/riverside-colonial",
      image: {
        alt: "Riverside Colonial",
        src: "https://res.cloudinary.com/qgiongel/image/upload/q_auto/f_auto/v1786954292/templates/estate/marbrook/cndn_marbrook014.jpg",
      },
      title: "Riverside Colonial",
    },
  ],
  title: "Rooms worth the journey",
};
```

### `registry/default/sections/gallery-6/section-header.tsx`

```tsx
import type React from "react";

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

import type { Surface } from "../_types/common";

/** The small uppercase label that opens most headers. */
export const eyebrowClass =
  "inline-flex items-center gap-2 font-medium text-[0.6875rem] uppercase tracking-[0.22em]";

export const surfaceClass: Record<Surface, string> = {
  default: "bg-background text-foreground",
  muted: "bg-muted text-foreground",
  primary: "bg-primary text-primary-foreground",
  secondary: "bg-secondary text-secondary-foreground",
};

/**
 * Which band the header sits on. `photo` keeps literal white, because
 * `--primary-foreground` inverts in dark mode and would be unreadable over a
 * photograph.
 */
export type SectionTone = "light" | "photo" | "primary" | "secondary";

export function toneFor(surface: Surface): SectionTone {
  if (surface === "primary") return "primary";
  if (surface === "secondary") return "secondary";
  return "light";
}

const toneClasses: Record<
  SectionTone,
  { eyebrow: string; heading: string; lede: string; tick: string }
> = {
  light: {
    eyebrow: "text-muted-foreground/70",
    heading: "text-primary",
    lede: "text-muted-foreground",
    tick: "bg-secondary",
  },
  photo: {
    eyebrow: "text-white/50",
    heading: "text-white",
    lede: "text-white/65",
    tick: "bg-secondary",
  },
  primary: {
    eyebrow: "text-primary-foreground/40",
    heading: "text-primary-foreground",
    lede: "text-primary-foreground/60",
    tick: "bg-secondary",
  },
  secondary: {
    eyebrow: "text-secondary-foreground/50",
    heading: "text-secondary-foreground",
    lede: "text-secondary-foreground/70",
    tick: "bg-primary",
  },
};

export function SectionHeader({
  action,
  actionAt = "sm",
  className,
  description,
  eyebrow,
  size = "default",
  title,
  tone = "light",
}: {
  /** Rendered beside the heading block once `actionAt` is reached. */
  action?: React.ReactNode;
  /** A text link fits from `sm`; a row of filter tabs needs `lg`. */
  actionAt?: "lg" | "sm";
  className?: string;
  description?: React.ReactNode;
  eyebrow: string;
  /** `sm` is the narrow-sidebar size used by 4/8 splits. */
  size?: "default" | "sm";
  title: React.ReactNode;
  tone?: SectionTone;
}): React.ReactElement {
  const tones = toneClasses[tone];

  return (
    <div
      className={cn(
        action && "flex flex-col gap-6",
        action &&
          (actionAt === "lg"
            ? "gap-8 lg:flex-row lg:items-end lg:justify-between"
            : "sm:flex-row sm:items-end sm:justify-between"),
        className,
      )}
    >
      <div className={cn(action && "max-w-xl")}>
        <p className={cn(eyebrowClass, tones.eyebrow)}>
          <span className={cn("size-1", tones.tick)} />
          {eyebrow}
        </p>

        <h2
          className={cn(
            "mt-5 font-display",
            tones.heading,
            size === "sm"
              ? "text-3xl leading-[1.1] sm:text-4xl"
              : "text-4xl leading-[1.05] sm:text-5xl",
          )}
        >
          {title}
        </h2>

        {description && (
          <p className={cn("mt-4 max-w-xl leading-relaxed", tones.lede)}>
            {description}
          </p>
        )}
      </div>

      {action}
    </div>
  );
}
```

### `registry/default/sections/_types/common.ts`

```ts
/**
 * Shapes shared by every token-based section. Each section ships this file
 * alongside its own category types, so installing several sections simply
 * rewrites the same file.
 */

/** Which band a section sits on. A style choice, never part of `content`. */
export type Surface = "default" | "muted" | "primary" | "secondary";

export type ImageAsset = {
  alt: string;
  src: string;
};

export type LinkAction = {
  href: string;
  label: string;
};

/** Eyebrow + heading + optional lede, the header most sections open with. */
export type SectionIntro = {
  description?: string;
  eyebrow: string;
  title: string;
};

/** A figure that counts up when it scrolls into view. */
export type Stat = {
  decimals?: number;
  label: string;
  prefix?: string;
  suffix?: string;
  value: number;
};

/** A figure that is displayed as written ("1,240+", "4.9/5"). */
export type Highlight = {
  label: string;
  value: string;
};

export type FormField = {
  label: string;
  name: string;
  /** Only for `type: "select"`. The first option is the default. */
  options?: string[];
  placeholder?: string;
  required?: boolean;
  /** `full` spans both columns of a two-column form. */
  span?: "full" | "half";
  type?: "email" | "select" | "tel" | "text" | "textarea";
};

export type FormContent = {
  description?: string;
  fields: FormField[];
  note?: string;
  submitLabel: string;
  success: {
    description: string;
    resetLabel: string;
    title: string;
  };
  title: string;
};
```

### `registry/default/sections/_types/gallery.ts`

```ts
import type { ImageAsset, SectionIntro } from "./common";

/** One large image with a strip of thumbnails that swap it. */
export type GalleryViewerContent = {
  images: ImageAsset[];
  title: string;
};

/** Captioned images in a horizontal carousel. */
export type GalleryCarouselContent = SectionIntro & {
  items: {
    description: string;
    href?: string;
    image: ImageAsset;
    title: string;
  }[];
};
```