Skip to Content

HouseRulesSection

Present caller-supplied check-in, guest, pet, smoking, parking, payment, cancellation, and practical house rules.

HouseRulesSection organizes house rules supplied by the accommodation owner or application. It presents policy content only; it does not determine or enforce booking terms.

Beta API maturity: Beta.

TypeScript example

import {
  HouseRulesSection,
  type HouseRuleCategory,
} from "@puzzle-ui/pieces";

Expanded and compact variants

Expanded groups can include category descriptions and supporting copy for each rule. The examples cover arrival, pets, children, smoking, parking, payment, cancellation, and practical arrangements. Compact mode shows the rule label and value without supporting descriptions; optional native disclosures remain keyboard operable.

expanded - Include supporting descriptions alongside each rule.

390 × 844

compact - Show concise rule values and optional disclosures.

390 × 844

API

PropTypeRequiredDefaultDescription
categoriesreadonly HouseRuleCategory[]Yes—Category records with unique IDs and rule lists.
variant"compact" | "expanded"No"expanded"Whether supporting descriptions are shown.
collapsiblebooleanNofalseWraps category content in native disclosure elements.
defaultOpenbooleanNofalseInitial disclosure state when collapsible is enabled.
emptyStateReactNodeNo"No house rules provided."Message for an empty category list.
classNamestringNo—Additional class on the section.
title, description, eyebrow, actionsReactNodeNo—Shared section heading and action props.

Data types

HouseRuleCategory contains an id, a title, optional description, and a rules array. Each HouseRule contains a unique id, label, value, and optional description. Rule labels and values accept ReactNode, so the application can provide links or other semantic content where appropriate.

Responsive behavior and accessibility

  • Categories use a fluid grid that becomes a single column on narrow screens.
  • Rule labels and values wrap instead of clipping.
  • Category content uses semantic headings and definition lists.
  • Collapsible groups use native disclosure controls, which are keyboard operable and expose their expanded state to assistive technology.

Theme support and customization

Cards, borders, and text consume Puzzle Theme tokens and inherit scoped themes. Pass caller-owned labels and values as React content; do not encode policy decisions in this presentation component.

Use the component in either supported framework; see Framework Integration for Next.js and TanStack Start guidance.