Skip to Content

Project Components

Compose generic project cards, collections, progress, member lists, and headers with Puzzle Pieces.

Project compositions are presentation-only. They accept generic content and do not depend on a Workspace model, database, or router.

Beta API maturity: Beta. These compositions are new and may evolve based on feedback.

Installation

import {
  ProjectCard,
  ProjectGrid,
  ProjectHeader,
  ProjectList,
  ProjectMembers,
  ProjectProgress,
  ProjectStatusBadge,
} from "@puzzle-ui/pieces";

Project collections

Use the grid or list layout to arrange ProjectCard compositions. Each card accepts caller-provided content and can link its title using a native anchor.

390 × 844

Project details

ProjectHeader provides a level-one heading, description, metadata, status, and action slots. ProjectProgress uses a native <progress> element. ProjectMembers renders a labelled list; provide accessible avatar content when an avatar conveys information.

390 × 844

ProjectStatusBadge supports default, info, success, warning, and danger tones. Use concise status labels and do not rely on color alone to communicate meaning.

Accessibility and responsive behavior

  • Collection regions and member lists have accessible names.
  • Project titles are headings; use ProjectHeader for a project detail page and ProjectCard within a collection.
  • Link titles use native anchor behavior and visible focus indicators.
  • Progress indicators use native semantics and a visible percentage.
  • Layouts respond to available width and Puzzle theme tokens adapt to light and dark themes.

API

ComponentProps
ProjectCardtitle (required), description, status, progress, members, href, actions, className
ProjectGrid / ProjectListchildren (required), label, className
ProjectHeadertitle (required), description, status, actions, meta, className
ProjectProgresslabel and value (required; value from 0 to 100), className
ProjectMembersmembers (required; each has id, name, optional avatar), label, className
ProjectStatusBadgelabel (required), tone, className