Skip to content
Klarhimmel UI

Features, image cards

Features, image cards previewFeatures, image cards preview

Install

npx shadcn add https://ui.klarhimmel.com/r/features-image-cards.json
DetailsAbout, usage, props and more

Section heading with up to two buttons at its right, and two to six equal cards, each a picture on top with a small badge, a title, a line and a text link; three in a…

Import

Import

import Block from '@/components/klarhimmel/blocks/features-image-cards';
Also called
  • features/image-cards
About
Section heading with up to two buttons at its right, and two to six equal cards, each a picture on top with a small badge, a title, a line and a text link; three in a row on a wide container, or one row that scrolls sideways.
Category
What it does, as a grid, a list, tabs or alternating rows. New project? Set it up once: /get-started/installation.

Notes

When to use it

Two to six equal cards, each with a picture, a badge, a title, a line and a text link, under a heading with up to two buttons. Pick features-grid for icons and features-stacked-cards for a pinned intro.

Writing for it

- Use the badge for one short word of category or status, and keep titles to a line or two. - Turn on the scroll setting to run the cards as one row that scrolls sideways with snapping and no script, which suits more than three. - Up to two header buttons sit at the right of the heading. The first is the primary one.

Watch out for

The scroll row cuts the last card at the edge on purpose to show there is more, so a row of exactly two cards looks empty. Use the grid for small sets.

Usage

The block in a page, with its default content (long lists shortened). Every prop is in the table below.

section.tsx
import { Theme } from '@/components/klarhimmel/theme/style';
import { BlockSurface } from '@/components/klarhimmel/blocks/surface';
import FeaturesImageCards from '@/components/klarhimmel/blocks/features-image-cards';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <FeaturesImageCards props={{
          "eyebrow": "Name the section",
          "title": "Say what the reader finds in these cards",
          "description": "Say in one sentence what the cards below have in common and who they are for.",
          "headerActions": [
            {
              "label": "Name the main action",
              "href": "#primary"
            },
            {
              "label": "Name the other action",
              "href": "#secondary"
            }
          ],
          "items": [
            {
              "media": {
                "src": "/pictures/photo-house1.avif",
                "alt": "A red wooden house with white windows and a white door"
              },
              "badge": "Category",
              "title": "Name the first item",
              "description": "Say in one line what it gives the reader.",
              "link": {
                "label": "Read more",
                "href": "#first"
              }
            },
            {
              "media": {
                "src": "/pictures/photo-key2.avif",
                "alt": "A key in the lock of a green door"
              },
              "badge": "Category",
              "title": "Name the second item",
              "description": "Say in one line what it gives the reader.",
              "link": {
                "label": "Read more",
                "href": "#second"
              }
            }
          ]
        }} />
      </BlockSurface>
    </Theme>
  );
}

Props

The type, default and text limit of every prop. On a real page, over-limit text is kept and checkSections flags it (Installation, Check a page before you ship); this live preview shows the default until it fits. The panel above edits all props.

PropTypeDefaultDescription
eyebrowstring'Name the section'Text, up to 60 characters.
titlestring'Say what the reader finds in these …'Text, up to 120 characters.
descriptionstring'Say in one sentence what the cards …'Text, up to 300 characters.
headerActionsLink[]2 itemsList of up to 2. Optional; empty is not rendered.
scrollboolean-Optional; empty is not rendered.
actionsInlineboolean-Optional; empty is not rendered.
items{ media, badge, title, description, link }[]3 itemsList of 2 to 6. Each item: media, badge (optional), title, description, link (optional).
headingLevel'1' | '2'-One of '1', '2'. Optional; empty is not rendered.