Skip to Content

Host Profile

Present one hospitality host by reusing the existing TeamSection profile card with languages, a story, and a caller-owned contact action.

HostProfileSection composes one profile through the existing TeamSection and UI ProfileCard. Use TeamSection for a general team or a collection of people.

Beta API maturity: Beta.

Installation

import {
  HostProfileSection,
  type HospitalityHostProfile,
} from "@puzzle-ui/pieces";

Variant previews

The compact and profile variants preserve the TeamSection profile-card presentation and add optional host-specific information.

compact - Keep the host introduction brief.

390 × 844

profile - Give the profile and story more room.

390 × 844

API

PropTypeRequiredDefault
hostHospitalityHostProfileYes—
variant"compact" | "profile"No"profile"
languagesLabelstringNo"Languages"
storyLabelReactNodeNo"A little about your host"
Shared section propsMarketingSectionBasePropsNo—

HospitalityHostProfile

FieldTypeRequiredDescription
idstringYesStable profile identifier.
namestringYesHost's displayed name.
roleReactNodeNoRole shown by the existing profile card; defaults to “Host”.
avatarBusinessImage from @puzzle-ui/uiNoOptional image with caller-provided alternative text.
biographyReactNodeNoShort profile introduction.
languagesreadonly string[]NoLanguages supplied by the application.
storyReactNodeNoOptional hospitality story.
contactActionReactNodeNoCaller-owned link, button, or action.
Profile fieldsBusinessProfile fields except roleNoExisting profile-card links and social properties.

Usage

<HostProfileSection
  title="Meet your host"
  host={{
    id: "mara",
    name: "Mara Jensen",
    role: "Owner and host",
    biography: "A local host who knows the quieter coastal paths.",
    languages: ["Dutch", "English"],
    story: "Mara restored the guest house with her family.",
    contactAction: <a href="mailto:mara@example.test">Contact Mara</a>,
  }}
/>

Responsive behavior

The profile card inherits TeamSection's content-driven layout. Languages wrap as a list of labels, and long stories and contact actions remain within the section width. No fixed card height is imposed.

Accessibility

The existing profile card renders the name and role as text. Language labels remain visible in a labeled list. Supply meaningful avatar alternatives and descriptive names for caller-provided actions.

Theme support

The profile card and host details use the existing TeamSection and Puzzle semantic tokens, so active and scoped themes are inherited.

Customization

Use className, shared section heading props, and caller-supplied ReactNode for story and contact content. The section does not provide messaging, navigation, or contact submission.

Composition

Use HostProfileSection for one host and TeamSection for multiple staff members. See the Boutique B&B and Restaurant Experience compositions.

TypeScript example

The profile type is public from the package root and builds on the existing BusinessProfile contract.

Framework compatibility

The component is router-independent and server-renderable. Interactions in a caller-provided action belong to the application. See Next.js and TanStack Start integration.