# Feature grid

> A features section: a grid of feature cards, two to four per row. A whole card can be a link while its accessible name stays short.

Facade UI item `feature-grid` (block, section).
Docs page: https://facadeui.dev/components/feature-grid · Registry JSON: https://facadeui.dev/r/feature-grid.json

## Install

```bash
npx shadcn@latest add @facade/feature-grid
```

Or by URL: `npx shadcn@latest add https://facadeui.dev/r/feature-grid.json`. The CLI also installs what it needs: lucide-react@^1.47.0, @facade/container, @facade/feature-icon, @facade/heading, @facade/section, @facade/section-header, @facade/types, @facade/utils.

Files: `components/sections/feature-grid.tsx`

Usage example as an installable item: `npx shadcn@latest add @facade/feature-grid-demo` (lands in components/examples/).

## Usage

The source of the preview on the docs page. `./content` holds sample data.

```tsx
import { FeatureGrid } from "@/components/sections/feature-grid"

import { FEATURES } from "./content"

export function Demo() {
  return (
    <FeatureGrid
      eyebrow="Features"
      title="Everything a marketing page needs"
      description="Cards with an href become clickable through a stretched overlay, so the accessible name stays the title."
      items={FEATURES}
      columns={3}
    />
  )
}
```

## Props

### FeatureGridProps

Extends SectionBaseProps, ListSlotProps.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `items` (required) | `FeatureItem[]` |  |  |
| `title` | `string` |  |  |
| `eyebrow` | `string` |  |  |
| `description` | `string` |  |  |
| `link` | `LinkComponent` |  |  |
| `columns` | `2 \| 3 \| 4` | `3` |  |
| `itemHeadingLevel` | `HeadingLevel` |  |  |
| `variant` | `"card" \| "plain"` | `"card"` | `card` adds a border and background. `plain` has neither. |
| `iconVariant` | `"soft" \| "solid" \| "outline" \| "plain"` | `"soft"` |  |
| `align` | `"start" \| "center"` | `"start"` |  |