Skip to content

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

TypeScript

fix (sandbox) Block example styling fixes (#2057)

Kenton Quatman05f4faadaadc
diff --git a/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.tsx b/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.tsx
index 7fdf2be9ac..bf723ace8b 100644
--- a/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.tsx
+++ b/packages/cli/templates/blocks/components/Code/CodeInlineInParagraph.tsx
@@ -2,10 +2,17 @@
import {XDSCode} from '@xds/core/CodeBlock';
import {XDSText} from '@xds/core/Text';
+import * as stylex from '@stylexjs/stylex';
+
+const styles = stylex.create({
+ root: {
+ maxWidth: 400,
+ },
+});
export default function CodeInlineInParagraph() {
return (
- <XDSText type="body">
+ <XDSText type="body" xstyle={styles.root}>
Use <XDSCode>useState</XDSCode> for local state and{' '}
<XDSCode>useEffect</XDSCode> for side effects. If you need shared state
across components, consider <XDSCode>useContext</XDSCode> or a state
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.tsx b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.tsx
index 285389d9b0..8c25899617 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.tsx
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockBashCommand.tsx
@@ -5,16 +5,18 @@ import {XDSVStack} from '@xds/core/Stack';
export default function CodeBlockBashCommand() {
return (
- <XDSVStack gap={4}>
+ <XDSVStack gap={4} style={{width: '100%', maxWidth: 400}}>
<XDSCodeBlock
- code="npm install @xds/core @stylexjs/stylex"
+ code="npm install @xds/core"
language="bash"
hasCopyButton
+ style={{width: '100%'}}
/>
<XDSCodeBlock
- code={`curl -s https://api.example.com/status | jq '.services[] | select(.healthy == false)'`}
+ code="yarn add @stylexjs/stylex"
language="bash"
hasCopyButton
+ style={{width: '100%'}}
/>
</XDSVStack>
);
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs
index 3017a1b2a5..b2f0f7c924 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.doc.mjs
@@ -6,6 +6,6 @@ export const doc = {
description:
'TypeScript code with specific lines highlighted to draw attention to a key section. Use highlightLines to call out new or important code in tutorials and changelogs.',
isReady: true,
- aspectRatio: 16 / 9,
+ aspectRatio: 4 / 3,
componentsUsed: ['CodeBlock'],
};
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.tsx b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.tsx
index 74f9e0f9aa..5c3e76d424 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.tsx
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockHighlightedLines.tsx
@@ -2,29 +2,16 @@
import {XDSCodeBlock} from '@xds/core/CodeBlock';
-const code = `import {useState, useEffect} from 'react';
-
-interface User {
+const code = `interface User {
id: string;
name: string;
- email: string;
-}
-
-async function fetchUser(id: string): Promise<User> {
- const response = await fetch(\`/api/users/\${id}\`);
- if (!response.ok) {
- throw new Error(\`HTTP \${response.status}\`);
- }
- return response.json();
}
export function useUser(id: string) {
- const [user, setUser] = useState<User | null>(null);
-
+ const [user, setUser] = useState<User>();
useEffect(() => {
fetchUser(id).then(setUser);
}, [id]);
-
return user;
}`;
@@ -35,7 +22,7 @@ export default function CodeBlockHighlightedLines() {
language="typescript"
title="useUser.ts"
hasLineNumbers
- highlightLines={[9, 10, 11, 12, 13]}
+ highlightLines={[8, 9, 10]}
/>
);
}
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs
index b35bf67ba3..bec809e1fe 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.doc.mjs
@@ -6,6 +6,6 @@ export const doc = {
description:
'A long code block with a max height that enables vertical scrolling. Use maxHeight to keep the block from dominating the page when displaying large files.',
isReady: true,
- aspectRatio: 16 / 9,
+ aspectRatio: 4 / 3,
componentsUsed: ['CodeBlock'],
};
diff --git a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.tsx b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.tsx
index 0818be020f..cec35484ed 100644
--- a/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.tsx
+++ b/packages/cli/templates/blocks/components/CodeBlock/CodeBlockScrollableBlock.tsx
@@ -14,7 +14,7 @@ export default function CodeBlockScrollableBlock() {
language="typescript"
title="many-lines.ts"
hasLineNumbers
- maxHeight="100%"
+ maxHeight={280}
/>
);
}
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs b/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs
index 026dad819d..6eeafa6a91 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.doc.mjs
@@ -5,6 +5,6 @@ export const doc = {
name: 'Collapsible — Controlled',
description: 'Manage the open section from parent state. Use when the open state needs to sync with a URL param, form, or external control.',
isReady: true,
- aspectRatio: 4 / 3,
+ aspectRatio: 16 / 9,
componentsUsed: ['Collapsible', 'Card', 'Text', 'Layout'],
};
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.tsx b/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.tsx
index d2272bc216..ac626f4eb8 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.tsx
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleControlledAccordion.tsx
@@ -10,7 +10,7 @@ export default function CollapsibleControlledAccordion() {
const [open, setOpen] = useState<string | string[]>('profile');
return (
<XDSCollapsibleGroup type="single" value={open} onChange={setOpen}>
- <XDSVStack gap={2}>
+ <XDSVStack gap={2} style={{width: '100%', maxWidth: 400}}>
<XDSCard>
<XDSCollapsible trigger="Profile Information" value="profile">
<XDSText type="body">
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.tsx b/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.tsx
index 5e933b03ce..d3d753a515 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.tsx
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleMultipleAccordion.tsx
@@ -8,7 +8,7 @@ import {XDSVStack} from '@xds/core/Layout';
export default function CollapsibleMultipleAccordion() {
return (
<XDSCollapsibleGroup type="multiple" defaultValue={['features', 'pricing']}>
- <XDSVStack gap={2}>
+ <XDSVStack gap={2} style={{width: '100%', maxWidth: 400}}>
<XDSCard>
<XDSCollapsible trigger="Features" value="features">
<XDSText type="body">
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.tsx b/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.tsx
index 8360f19e47..7ce4f8e997 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.tsx
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleShowcase.tsx
@@ -9,7 +9,7 @@ export default function CollapsibleShowcase() {
return (
<XDSCard width={400}>
<XDSCollapsibleGroup type="single" defaultValue="notifications">
- <XDSVStack gap={2}>
+ <XDSVStack gap={6}>
<XDSCollapsible trigger="General settings" value="general">
<XDSText type="body" color="secondary">
Configure your display name, language, and time zone preferences.
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.tsx b/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.tsx
index e63cff8ae7..d87006f2eb 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.tsx
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleSingleAccordion.tsx
@@ -8,7 +8,7 @@ import {XDSVStack} from '@xds/core/Layout';
export default function CollapsibleSingleAccordion() {
return (
<XDSCollapsibleGroup type="single" defaultValue="general">
- <XDSVStack gap={2}>
+ <XDSVStack gap={2} style={{width: '100%', maxWidth: 400}}>
<XDSSection>
<XDSCollapsible trigger="General Settings" value="general">
<XDSText type="body">
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs b/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs
index bc6227c074..3ede1352ed 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.doc.mjs
@@ -5,6 +5,6 @@ export const doc = {
name: 'Collapsible — With Dividers',
description: 'Collapsible sections separated by dividers instead of cards. Use for inline disclosure in detail panels or sidebar content where cards would add too much weight.',
isReady: true,
- aspectRatio: 4 / 3,
+ aspectRatio: 16 / 9,
componentsUsed: ['Collapsible', 'Divider', 'Text', 'Layout'],
};
diff --git a/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.tsx b/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.tsx
index bce0494900..6bb66a8d6f 100644
--- a/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.tsx
+++ b/packages/cli/templates/blocks/components/Collapsible/CollapsibleWithoutCard.tsx
@@ -7,7 +7,7 @@ import {XDSVStack} from '@xds/core/Layout';
export default function CollapsibleWithoutCard() {
return (
- <XDSVStack gap={3}>
+ <XDSVStack gap={3} style={{width: '100%', maxWidth: 400}}>
<XDSCollapsible trigger="Deployment Details">
<XDSText type="body">
Last deployed on April 18, 2026 at 3:42 PM by Sarah Chen. Build
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputClearable.tsx b/packages/cli/templates/blocks/components/DateInput/DateInputClearable.tsx
index ef0d619118..6e1c06aef9 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputClearable.tsx
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputClearable.tsx
@@ -14,7 +14,7 @@ export default function DateInputClearable() {
);
return (
- <XDSStack direction="vertical" gap={4}>
+ <XDSStack direction="vertical" gap={4} width="100%" style={{maxWidth: 400}}>
<XDSText type="supporting" color="secondary">
{value ? `Selected: ${value}` : 'No date selected'}
</XDSText>
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.tsx b/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.tsx
index 9e46a05410..82bf3dee53 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.tsx
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputDateRange.tsx
@@ -8,19 +8,32 @@ import {XDSText} from '@xds/core/Text';
type DateString =
`${number}${number}${number}${number}-${number}${number}-${number}${number}`;
+const pad = (n: number) => String(n).padStart(2, '0');
+const today = new Date();
+const year = today.getFullYear();
+const month = today.getMonth();
+const startDay = 8;
+const endDay = 21;
+const min = `${year}-${pad(month + 1)}-${pad(startDay)}` as DateString;
+const max = `${year}-${pad(month + 1)}-${pad(endDay)}` as DateString;
+const monthName = new Date(year, month, 1).toLocaleString('en-US', {
+ month: 'short',
+});
+const description = `Available dates: ${monthName} ${startDay} – ${endDay}, ${year}`;
+
export default function DateInputDateRange() {
const [value, setValue] = useState<DateString | undefined>(undefined);
return (
- <XDSStack direction="vertical" gap={4}>
+ <XDSStack direction="vertical" gap={4} width="100%" style={{maxWidth: 400}}>
<XDSText type="supporting" color="secondary">
{value ? `Booked: ${value}` : 'Pick a date in the available range'}
</XDSText>
<XDSDateInput
label="Booking date"
- min="2026-01-15"
- max="2026-02-15"
- description="Available dates: Jan 15 – Feb 15, 2026"
+ min={min}
+ max={max}
+ description={description}
placeholder="Select a booking date"
value={value}
onChange={setValue}
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.tsx b/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.tsx
index b8099dccc3..87743fe356 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.tsx
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputShowcase.tsx
@@ -3,22 +3,15 @@
import {useState} from 'react';
import {XDSDateInput} from '@xds/core/DateInput';
import {XDSStack} from '@xds/core/Layout';
-import * as stylex from '@stylexjs/stylex';
type DateString =
`${number}${number}${number}${number}-${number}${number}-${number}${number}`;
-const styles = stylex.create({
- root: {
- width: 320,
- },
-});
-
export default function DateInputShowcase() {
const [date, setDate] = useState<DateString | undefined>(undefined);
return (
- <XDSStack direction="vertical" xstyle={styles.root}>
+ <XDSStack direction="vertical" width="100%" style={{maxWidth: 400}}>
<XDSDateInput
label="Start date"
placeholder="Select a date"
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.tsx b/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.tsx
index c6c1f13ddd..ca6c915264 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.tsx
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputWithDescription.tsx
@@ -12,7 +12,7 @@ export default function DateInputWithDescription() {
const [value, setValue] = useState<DateString | undefined>(undefined);
return (
- <XDSStack direction="vertical" gap={4}>
+ <XDSStack direction="vertical" gap={4} width="100%" style={{maxWidth: 400}}>
<XDSText type="supporting" color="secondary">
Helper text explains what the field expects
</XDSText>
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs b/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs
index 33e25542dd..3443a3ad64 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.doc.mjs
@@ -6,6 +6,6 @@ export const doc = {
description:
'Date input in all three status states: error, warning, and success. Use to surface validation issues, caution the user, or confirm a valid selection.',
isReady: true,
- aspectRatio: 16 / 9,
+ aspectRatio: 4 / 3,
componentsUsed: ['DateInput', 'Layout', 'Text'],
};
diff --git a/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.tsx b/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.tsx
index 947cf596ab..aa7997970d 100644
--- a/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.tsx
+++ b/packages/cli/templates/blocks/components/DateInput/DateInputWithValidation.tsx
@@ -19,7 +19,7 @@ export default function DateInputWithValidation() {
);
return (
- <XDSStack direction="vertical" gap={4}>
+ <XDSStack direction="vertical" gap={4} width="100%" style={{maxWidth: 400}}>
<XDSDateInput
label="Event date"
value={errorVal}
diff --git a/packages/cli/templates/blocks/components/Divider/DividerFullBleed.tsx b/packages/cli/templates/blocks/components/Divider/DividerFullBleed.tsx
index d5fe8b12bc..686c328e49 100644
--- a/packages/cli/templates/blocks/components/Divider/DividerFullBleed.tsx
+++ b/packages/cli/templates/blocks/components/Divider/DividerFullBleed.tsx
@@ -8,7 +8,7 @@ import {XDSText} from '@xds/core/Text';
export default function DividerFullBleed() {
return (
- <XDSSection variant="wash">
+ <XDSSection width="100%">
<XDSCard>
<XDSVStack gap={3}>
<XDSText type="label">Order Summary</XDSText>
diff --git a/packages/cli/templates/blocks/components/Divider/DividerVariants.tsx b/packages/cli/templates/blocks/components/Divider/DividerVariants.tsx
index 5148872bb8..40b11df3c7 100644
--- a/packages/cli/templates/blocks/components/Divider/DividerVariants.tsx
+++ b/packages/cli/templates/blocks/components/Divider/DividerVariants.tsx
@@ -8,7 +8,7 @@ import {XDSText} from '@xds/core/Text';
export default function DividerVariants() {
return (
- <XDSSection variant="wash">
+ <XDSSection width="100%">
<XDSCard>
<XDSVStack gap={3}>
<XDSVStack gap={1}>
diff --git a/packages/cli/templates/blocks/components/Divider/DividerVertical.tsx b/packages/cli/templates/blocks/components/Divider/DividerVertical.tsx
index c2b072c798..9c68e9a073 100644
--- a/packages/cli/templates/blocks/components/Divider/DividerVertical.tsx
+++ b/packages/cli/templates/blocks/components/Divider/DividerVertical.tsx
@@ -1,39 +1,53 @@
'use client';
+import * as stylex from '@stylexjs/stylex';
import {XDSDivider} from '@xds/core/Divider';
import {XDSCard} from '@xds/core/Card';
import {XDSSection} from '@xds/core/Section';
-import {XDSHStack, XDSVStack} from '@xds/core/Layout';
+import {XDSHStack, XDSVStack, XDSStackItem} from '@xds/core/Layout';
import {XDSText} from '@xds/core/Text';
+const styles = stylex.create({
+ dividerFill: {
+ alignSelf: 'stretch',
+ height: 'auto',
+ },
+});
+
export default function DividerVertical() {
return (
- <XDSSection variant="wash">
+ <XDSSection width="100%">
<XDSCard>
- <XDSHStack gap={4}>
- <XDSVStack gap={1}>
- <XDSText type="label">Revenue</XDSText>
- <XDSText type="label">$24,500</XDSText>
- <XDSText type="supporting" color="secondary">
- +12% vs last month
- </XDSText>
- </XDSVStack>
- <XDSDivider orientation="vertical" />
- <XDSVStack gap={1}>
- <XDSText type="label">Users</XDSText>
- <XDSText type="label">1,240</XDSText>
- <XDSText type="supporting" color="secondary">
- +8% vs last month
- </XDSText>
- </XDSVStack>
- <XDSDivider orientation="vertical" />
- <XDSVStack gap={1}>
- <XDSText type="label">Conversion</XDSText>
- <XDSText type="label">3.2%</XDSText>
- <XDSText type="supporting" color="secondary">
- -0.5% vs last month
- </XDSText>
- </XDSVStack>
+ <XDSHStack gap={4} align="stretch">
+ <XDSStackItem size="fill">
+ <XDSVStack gap={1}>
+ <XDSText type="label">Revenue</XDSText>
+ <XDSText type="label">$24,500</XDSText>
+ <XDSText type="supporting" color="secondary">
+ +12% vs last month
+ </XDSText>
+ </XDSVStack>
+ </XDSStackItem>
+ <XDSDivider orientation="vertical" xstyle={styles.dividerFill} />
+ <XDSStackItem size="fill">
+ <XDSVStack gap={1}>
+ <XDSText type="label">Users</XDSText>
+ <XDSText type="label">1,240</XDSText>
+ <XDSText type="supporting" color="secondary">
+ +8% vs last month
+ </XDSText>
+ </XDSVStack>
+ </XDSStackItem>
+ <XDSDivider orientation="vertical" xstyle={styles.dividerFill} />
+ <XDSStackItem size="fill">
+ <XDSVStack gap={1}>
+ <XDSText type="label">Conversion</XDSText>
+ <XDSText type="label">3.2%</XDSText>
+ <XDSText type="supporting" color="secondary">
+ -0.5% vs last month
+ </XDSText>
+ </XDSVStack>
+ </XDSStackItem>
</XDSHStack>
</XDSCard>
</XDSSection>
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs
index 4d6b2d21f0..dd5e47b519 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.doc.mjs
@@ -5,6 +5,6 @@ export const doc = {
name: 'FormLayout — Horizontal',
description: 'Two fields side by side for naturally paired inputs like first and last name',
isReady: true,
- aspectRatio: 4 / 3,
+ aspectRatio: 16 / 9,
componentsUsed: ['FormLayout', 'TextInput'],
};
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.tsx b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.tsx
index be9b36d89f..42e0e4944e 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.tsx
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutHorizontal.tsx
@@ -1,15 +1,20 @@
'use client';
import {useState} from 'react';
+import * as stylex from '@stylexjs/stylex';
import {XDSFormLayout} from '@xds/core/FormLayout';
import {XDSTextInput} from '@xds/core/TextInput';
+const styles = stylex.create({
+ layout: {width: '100%', maxWidth: 400},
+});
+
export default function FormLayoutHorizontal() {
const [first, setFirst] = useState('Jordan');
const [last, setLast] = useState('Rivera');
return (
- <XDSFormLayout direction="horizontal">
+ <XDSFormLayout direction="horizontal" xstyle={styles.layout}>
<XDSTextInput label="First Name" value={first} onChange={setFirst} />
<XDSTextInput label="Last Name" value={last} onChange={setLast} />
</XDSFormLayout>
diff --git a/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.tsx b/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.tsx
index 02a022dac7..c8815a1ee9 100644
--- a/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.tsx
+++ b/packages/cli/templates/blocks/components/FormLayout/FormLayoutShowcase.tsx
@@ -1,14 +1,29 @@
'use client';
+import {useState} from 'react';
import {XDSFormLayout} from '@xds/core/FormLayout';
import {XDSTextInput} from '@xds/core/TextInput';
export default function FormLayoutShowcase() {
+ const [first, setFirst] = useState('Priya');
+ const [last, setLast] = useState('Sharma');
+ const [email, setEmail] = useState('[email protected]');
+ const [city, setCity] = useState('San Francisco');
+ const [state, setState] = useState('CA');
+ const [zip, setZip] = useState('94105');
+
return (
<XDSFormLayout>
- <XDSTextInput label="Name" value="" onChange={() => {}} />
- <XDSTextInput label="Email" value="" onChange={() => {}} />
- <XDSTextInput label="Bio" value="" onChange={() => {}} />
+ <XDSFormLayout direction="horizontal">
+ <XDSTextInput label="First Name" value={first} onChange={setFirst} />
+ <XDSTextInput label="Last Name" value={last} onChange={setLast} />
+ </XDSFormLayout>
+ <XDSTextInput label="Email" value={email} onChange={setEmail} />
+ <XDSFormLayout direction="horizontal">
+ <XDSTextInput label="City" value={city} onChange={setCity} />
+ <XDSTextInput label="State" value={state} onChange={setState} />
+ <XDSTextInput label="ZIP" value={zip} onChange={setZip} />
+ </XDSFormLayout>
</XDSFormLayout>
);
}
diff --git a/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.tsx b/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.tsx
index 08507ba506..4c465458ac 100644
--- a/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.tsx
+++ b/packages/cli/templates/blocks/components/Grid/GridDashboardLayout.tsx
@@ -13,7 +13,7 @@ const metrics = [
export default function GridDashboardLayout() {
return (
- <XDSGrid columns={4} gap={4}>
+ <XDSGrid columns={4} gap={4} width="100%" style={{maxWidth: 500}}>
<XDSGridSpan columns={2} rows={2}>
<XDSCard>
<XDSText type="label" display="block">
diff --git a/packages/cli/templates/blocks/components/Grid/GridGalleryExample.tsx b/packages/cli/templates/blocks/components/Grid/GridGalleryExample.tsx
index 9180ab5c3c..1f02f7a435 100644
--- a/packages/cli/templates/blocks/components/Grid/GridGalleryExample.tsx
+++ b/packages/cli/templates/blocks/components/Grid/GridGalleryExample.tsx
@@ -12,13 +12,15 @@ const cards = [
{title: 'Theming', description: 'Customize the look and feel.'},
{title: 'Accessibility', description: 'Build inclusive experiences.'},
{title: 'Patterns', description: 'Common UI composition patterns.'},
- {title: 'Migration Guide', description: 'Upgrading from previous versions.'},
- {title: 'API Reference', description: 'Detailed prop and hook docs.'},
];
export default function GridGalleryExample() {
return (
- <XDSGrid columns={{minWidth: 280}} gap={5}>
+ <XDSGrid
+ columns={{minWidth: 180}}
+ gap={5}
+ width="100%"
+ style={{maxWidth: 400}}>
{cards.map(card => (
<XDSCard key={card.title}>
<XDSVStack gap={1}>
diff --git a/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs b/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs
index 44696854ef..7a5489ff4f 100644
--- a/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs
+++ b/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.doc.mjs
@@ -5,6 +5,6 @@ export const doc = {
name: 'Grid — Responsive Auto-Fit',
description: 'Responsive grid where cards stretch to fill remaining space',
isReady: true,
- aspectRatio: 3 / 4,
- componentsUsed: ['Grid', 'Card', 'VStack', 'Text'],
+ aspectRatio: 4 / 3,
+ componentsUsed: ['Grid', 'Card', 'Layout', 'Resizable', 'VStack', 'Text'],
};
diff --git a/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.tsx b/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.tsx
index 527fe6222e..6d55a1afcd 100644
--- a/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.tsx
+++ b/packages/cli/templates/blocks/components/Grid/GridResponsiveAutoFit.tsx
@@ -1,9 +1,19 @@
'use client';
+import {spacingVars} from '@xds/core/theme/tokens.stylex';
import {XDSGrid} from '@xds/core/Grid';
import {XDSCard} from '@xds/core/Card';
+import {XDSLayout, XDSLayoutContent, XDSLayoutPanel} from '@xds/core/Layout';
+import {useXDSResizable, XDSResizeHandle} from '@xds/core/Resizable';
import {XDSVStack} from '@xds/core/Stack';
import {XDSText} from '@xds/core/Text';
+import * as stylex from '@stylexjs/stylex';
+
+const styles = stylex.create({
+ panel: {
+ padding: spacingVars['--spacing-4'],
+ },
+});
const teams = [
{name: 'Design Systems', members: 8},
@@ -15,20 +25,56 @@ const teams = [
];
export default function GridResponsiveAutoFit() {
+ const gridPanel = useXDSResizable({
+ defaultSize: 480,
+ minSizePx: 100,
+ maxSizePx: 480,
+ });
+
return (
- <XDSGrid columns={{minWidth: 200, repeat: 'fit'}} gap={4}>
- {teams.map(team => (
- <XDSCard key={team.name}>
- <XDSVStack gap={1}>
- <XDSText type="label" display="block">
- {team.name}
- </XDSText>
- <XDSText type="supporting" display="block">
- {team.members} members
- </XDSText>
- </XDSVStack>
- </XDSCard>
- ))}
- </XDSGrid>
+ <XDSCard
+ variant="muted"
+ padding={0}
+ height={400}
+ width="100%"
+ style={{maxWidth: 500}}>
+ <XDSLayout
+ height="fill"
+ start={
+ <>
+ <XDSLayoutPanel
+ width={gridPanel.size}
+ hasDivider={false}
+ xstyle={styles.panel}>
+ <XDSGrid
+ columns={{minWidth: 180, repeat: 'fit'}}
+ gap={4}
+ width="100%">
+ {teams.map(team => (
+ <XDSCard key={team.name}>
+ <XDSVStack gap={1}>
+ <XDSText type="label" display="block">
+ {team.name}
+ </XDSText>
+ <XDSText type="supporting" display="block">
+ {team.members} members
+ </XDSText>
+ </XDSVStack>
+ </XDSCard>
+ ))}
+ </XDSGrid>
+ </XDSLayoutPanel>
+ <XDSResizeHandle
+ direction="horizontal"
+ hasDivider
+ isAlwaysVisible
+ resizable={gridPanel.props}
+ label="Resize grid"
+ />
+ </>
+ }
+ content={<XDSLayoutContent />}
+ />
+ </XDSCard>
);
}
diff --git a/packages/cli/templates/blocks/components/Grid/GridShowcase.tsx b/packages/cli/templates/blocks/components/Grid/GridShowcase.tsx
index 5ebfd1be7c..49ad97323e 100644
--- a/packages/cli/templates/blocks/components/Grid/GridShowcase.tsx
+++ b/packages/cli/templates/blocks/components/Grid/GridShowcase.tsx
@@ -1,21 +1,13 @@
'use client';
+import {XDSCard} from '@xds/core/Card';
import {XDSGrid} from '@xds/core/Grid';
export default function GridShowcase() {
return (
- <XDSGrid columns={3} gap={4}>
- {Array.from({length: 6}, (_, i) => (
- <div
- key={i}
- style={{
- padding: 16,
- backgroundColor: 'var(--color-background-body)',
- borderRadius: 'var(--radius-element, 8px)',
- textAlign: 'center',
- }}>
- Item {i + 1}
- </div>
+ <XDSGrid columns={3} gap={2} width={400}>
+ {Array.from({length: 12}, (_, i) => (
+ <XDSCard key={i}>Item {i + 1}</XDSCard>
))}
</XDSGrid>
);
diff --git a/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs b/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs
index eac6925685..cc8d97b9ce 100644
--- a/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs
+++ b/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.doc.mjs
@@ -3,7 +3,7 @@ export const doc = {
type: 'block',
exampleFor: 'Grid',
name: 'Grid — Column Spanning',
- description: 'Grid with featured items spanning two, three, and all columns',
+ description: 'Grid with featured items spanning multiple columns and rows',
isReady: true,
aspectRatio: 4 / 3,
componentsUsed: ['Grid', 'GridSpan', 'Card', 'VStack', 'Text'],
diff --git a/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.tsx b/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.tsx
index 618b70548a..3a72cd11cd 100644
--- a/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.tsx
+++ b/packages/cli/templates/blocks/components/Grid/GridWithGridSpan.tsx
@@ -7,15 +7,16 @@ import {XDSText} from '@xds/core/Text';
export default function GridWithGridSpan() {
return (
- <XDSGrid columns={4} gap={4}>
- <XDSGridSpan columns={2}>
+ <XDSGrid columns={3} gap={4} width="100%" style={{maxWidth: 500}}>
+ <XDSGridSpan rows={2}>
<XDSCard variant="cyan">
<XDSVStack gap={1}>
<XDSText type="label" display="block">
Featured Release
</XDSText>
<XDSText type="supporting" display="block">
- XDS 4.0 is now available with new layout primitives
+ XDS 4.0 is now available with new layout primitives, refreshed
+ tokens, and improved theming support across the system.
</XDSText>
</XDSVStack>
</XDSCard>
@@ -44,18 +45,38 @@ export default function GridWithGridSpan() {
120 defined
</XDSText>
</XDSCard>
- <XDSGridSpan columns={3}>
- <XDSCard variant="cyan">
- <XDSVStack gap={1}>
- <XDSText type="label" display="block">
- Migration Guide
- </XDSText>
- <XDSText type="supporting" display="block">
- Step-by-step instructions for upgrading from v3 to v4
- </XDSText>
- </XDSVStack>
- </XDSCard>
- </XDSGridSpan>
+ <XDSCard>
+ <XDSText type="label" display="block">
+ Themes
+ </XDSText>
+ <XDSText type="supporting" display="block">
+ 6 published
+ </XDSText>
+ </XDSCard>
+ <XDSCard>
+ <XDSText type="label" display="block">
+ Icons
+ </XDSText>
+ <XDSText type="supporting" display="block">
+ 312 available
+ </XDSText>
+ </XDSCard>
+ <XDSCard>
+ <XDSText type="label" display="block">
+ Patterns
+ </XDSText>
+ <XDSText type="supporting" display="block">
+ 18 documented
+ </XDSText>
+ </XDSCard>
+ <XDSCard>
+ <XDSText type="label" display="block">
+ Contributors
+ </XDSText>
+ <XDSText type="supporting" display="block">
+ 42 active
+ </XDSText>
+ </XDSCard>
<XDSGridSpan columns="full">
<XDSCard variant="cyan">
<XDSVStack gap={1}>