# Brand roster showcase

A shadcn/ui brands section for stores and marketplaces: names roll through a list while each brand's products slide in beside it, on a 12-column grid.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available for the docs, pricing and about pages: append `.md` to the URL or send an `Accept: text/markdown` header (the home page answers the header too). An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).

## At a glance

- **Good for:** Marketplaces and multi-brand stores; Concept and department store homepages; Wholesale platforms showing who they stock; Retail landing pages featuring partner brands
- **Category:** E-commerce, Marketing · **Type:** Brands · **Style:** Motion, Minimal, Dark mode
- **See it:** [Live preview](https://www.craftui.space/docs/templates/brands-section) · [Video](https://pub-52b0d9cec7c64f638ba3f33a29718fa6.r2.dev/Videos_product_cards/brands-brand-roster-showcase.0e99b2f2.mp4)

## Install

```bash
pnpm dlx shadcn@latest add https://www.craftui.space/r/brands-section.json
```

This is a paid item (SEC-0XAFJP): the install needs a craftUI plan or a purchase of it. Signed in, the docs page gives your personal install command. Plans: https://www.craftui.space/pricing

## Usage

```tsx
import BrandsSection from "@/components/sections/brands-section/brands-section";

export default function Page() {
  return <BrandsSection />;
}
```

With no props it renders with demo content; pass your own through the props below.

## Props

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `brands` | `Brand[]` | `built-in demo content` | The roster. Rows beyond `visible` wait their turn and roll in. |
| `cta` | `{ href: string; label: string } \| null` | `built-in demo value` | The link under the subheader. Pass `null` to leave it out. |
| `description` | `string` | `"Independent makers we stock and stand behind, from small-batch ceramics to eve…` | The subheader: one or two sentences beside the heading. |
| `guides` | `boolean` | `false` | Draw the column grid over the section, the way a layout grid shows in a design tool. Off by default: it's for checking alignment. |
| `heading` | `string` | `"Shop from brands like"` | The section heading, top left. |
| `interval` | `number` | `3000` | Milliseconds each row stays lit while the cycle runs. |
| `visible` | `number` | `7` | How many rows the list shows at once. |

It also accepts every `<section>` attribute (`className`, `id`, `aria-*` and so on).

### `Brand`

| Field | Type | Description |
| --- | --- | --- |
| `category` (required) | `string` | What the brand makes, shown under its products: "Ceramics". |
| `href` | `string` | Where the brand's row links to: its store or collection page. |
| `images` (required) | `[BrandImage, BrandImage, BrandImage]` | Three product shots: the tall one on the left, then top and bottom right. |
| `name` (required) | `string` | The brand's name, set large in the list. |
| `products` | `number` | How many of its products the store carries, shown under its products. |
| `thumbnail` | `string` | Small square shown in front of the lit name. Defaults to the first image. |

### `BrandImage`

| Field | Type | Description |
| --- | --- | --- |
| `alt` (required) | `string` | Describes the product in the shot, for anyone who can't see it. |
| `src` (required) | `string` | Image URL. Crop it near the cell's shape (see `SHOT_SIZES`). |

## Files

The install adds:

- `components/sections/brands-section/brands-section.tsx`

npm dependencies (installed for you): `motion`.

shadcn/ui components it uses (the shadcn CLI adds any that are missing): `button`.