Skip to main content
CodivDocs

Tiles

Visual-heavier grid of clickable tiles for landing pages and category hubs.

Usage

<Tiles cols={3}>
  <Tile title="Quickstart" description="5-minute setup" href="/quickstart" icon="rocket" />
  <Tile title="Components" description="30+ MDX components" href="/components/callout" icon="layers" />
  <Tile title="API Reference" description="Complete REST API" href="/api/authentication" icon="code" />
</Tiles>

<Tiles> is a responsive grid of <Tile> cards. Each tile is centered, icon-first, and clickable as a single unit.

Tiles vs Cards

<Tiles> / <Tile><Card> / <CardGroup>
Visual weightHeavy — large icon plate, centeredLight — left-aligned, dense
Best forLanding pages, "pick your starting point"Feature grids, dense info
Required hrefYesNo (optional)
DescriptionCentered, smallerLeft-aligned

Use Tiles when you have 3-6 high-level entry points and want each to feel like a poster. Use Cards when you have many items and want density.

4 tiles

<Tiles cols={4}>
  <Tile title="Free" icon="user" href="/pricing" />
  <Tile title="Pro" icon="zap" href="/pricing" />
  <Tile title="Business" icon="trophy" href="/pricing" />
  <Tile title="Enterprise" icon="shield" href="/pricing" />
</Tiles>

Custom icon color

Override the default primary tint per tile:

<Tiles cols={3}>
  <Tile title="Stable" icon="check" color="var(--docs-success)" href="/" />
  <Tile title="Beta" icon="zap" color="var(--docs-warning)" href="/" />
  <Tile title="Experimental" icon="sparkles" color="var(--docs-danger)" href="/" />
</Tiles>

Props

Tiles

PropTypeDefaultDescription
cols2 | 3 | 43Number of columns on desktop
childrenReactNoderequiredOne or more <Tile>

Tile

PropTypeRequiredDescription
titlestringYesTile heading
hrefstringYesLink destination
descriptionstringNoSubtitle below the title
iconstringNoLucide icon name or emoji
colorstringNoOverride the icon tint (CSS color or var)

Last updated April 12, 2026