Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

feat(templates): add showcase blocks for layout and structure sub-components (#1740)

Cindy Zhangd3f116a44faf
diff --git a/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs
new file mode 100644
index 0000000000..ee06618a95
--- /dev/null
+++ b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'AvatarStatusDot',
+ description:
+ 'AvatarStatusDot renders a presence indicator on an Avatar, with variants for positive, neutral, and negative states. The dot size automatically coordinates with the Avatar size.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Avatar', 'AvatarStatusDot'],
+};
diff --git a/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.tsx b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.tsx
new file mode 100644
index 0000000000..8a12bd95d3
--- /dev/null
+++ b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.tsx
@@ -0,0 +1,26 @@
+'use client';
+
+import {XDSAvatar, XDSAvatarStatusDot} from '@xds/core/Avatar';
+import {XDSHStack} from '@xds/core/Layout';
+
+export default function AvatarStatusDotShowcase() {
+ return (
+ <XDSHStack gap={4} vAlign="center">
+ <XDSAvatar
+ name="Online User"
+ size="large"
+ status={<XDSAvatarStatusDot variant="positive" label="Online" />}
+ />
+ <XDSAvatar
+ name="Away User"
+ size="large"
+ status={<XDSAvatarStatusDot variant="neutral" label="Away" />}
+ />
+ <XDSAvatar
+ name="Busy User"
+ size="large"
+ status={<XDSAvatarStatusDot variant="negative" label="Busy" />}
+ />
+ </XDSHStack>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs
new file mode 100644
index 0000000000..f3b0dccc1e
--- /dev/null
+++ b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'BreadcrumbItem',
+ description:
+ 'BreadcrumbItem represents a single step in a breadcrumb trail, supporting links, icons, current-page markers, and custom link components.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Breadcrumbs', 'BreadcrumbItem'],
+};
diff --git a/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.tsx b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.tsx
new file mode 100644
index 0000000000..cb4f96fe38
--- /dev/null
+++ b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.tsx
@@ -0,0 +1,76 @@
+'use client';
+
+import type {ComponentProps} from 'react';
+import {XDSBreadcrumbs, XDSBreadcrumbItem} from '@xds/core/Breadcrumbs';
+import {XDSVStack} from '@xds/core/Layout';
+import {XDSText} from '@xds/core/Text';
+
+function HomeIcon(props: ComponentProps<'svg'>) {
+ return (
+ <svg
+ fill="none"
+ viewBox="0 0 24 24"
+ strokeWidth={2}
+ stroke="currentColor"
+ {...props}>
+ <path
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ d="M3 9.5L12 3l9 6.5V20a1 1 0 01-1 1H4a1 1 0 01-1-1V9.5z"
+ />
+ </svg>
+ );
+}
+
+export default function BreadcrumbItemShowcase() {
+ return (
+ <XDSVStack gap={4}>
+ <XDSVStack gap={1}>
+ <XDSText type="supporting" color="secondary">
+ With start icon
+ </XDSText>
+ <XDSBreadcrumbs>
+ <XDSBreadcrumbItem href="/" startIcon={<HomeIcon />}>
+ Home
+ </XDSBreadcrumbItem>
+ <XDSBreadcrumbItem href="/docs">Docs</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem isCurrent>Components</XDSBreadcrumbItem>
+ </XDSBreadcrumbs>
+ </XDSVStack>
+
+ <XDSVStack gap={1}>
+ <XDSText type="supporting" color="secondary">
+ As current page (non-link)
+ </XDSText>
+ <XDSBreadcrumbs>
+ <XDSBreadcrumbItem href="/">Home</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem href="/settings">Settings</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem isCurrent>Profile</XDSBreadcrumbItem>
+ </XDSBreadcrumbs>
+ </XDSVStack>
+
+ <XDSVStack gap={1}>
+ <XDSText type="supporting" color="secondary">
+ Supporting variant
+ </XDSText>
+ <XDSBreadcrumbs variant="supporting">
+ <XDSBreadcrumbItem href="/">Home</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem href="/admin">Admin</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem href="/admin/users">Users</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem isCurrent>Permissions</XDSBreadcrumbItem>
+ </XDSBreadcrumbs>
+ </XDSVStack>
+
+ <XDSVStack gap={1}>
+ <XDSText type="supporting" color="secondary">
+ With onClick handler (no href)
+ </XDSText>
+ <XDSBreadcrumbs>
+ <XDSBreadcrumbItem onClick={() => {}}>Dashboard</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem onClick={() => {}}>Projects</XDSBreadcrumbItem>
+ <XDSBreadcrumbItem isCurrent>Project Alpha</XDSBreadcrumbItem>
+ </XDSBreadcrumbs>
+ </XDSVStack>
+ </XDSVStack>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs
new file mode 100644
index 0000000000..041a94c9f3
--- /dev/null
+++ b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'CollapsibleGroup',
+ description:
+ 'CollapsibleGroup coordinates multiple Collapsible components so that expanding one can automatically collapse the others, creating accordion behavior.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Collapsible', 'CollapsibleGroup'],
+};
diff --git a/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.tsx b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.tsx
new file mode 100644
index 0000000000..9cbf73b3cf
--- /dev/null
+++ b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.tsx
@@ -0,0 +1,41 @@
+'use client';
+
+import {XDSCollapsible, XDSCollapsibleGroup} from '@xds/core/Collapsible';
+import {XDSCard} from '@xds/core/Card';
+import {XDSVStack} from '@xds/core/Layout';
+import {XDSCenter} from '@xds/core/Center';
+import {XDSText} from '@xds/core/Text';
+
+export default function CollapsibleGroupShowcase() {
+ return (
+ <XDSCenter width={400}>
+ <XDSCollapsibleGroup type="single" defaultValue="shipping">
+ <XDSVStack gap={2} width="100%">
+ <XDSCard>
+ <XDSCollapsible trigger="Shipping Information" value="shipping">
+ <XDSText type="body" color="secondary">
+ Standard shipping takes 3–5 business days. Express shipping is
+ available for an additional fee.
+ </XDSText>
+ </XDSCollapsible>
+ </XDSCard>
+ <XDSCard>
+ <XDSCollapsible trigger="Return Policy" value="returns">
+ <XDSText type="body" color="secondary">
+ Items can be returned within 30 days of purchase. Items must be
+ unused and in original packaging.
+ </XDSText>
+ </XDSCollapsible>
+ </XDSCard>
+ <XDSCard>
+ <XDSCollapsible trigger="Payment Methods" value="payment">
+ <XDSText type="body" color="secondary">
+ We accept all major credit cards, PayPal, and bank transfers.
+ </XDSText>
+ </XDSCollapsible>
+ </XDSCard>
+ </XDSVStack>
+ </XDSCollapsibleGroup>
+ </XDSCenter>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs
new file mode 100644
index 0000000000..35dd347a03
--- /dev/null
+++ b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'DialogHeader',
+ description:
+ 'DialogHeader provides a structured header for dialogs with slots for title, subtitle, close button, and optional start or end content.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Dialog', 'DialogHeader'],
+};
diff --git a/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.tsx b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.tsx
new file mode 100644
index 0000000000..92c90ed8fe
--- /dev/null
+++ b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.tsx
@@ -0,0 +1,30 @@
+'use client';
+
+import {XDSDialog, XDSDialogHeader} from '@xds/core/Dialog';
+import {XDSLayout, XDSLayoutContent, XDSCard} from '@xds/core/Layout';
+import {XDSText} from '@xds/core/Text';
+
+export default function DialogHeaderShowcase() {
+ return (
+ <XDSDialog isOpen isInline onOpenChange={() => {}}>
+ <XDSLayout
+ header={
+ <XDSDialogHeader
+ title="Edit Profile"
+ subtitle="Update your personal information"
+ onOpenChange={() => {}}
+ />
+ }
+ content={
+ <XDSLayoutContent>
+ <XDSCard variant="muted">
+ <XDSText type="body" color="secondary">
+ Dialog body content goes here.
+ </XDSText>
+ </XDSCard>
+ </XDSLayoutContent>
+ }
+ />
+ </XDSDialog>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs
new file mode 100644
index 0000000000..24b7e84287
--- /dev/null
+++ b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'GridSpan',
+ description:
+ 'GridSpan lets a grid item span multiple columns or rows within an XDSGrid, enabling masonry-style and asymmetric layouts.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Grid', 'GridSpan'],
+};
diff --git a/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.tsx b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.tsx
new file mode 100644
index 0000000000..7abcd6f2e7
--- /dev/null
+++ b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.tsx
@@ -0,0 +1,43 @@
+'use client';
+
+import {XDSGrid, XDSGridSpan} from '@xds/core/Grid';
+import {XDSCard} from '@xds/core/Card';
+import {XDSText} from '@xds/core/Text';
+
+export default function GridSpanShowcase() {
+ return (
+ <XDSGrid columns={3} gap={3}>
+ <XDSGridSpan columns={2}>
+ <XDSCard variant="muted" padding={4} height={80}>
+ <XDSText type="body" color="secondary">
+ Spans 2 columns
+ </XDSText>
+ </XDSCard>
+ </XDSGridSpan>
+ <XDSCard variant="muted" padding={4} height={80}>
+ <XDSText type="body" color="secondary">
+ 1 col
+ </XDSText>
+ </XDSCard>
+ <XDSCard variant="muted" padding={4} height={60}>
+ <XDSText type="body" color="secondary">
+ 1 col
+ </XDSText>
+ </XDSCard>
+ <XDSGridSpan columns={2}>
+ <XDSCard variant="muted" padding={4} height={60}>
+ <XDSText type="body" color="secondary">
+ Spans 2 columns
+ </XDSText>
+ </XDSCard>
+ </XDSGridSpan>
+ <XDSGridSpan columns="full">
+ <XDSCard variant="muted" padding={4} height={60}>
+ <XDSText type="body" color="secondary">
+ Full-width row
+ </XDSText>
+ </XDSCard>
+ </XDSGridSpan>
+ </XDSGrid>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs
new file mode 100644
index 0000000000..364ebc41ee
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'LayoutContent',
+ description:
+ 'LayoutContent is the scrollable main content area within a Layout, providing automatic padding and scroll containment between the header and footer.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Layout', 'LayoutContent'],
+};
diff --git a/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.tsx b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.tsx
new file mode 100644
index 0000000000..da80254863
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.tsx
@@ -0,0 +1,53 @@
+'use client';
+
+import {
+ XDSLayout,
+ XDSLayoutContent,
+ XDSLayoutHeader,
+ XDSLayoutFooter,
+ XDSLayoutPanel,
+ XDSCard,
+ XDSVStack,
+} from '@xds/core/Layout';
+import {XDSCenter} from '@xds/core/Center';
+import {XDSText, XDSHeading} from '@xds/core/Text';
+
+export default function LayoutContentShowcase() {
+ return (
+ <XDSCenter width={600}>
+ <XDSLayout
+ height="fill"
+ header={
+ <XDSLayoutHeader hasDivider>
+ <XDSCard variant="muted" />
+ </XDSLayoutHeader>
+ }
+ start={
+ <XDSLayoutPanel hasDivider width={140}>
+ <XDSCard variant="muted" />
+ </XDSLayoutPanel>
+ }
+ content={
+ <XDSLayoutContent role="main">
+ <XDSVStack gap={3}>
+ <XDSHeading level={5}>Main Content Area</XDSHeading>
+ <XDSText type="body" color="secondary">
+ LayoutContent provides automatic padding and scroll containment.
+ It fills the remaining space between the header and footer.
+ </XDSText>
+ <XDSText type="body" color="secondary">
+ Content that overflows will scroll within this area while the
+ header and footer remain fixed.
+ </XDSText>
+ </XDSVStack>
+ </XDSLayoutContent>
+ }
+ footer={
+ <XDSLayoutFooter hasDivider>
+ <XDSCard variant="muted" />
+ </XDSLayoutFooter>
+ }
+ />
+ </XDSCenter>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs
new file mode 100644
index 0000000000..9c34e389bf
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'LayoutFooter',
+ description:
+ 'LayoutFooter is a fixed footer slot within a Layout, pinned to the bottom for persistent actions like form buttons or navigation.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Layout', 'LayoutFooter'],
+};
diff --git a/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.tsx b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.tsx
new file mode 100644
index 0000000000..55f3f47c46
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.tsx
@@ -0,0 +1,50 @@
+'use client';
+
+import {
+ XDSLayout,
+ XDSLayoutContent,
+ XDSLayoutHeader,
+ XDSLayoutFooter,
+ XDSLayoutPanel,
+ XDSCard,
+ XDSHStack,
+} from '@xds/core/Layout';
+import {XDSCenter} from '@xds/core/Center';
+import {XDSButton} from '@xds/core/Button';
+
+export default function LayoutFooterShowcase() {
+ return (
+ <XDSCenter width={600}>
+ <XDSLayout
+ height="fill"
+ header={
+ <XDSLayoutHeader hasDivider>
+ <XDSCard variant="muted" />
+ </XDSLayoutHeader>
+ }
+ start={
+ <XDSLayoutPanel hasDivider width={140}>
+ <XDSCard variant="muted" />
+ </XDSLayoutPanel>
+ }
+ content={
+ <XDSLayoutContent>
+ <XDSCard variant="muted" />
+ </XDSLayoutContent>
+ }
+ footer={
+ <XDSLayoutFooter hasDivider>
+ <XDSHStack gap={2} hAlign="end">
+ <XDSButton label="Cancel" variant="secondary">
+ Cancel
+ </XDSButton>
+ <XDSButton label="Save" variant="primary">
+ Save
+ </XDSButton>
+ </XDSHStack>
+ </XDSLayoutFooter>
+ }
+ />
+ </XDSCenter>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs
new file mode 100644
index 0000000000..a40713866e
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'LayoutHeader',
+ description:
+ 'LayoutHeader is a fixed header slot within a Layout, pinned to the top for titles, navigation, and action buttons.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Layout', 'LayoutHeader'],
+};
diff --git a/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.tsx b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.tsx
new file mode 100644
index 0000000000..4bc5d2cd29
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.tsx
@@ -0,0 +1,54 @@
+'use client';
+
+import {
+ XDSLayout,
+ XDSLayoutHeader,
+ XDSLayoutContent,
+ XDSLayoutFooter,
+ XDSLayoutPanel,
+ XDSCard,
+ XDSHStack,
+} from '@xds/core/Layout';
+import {XDSCenter} from '@xds/core/Center';
+import {XDSHeading} from '@xds/core/Text';
+import {XDSButton} from '@xds/core/Button';
+
+export default function LayoutHeaderShowcase() {
+ return (
+ <XDSCenter width={600}>
+ <XDSLayout
+ height="fill"
+ header={
+ <XDSLayoutHeader hasDivider>
+ <XDSHStack gap={2} vAlign="center" hAlign="between">
+ <XDSHeading level={4}>Dashboard</XDSHeading>
+ <XDSHStack gap={2}>
+ <XDSButton label="Export" variant="secondary">
+ Export
+ </XDSButton>
+ <XDSButton label="New Item" variant="primary">
+ New Item
+ </XDSButton>
+ </XDSHStack>
+ </XDSHStack>
+ </XDSLayoutHeader>
+ }
+ start={
+ <XDSLayoutPanel hasDivider width={140}>
+ <XDSCard variant="muted" />
+ </XDSLayoutPanel>
+ }
+ content={
+ <XDSLayoutContent>
+ <XDSCard variant="muted" />
+ </XDSLayoutContent>
+ }
+ footer={
+ <XDSLayoutFooter hasDivider>
+ <XDSCard variant="muted" />
+ </XDSLayoutFooter>
+ }
+ />
+ </XDSCenter>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs
new file mode 100644
index 0000000000..befbfb7ece
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'LayoutPanel',
+ description:
+ 'LayoutPanel is a sidebar slot within a Layout, used for navigation, detail views, or secondary content alongside the main content area.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Layout', 'LayoutPanel'],
+};
diff --git a/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.tsx b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.tsx
new file mode 100644
index 0000000000..f89110d6ee
--- /dev/null
+++ b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.tsx
@@ -0,0 +1,47 @@
+'use client';
+
+import {
+ XDSLayout,
+ XDSLayoutPanel,
+ XDSLayoutContent,
+ XDSLayoutHeader,
+ XDSLayoutFooter,
+ XDSCard,
+} from '@xds/core/Layout';
+import {XDSCenter} from '@xds/core/Center';
+import {XDSList, XDSListItem} from '@xds/core/List';
+
+export default function LayoutPanelShowcase() {
+ return (
+ <XDSCenter width={600}>
+ <XDSLayout
+ height="fill"
+ header={
+ <XDSLayoutHeader hasDivider>
+ <XDSCard variant="muted" />
+ </XDSLayoutHeader>
+ }
+ start={
+ <XDSLayoutPanel hasDivider width={140} role="navigation">
+ <XDSList>
+ <XDSListItem label="Overview" isSelected />
+ <XDSListItem label="Analytics" />
+ <XDSListItem label="Reports" />
+ <XDSListItem label="Settings" />
+ </XDSList>
+ </XDSLayoutPanel>
+ }
+ content={
+ <XDSLayoutContent>
+ <XDSCard variant="muted" />
+ </XDSLayoutContent>
+ }
+ footer={
+ <XDSLayoutFooter hasDivider>
+ <XDSCard variant="muted" />
+ </XDSLayoutFooter>
+ }
+ />
+ </XDSCenter>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs
new file mode 100644
index 0000000000..86ec7140c5
--- /dev/null
+++ b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'StackItem',
+ description:
+ 'StackItem can be used within XDSHStack or XDSVStack for more granular control over individual item sizing and alignment, but is optional — stack children work without it.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['Stack', 'StackItem'],
+};
diff --git a/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.tsx b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.tsx
new file mode 100644
index 0000000000..898208640d
--- /dev/null
+++ b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.tsx
@@ -0,0 +1,33 @@
+'use client';
+
+import {XDSHStack, XDSStackItem} from '@xds/core/Layout';
+import {XDSCard} from '@xds/core/Card';
+import {XDSText} from '@xds/core/Text';
+
+export default function StackItemShowcase() {
+ return (
+ <XDSHStack gap={3} vAlign="center">
+ <XDSStackItem size="static">
+ <XDSCard variant="muted" padding={3}>
+ <XDSText type="supporting" color="secondary">
+ Static
+ </XDSText>
+ </XDSCard>
+ </XDSStackItem>
+ <XDSStackItem size="fill">
+ <XDSCard variant="muted" padding={3}>
+ <XDSText type="supporting" color="secondary">
+ Fills remaining space
+ </XDSText>
+ </XDSCard>
+ </XDSStackItem>
+ <XDSStackItem size="static">
+ <XDSCard variant="muted" padding={3}>
+ <XDSText type="supporting" color="secondary">
+ Static
+ </XDSText>
+ </XDSCard>
+ </XDSStackItem>
+ </XDSHStack>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs b/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs
new file mode 100644
index 0000000000..504dc11327
--- /dev/null
+++ b/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'Tab',
+ description:
+ 'Tab is an individual tab item within a TabList, supporting labels, icons, selected icons, and end content slots.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['TabList', 'Tab'],
+};
diff --git a/packages/cli/templates/blocks/components/Tab/TabShowcase.tsx b/packages/cli/templates/blocks/components/Tab/TabShowcase.tsx
new file mode 100644
index 0000000000..d4a8c03102
--- /dev/null
+++ b/packages/cli/templates/blocks/components/Tab/TabShowcase.tsx
@@ -0,0 +1,16 @@
+'use client';
+
+import {XDSTabList, XDSTab} from '@xds/core/TabList';
+import {XDSBadge} from '@xds/core/Badge';
+
+export default function TabShowcase() {
+ return (
+ <XDSTabList value="inbox" onChange={() => {}}>
+ <XDSTab
+ value="inbox"
+ label="Inbox"
+ endContent={<XDSBadge label="3" variant="info" />}
+ />
+ </XDSTabList>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs
new file mode 100644
index 0000000000..e9229edbb6
--- /dev/null
+++ b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'TabMenu',
+ description:
+ 'TabMenu is an overflow menu within a TabList that groups additional tab options into a dropdown, showing the selected option\'s label as the trigger text.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['TabList', 'Tab', 'TabMenu'],
+};
diff --git a/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.tsx b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.tsx
new file mode 100644
index 0000000000..695cfea137
--- /dev/null
+++ b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.tsx
@@ -0,0 +1,20 @@
+'use client';
+
+import {XDSTabList, XDSTab, XDSTabMenu} from '@xds/core/TabList';
+
+export default function TabMenuShowcase() {
+ return (
+ <XDSTabList value="settings" onChange={() => {}}>
+ <XDSTab value="overview" label="Overview" />
+ <XDSTab value="activity" label="Activity" />
+ <XDSTabMenu
+ label="More"
+ options={[
+ {value: 'settings', label: 'Settings'},
+ {value: 'integrations', label: 'Integrations'},
+ {value: 'billing', label: 'Billing'},
+ ]}
+ />
+ </XDSTabList>
+ );
+}
diff --git a/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs
new file mode 100644
index 0000000000..61e5836b4d
--- /dev/null
+++ b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs
@@ -0,0 +1,11 @@
+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'block',
+ name: 'ToggleButtonGroup',
+ description:
+ 'ToggleButtonGroup manages a set of ToggleButtons with single-select or multi-select behavior for options like view modes or filters.',
+ isReady: true,
+ isShowcase: true,
+ aspectRatio: 16 / 9,
+ componentsUsed: ['ToggleButton', 'ToggleButtonGroup'],
+};
diff --git a/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.tsx b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.tsx
new file mode 100644
index 0000000000..f74112cb2f
--- /dev/null
+++ b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.tsx
@@ -0,0 +1,43 @@
+'use client';
+
+import {useState} from 'react';
+import {
+ XDSToggleButton,
+ XDSToggleButtonGroup,
+} from '@xds/core/ToggleButton';
+import {XDSVStack} from '@xds/core/Layout';
+import {XDSText} from '@xds/core/Text';
+
+export default function ToggleButtonGroupShowcase() {
+ const [view, setView] = useState<string | null>('grid');
+ const [filters, setFilters] = useState<string[]>(['active']);
+
+ return (
+ <XDSVStack gap={4}>
+ <XDSVStack gap={1}>
+ <XDSText type="label" color="secondary">
+ Single select
+ </XDSText>
+ <XDSToggleButtonGroup value={view} onChange={setView} label="View mode">
+ <XDSToggleButton value="list" label="List" />
+ <XDSToggleButton value="grid" label="Grid" />
+ <XDSToggleButton value="board" label="Board" />
+ </XDSToggleButtonGroup>
+ </XDSVStack>
+ <XDSVStack gap={1}>
+ <XDSText type="label" color="secondary">
+ Multi select
+ </XDSText>
+ <XDSToggleButtonGroup
+ type="multiple"
+ value={filters}
+ onChange={setFilters}
+ label="Status filters">
+ <XDSToggleButton value="active" label="Active" />
+ <XDSToggleButton value="pending" label="Pending" />
+ <XDSToggleButton value="closed" label="Closed" />
+ </XDSToggleButtonGroup>
+ </XDSVStack>
+ </XDSVStack>
+ );
+}