React Page Sections
Compose responsive marketing sections and introductory page heroes with @puzzle-ui/pieces.
@puzzle-ui/pieces provides composed interface sections built on Puzzle UI. Use the existing Hero layouts for page introductions and the Marketing & Conversion collection for product features, customer proof, FAQs, comparisons, and calls to action. Pieces is not a general-purpose page builder or a library of complete website templates.
Start with a Hero
Import the generic Hero component when you want to provide your own content and actions. The API also includes layout and visual presets such as SplitHero, CenteredHero, ProductHero, and CampaignHero.
import { Button } from "@puzzle-ui/ui";
import { Hero } from "@puzzle-ui/pieces";
export function ProductIntroduction() {
return (
<Hero
eyebrow="Product"
title="A clear introduction to your page."
description="Pair a concise message with a primary next step."
actions={<Button href="/docs/getting-started">Get started</Button>}
/>
);
}The generic component supports different layouts, content alignment, and optional media. Browse the Hero reference for available layouts, presets, and examples.
Compose, do not replace
Pieces supplies larger sections, while @puzzle-ui/ui provides the underlying components and @puzzle-ui/theme provides design tokens and theme behavior. You can use a Hero on a page and compose the rest of the interface from those building blocks.
Marketing & Conversion
Ten new section families cover announcements, logos, features, benefits, statistics, testimonials, calls to action, FAQs, process steps, and comparisons. Browse the Marketing & Conversion overview for the catalog and shared design principles.
API maturity
The documented Hero component and presets have Stable APIs, with backward-compatibility intent within a major version. This describes API maturity, not production readiness. Check the Hero API reference for supported props and review the API maturity guide.