Skip to Content

AboutSection

Tell a company story with mission, values, milestones, team profiles, images, and measurable outcomes.

AboutSection combines company information and story content into a responsive introduction. Supply only the content that is relevant to your organization; empty collections are omitted.

Beta API maturity: Beta.

Installation

import {
  AboutSection,
  type AboutSectionProps,
  type AboutSectionVariant,
} from "@puzzle-ui/pieces";

Variant previews

Every layout has an individual preview. The examples use Northstar Advisory, a fictional consultancy.

split - Balance the story with supporting company details.

390 × 844

centered - Lead with a focused, centered introduction.

390 × 844

editorial - Give the company story a generous reading measure.

390 × 844

image-led - Put a company photograph at the center.

390 × 844

story - Emphasize the founding story and point of view.

390 × 844

timeline - Show milestones in the order they happened.

390 × 844

stats - Pair the introduction with measurable outcomes.

390 × 844

team - Introduce the people behind the company.

390 × 844

mission - Bring mission and vision into the foreground.

390 × 844

values - Make company values easy to scan.

390 × 844

asymmetric - Use an editorially weighted two-column layout.

390 × 844

full-width - Give a collection of company images more room.

390 × 844

API

PropTypeDescription
variantAboutSectionVariantsplit (default), centered, editorial, image-led, story, timeline, stats, team, mission, values, asymmetric, or full-width.
companyCompanyInfoProps without classNameOptional company name, logo, tagline, description, and native website link.
storyAboutStoryStory description, optional title, and optional editorial image.
mission, visionReactNodePurpose statements, shown when provided.
imagesreadonly EditorialImage[]Supporting images with alt text and optional captions.
statsreadonly BusinessMetricItem[]Stable IDs, labels, values, and optional descriptions.
valuesreadonly BusinessValue[]Values with stable IDs, titles, optional descriptions, and decorative icons.
timelinereadonly BusinessTimelineItem[]Milestones with stable IDs, year, title, and optional description.
teamreadonly BusinessProfile[]Optional profiles for the team composition.
Shared section propsMarketingSectionBasePropsHeading, actions, root element, native section attributes, and children.

Required and default values

Requiredness follows the exported TypeScript type. A dash means no component-level default is applied; variant-specific requirements are described in the API table above.

PropRequiredDefault
variantNo"split"
companyNo—
storyNo—
missionNo—
visionNo—
imagesNoempty array
statsNoempty array
valuesNoempty array
timelineNoempty array
teamNoempty array

Usage

<AboutSection
  variant="mission"
  eyebrow="About Northstar"
  title="Make meaningful progress."
  description="An independent partner for complex change."
  mission="Make complex change manageable for every team."
  vision="Build a more resilient, thoughtful future."
  values={[
    { id: "care", title: "Care", description: "Start with people." },
    { id: "clarity", title: "Clarity", description: "Make the complex useful." },
  ]}
/>

Content and accessibility

All data is supplied by the application; the component does not fetch company information. Provide meaningful alt text for informative images and empty alt text for decorative images. Timelines and value collections use semantic lists, metrics use a description list, and profile links remain native anchors. The section renders on the server.

Customization

Use the component's className and documented slots to adapt the composition. Prefer a caller-provided ReactNode for media, actions, or controls rather than adding domain behavior to the section.

import type { ComponentProps } from "react";
import { AboutSection } from "@puzzle-ui/pieces";

type AboutSectionProps = ComponentProps<typeof AboutSection>;

export function CustomizedSection(props: AboutSectionProps) {
  return <AboutSection {...props} className={[props.className, "brand-section"].filter(Boolean).join(" ")} />;
}

Responsive behavior

Use the preview device selector to review mobile, tablet, and desktop widths. The built-in variant controls section structure; ensure application-provided media, form controls, and children can shrink or wrap without horizontal overflow. Use the existing responsive breakpoints in scoped CSS when the consuming layout needs a product-specific adjustment.

Theme support

The section consumes semantic variables from @puzzle-ui/theme and inherits active or scoped themes. Wrap the application with Theme, and use semantic roles such as text, surface, border, and primary for local overrides. Avoid hard-coded colors, spacing, radii, and shadows.

.brand-section {
  color: var(--puzzle-color-text);
  background: var(--puzzle-color-surface);
  border-color: var(--puzzle-color-border);
}

Composition

Compose this section with the UI primitives named in its API and use the documented slots for consumer-owned controls or media. Keep data fetching, routing, validation, permissions, and persistence in the application. The children slot is intended for additional content that belongs with this section, not as a substitute for its typed data model.

TypeScript example

The package exports this component from its root. Derive a wrapper's exact prop type from the public component rather than widening it:

import type { ComponentProps } from "react";
import { AboutSection } from "@puzzle-ui/pieces";

type AboutSectionProps = ComponentProps<typeof AboutSection>;

export function SectionWrapper(props: AboutSectionProps) {
  return <AboutSection {...props} />;
}

Framework compatibility

The section is router-independent. Static compositions can be server-rendered; place callback-driven interactions in the framework's client boundary. See Next.js and TanStack Start integration for runnable framework examples and SSR guidance.