Skip to Content

FeaturesSection

Explain product capabilities using responsive feature layouts, optional media, and accessible tabs or accordions.

FeaturesSection renders product capabilities from consumer-provided items. Each feature has a stable id and title, with optional description, icon, media, action, nested content, and featured emphasis.

Beta API maturity: Beta.

Installation

import { FeaturesSection, type FeatureItem } from "@puzzle-ui/pieces";

Variant previews

The tabs and accordion variants reuse the corresponding accessible UI primitives. Tabs are keyboard-operable; accordion expansion follows the UI Accordion behavior.

grid - A familiar, balanced set of feature summaries.

390 × 844

bento - A varied grid with selected features emphasized.

390 × 844

alternating - A sequence with staggered visual rhythm.

390 × 844

split - A two-column feature collection with room for media.

390 × 844

cards - Separate feature cards for a card-based page.

390 × 844

icons - Short benefits led by consumer-provided icons.

390 × 844

numbered - An ordered set of key capabilities.

390 × 844

tabs - A detailed feature showcase with keyboard-operable tabs.

390 × 844

accordion - A space-efficient expandable feature list.

390 × 844

sticky - A media-led showcase beside scrolling feature content.

390 × 844

horizontal - A row of concise feature summaries.

390 × 844

vertical - A single-column list for narrow or editorial pages.

390 × 844

media-grid - Feature cards where each item includes media.

390 × 844

asymmetric - A grid with varied item widths.

390 × 844

editorial - Longer feature descriptions with an editorial feel.

390 × 844

compact - A dense collection for constrained layouts.

390 × 844

full-width - A broad collection that uses available section width.

390 × 844

API

PropTypeDescription
variantFeaturesVariantSelects one of the seventeen feature layouts; defaults to grid.
itemsreadonly FeatureItem[]Feature data with stable id, required title, and optional presentation slots.
FeatureItem.iconReactNodeConsumer-provided icon node.
FeatureItem.mediaReactNodeOptional image, video, or other media.
FeatureItem.contentReactNodeAdditional item content.
FeatureItem.actionReactNodeOptional consumer-provided action.
FeatureItem.featuredbooleanEmphasizes an item in layouts that support it.
Shared section propsSectionRootProps and heading propsSemantic root, theme, native attributes, heading, actions, and children.

Usage

<FeaturesSection
  variant="tabs"
  title="Built for focused teams"
  items={[
    {
      id: "automation",
      title: "Automate routine work",
      description: "Spend more time on important decisions.",
      media: <img src="/automation.png" alt="Automation settings" />,
    },
    { id: "insights", title: "Understand progress" },
  ]}
/>

An empty collection omits its list or interactive control. The tabs composition uses item IDs as tab IDs; keep IDs stable and unique. Media must have suitable alternatives when it conveys information.

Accessibility

Interactive tabs and accordions use UI keyboard and ARIA behavior. Keep the shared section heading at an appropriate page level, and ensure the item title hierarchy remains meaningful. Decorative icons should be hidden from assistive technology by their consumer-provided markup.