An open source design system that's fully customizable and agent ready
TypeScript
fix(docsite): Blog styling fixes (#2993)
Kenton Quatman109074bbb365
diff --git a/apps/docsite/src/app/(docs)/components/page.tsx b/apps/docsite/src/app/(docs)/components/page.tsxindex 8adb13471a..90b66d3c63 100644--- a/apps/docsite/src/app/(docs)/components/page.tsx+++ b/apps/docsite/src/app/(docs)/components/page.tsx@@ -134,7 +134,7 @@ export default function ComponentsGalleryPage() {<VStack gap={10}><VStack gap={4} hAlign="center"><VStack gap={2} style={{alignItems: 'center'}}>- <Text type="display-2" xstyle={styles.heroTitle}>+ <Text type="display-1" xstyle={styles.heroTitle}>Browse the library</Text><Text type="body" color="secondary" xstyle={styles.heroTitle}>@@ -172,11 +172,7 @@ export default function ComponentsGalleryPage() {</VStack></VStack>}>- <Button- variant="primary"- size="lg"- label="Install core library"- />+ <Button variant="primary" size="lg" label="Install core library" /></Popover></VStack>diff --git a/apps/docsite/src/app/(site)/community/page.tsx b/apps/docsite/src/app/(site)/community/page.tsxindex a1bf59bfa9..415501fd9a 100644--- a/apps/docsite/src/app/(site)/community/page.tsx+++ b/apps/docsite/src/app/(site)/community/page.tsx@@ -85,11 +85,6 @@ const styles = stylex.create({maxWidth: 1200,width: '100%',marginInline: 'auto',- // Add the same section gap as bottom padding so the- // Resources → footer break feels like another section gap- // (96px) rather than abruptly hitting the footer with only- // the Section's 24px padding underneath.- paddingBlockEnd: 'calc(var(--spacing-12) * 2)',},// Hero group — wraps the "Build with us" hero row + the wall// card below it as one unit inside the section stack. Tightdiff --git a/apps/docsite/src/app/(site)/templates/page.tsx b/apps/docsite/src/app/(site)/templates/page.tsxindex 99694e7d0b..7cbef6c4d8 100644--- a/apps/docsite/src/app/(site)/templates/page.tsx+++ b/apps/docsite/src/app/(site)/templates/page.tsx@@ -203,7 +203,7 @@ export default function TemplatesPage() {{/* Header */}<VStack gap={6} align="stretch"><VStack gap={2}>- <Heading level={1} type="display-2" justify="center">+ <Heading level={1} type="display-1" justify="center">Templates</Heading><Text type="body" color="secondary" justify="center">@@ -216,20 +216,13 @@ export default function TemplatesPage() {onChange={value => setActiveCategory(value ?? 'All')}xstyle={styles.categoryFilter}>{categories.map(category => (- <ToggleButton- key={category}- label={category}- value={category}- />+ <ToggleButton key={category} label={category} value={category} />))}</ToggleButtonGroup></VStack>{/* Body */}- <Grid- columns={{minWidth: isMobile ? 280 : 420}}- gap={4}- width="100%">+ <Grid columns={{minWidth: isMobile ? 280 : 420}} gap={4} width="100%">{filteredItems.map(item => {const templateContent = <TemplateThumbnail slug={item.slug} />;diff --git a/apps/docsite/src/components/ChangelogView.tsx b/apps/docsite/src/components/ChangelogView.tsxindex a3ec8880ac..37587cb05d 100644--- a/apps/docsite/src/components/ChangelogView.tsx+++ b/apps/docsite/src/components/ChangelogView.tsx@@ -10,7 +10,6 @@ import {VStack} from '@xds/core/Layout';import {Section} from '@xds/core/Section';import {TabList, Tab} from '@xds/core/TabList';import {Carousel} from '@xds/core/Carousel';-import {spacingVars} from '@xds/core/theme/tokens.stylex';import {GITHUB_REPO} from '../constants';function linkifyPRs(markdown: string): string {@@ -61,7 +60,6 @@ interface ChangelogViewProps {const styles = stylex.create({section: {marginInline: 'auto',- paddingBottom: `calc(${spacingVars['--spacing-12']} * 2)`,},});diff --git a/apps/docsite/src/components/SiteFooter.tsx b/apps/docsite/src/components/SiteFooter.tsxindex 4c328e4113..11c3d05539 100644--- a/apps/docsite/src/components/SiteFooter.tsx+++ b/apps/docsite/src/components/SiteFooter.tsx@@ -21,10 +21,10 @@ import {} from './logos';const styles = stylex.create({- mobileFooterLinks: {- maxWidth: 320,+ siteFooter: {+ paddingTop: 'calc(var(--spacing-12) * 2)',},- logo: {+ astryxLogo: {height: 18,width: 'auto',display: 'block',@@ -41,6 +41,9 @@ const styles = stylex.create({display: 'block',color: 'var(--color-icon-secondary)',},+ mobileFooterLinks: {+ maxWidth: 320,+ },});const FOOTER_LINKS: ReadonlyArray<{@@ -139,7 +142,11 @@ export function SiteFooter() {const copyright = `\u00A9${year} Meta Platforms, Inc.`;const astryxLogo = (- <AstryxLogo role="img" aria-label="Astryx" {...stylex.props(styles.logo)} />+ <AstryxLogo+ role="img"+ aria-label="Astryx"+ {...stylex.props(styles.astryxLogo)}+ />);const metaOpenSourceLink = (@@ -158,7 +165,7 @@ export function SiteFooter() {// On narrow viewports the horizontal rows can't fit side by side, so we// stack the three regions vertically and let the link lists wrap.return (- <Section role="contentinfo" padding={6}>+ <Section role="contentinfo" padding={6} xstyle={styles.siteFooter}><VStack gap={6}><VStack gap={6} hAlign="center">{astryxLogo}@@ -192,7 +199,7 @@ export function SiteFooter() {}return (- <Section role="contentinfo" padding={6}>+ <Section role="contentinfo" padding={6} xstyle={styles.siteFooter}><VStack gap={4}><Grid columns={5} align="center">{astryxLogo}diff --git a/apps/docsite/src/components/blog/AuthorByline.tsx b/apps/docsite/src/components/blog/AuthorByline.tsxindex 717add75b7..ec5360cf4c 100644--- a/apps/docsite/src/components/blog/AuthorByline.tsx+++ b/apps/docsite/src/components/blog/AuthorByline.tsx@@ -13,9 +13,10 @@*/import * as stylex from '@stylexjs/stylex';-import {XDSAvatar} from '@xds/core/Avatar';-import {XDSText} from '@xds/core/Text';-import {XDSHStack} from '@xds/core/Layout';+import {Avatar} from '@xds/core/Avatar';+import {Text} from '@xds/core/Text';+import {HStack} from '@xds/core/Layout';+import {Divider} from '@xds/core/Divider';import {resolveAuthor} from '../../content/blog/authors';export function formatDate(iso: string): string {@@ -36,8 +37,8 @@ const styles = stylex.create({names: {display: 'inline',},- dot: {- opacity: 0.5,+ divider: {+ height: '0.75em',},});@@ -48,6 +49,8 @@ export interface AuthorBylineProps {readingTimeMinutes?: number;/** 'compact' for cards, 'full' for article headers. */variant?: 'compact' | 'full';+ /** Optional class on the root row (e.g. for parent-driven hover styling). */+ className?: string;}export function AuthorByline({@@ -56,54 +59,48 @@ export function AuthorByline({updatedAt,readingTimeMinutes,variant = 'compact',+ className,}: AuthorBylineProps) {const resolved = authors.map(resolveAuthor);- const avatarSize = variant === 'full' ? 'small' : 'tiny';const names = resolved.map(a => a.name).join(', ');return (- <XDSHStack gap={2} align="center">- <XDSHStack gap={0} align="center">+ <HStack gap={2} align="center" className={className}>+ <HStack gap={0} align="center">{resolved.map(author => (- <XDSAvatar+ <Avatarkey={author.key}src={author.avatar}name={author.name}- size={avatarSize}+ size="tiny"/>))}- </XDSHStack>- <XDSHStack gap={1} align="center">- <XDSText type="supporting" color="secondary">+ </HStack>+ <HStack gap={2} align="center">+ <Text type="supporting" color="secondary">{names}- </XDSText>- <XDSText type="supporting" color="secondary" xstyle={styles.dot}>- ·- </XDSText>- <XDSText type="supporting" color="secondary">+ </Text>+ <Divider orientation="vertical" xstyle={styles.divider} />+ <Text type="supporting" color="secondary">{formatDate(date)}- </XDSText>+ </Text>{variant === 'full' && updatedAt ? (<>- <XDSText type="supporting" color="secondary" xstyle={styles.dot}>- ·- </XDSText>- <XDSText type="supporting" color="secondary">+ <Divider orientation="vertical" xstyle={styles.divider} />+ <Text type="supporting" color="secondary">Updated {formatDate(updatedAt)}- </XDSText>+ </Text></>) : null}{readingTimeMinutes ? (<>- <XDSText type="supporting" color="secondary" xstyle={styles.dot}>- ·- </XDSText>- <XDSText type="supporting" color="secondary">+ <Divider orientation="vertical" xstyle={styles.divider} />+ <Text type="supporting" color="secondary">{readingTimeMinutes} min read- </XDSText>+ </Text></>) : null}- </XDSHStack>- </XDSHStack>+ </HStack>+ </HStack>);}diff --git a/apps/docsite/src/components/blog/BlogArticle.tsx b/apps/docsite/src/components/blog/BlogArticle.tsxindex 08202a8667..19153d1dcd 100644--- a/apps/docsite/src/components/blog/BlogArticle.tsx+++ b/apps/docsite/src/components/blog/BlogArticle.tsx@@ -4,9 +4,10 @@* @file BlogArticle.tsx** Article layout matching the docs page typography: a centered, readable column- * (maxWidth 800) with a display-1 title, large regular-weight dek, byline, a- * neutral cover placeholder, the prose body (rendered via XDSMarkdown), optional- * curated related-doc links, and a link back to the blog index. No sidebar.+ * (maxWidth 800) with a breadcrumb trail (Blog / post type), a display-1 title,+ * large regular-weight dek, byline, a neutral cover placeholder, the prose body+ * (rendered via Markdown), optional curated related-doc links, and a link back to+ * the blog index. No sidebar.** @input post (BlogPost)* @output The full article view@@ -14,15 +15,16 @@*/import * as stylex from '@stylexjs/stylex';-import {XDSMarkdown} from '@xds/core/Markdown';-import {XDSText, XDSHeading} from '@xds/core/Text';-import {XDSVStack, XDSHStack} from '@xds/core/Layout';-import {XDSSection} from '@xds/core/Section';-import {XDSBadge} from '@xds/core/Badge';-import {XDSDivider} from '@xds/core/Divider';-import {XDSLink} from '@xds/core/Link';-import {XDSClickableCard} from '@xds/core/ClickableCard';-import {spacingVars} from '@xds/core/theme/tokens.stylex';+import {Markdown} from '@xds/core/Markdown';+import {Text, Heading} from '@xds/core/Text';+import {VStack, HStack} from '@xds/core/Layout';+import {Grid} from '@xds/core/Grid';+import {Icon} from '@xds/core/Icon';+import {Section} from '@xds/core/Section';+import {Badge} from '@xds/core/Badge';+import {Breadcrumbs, BreadcrumbItem} from '@xds/core/Breadcrumbs';+import {Divider} from '@xds/core/Divider';+import {ClickableCard} from '@xds/core/ClickableCard';import type {BlogPost} from '../../lib/blog/schema';import {POST_TYPE_LABELS} from '../../lib/blog/schema';import {AuthorByline} from './AuthorByline';@@ -30,7 +32,6 @@ import {AuthorByline} from './AuthorByline';const styles = stylex.create({section: {marginInline: 'auto',- paddingBottom: `calc(${spacingVars['--spacing-12']} * 2)`,},// Neutral cover placeholder (cover generator deferred). Calm, theme-driven.cover: {@@ -58,22 +59,22 @@ export interface BlogArticleProps {export function BlogArticle({post}: BlogArticleProps) {return (- <XDSSection maxWidth={800} padding={6} xstyle={styles.section}>- <XDSVStack gap={10}>+ <Section maxWidth={800} padding={6} xstyle={styles.section}>+ <VStack gap={10}>{/* Header — matches the docs page treatment */}- <XDSVStack gap={4}>- <XDSLink href="/blog" label="Back to blog">- ← Blog- </XDSLink>- <XDSHStack gap={1} align="center" xstyle={styles.tagRow}>- <XDSBadge label={POST_TYPE_LABELS[post.type]} variant="neutral" />- </XDSHStack>- <XDSHeading level={1} type="display-1">+ <VStack gap={4}>+ <Breadcrumbs>+ <BreadcrumbItem href="/blog">Blog</BreadcrumbItem>+ <BreadcrumbItem isCurrent>+ {POST_TYPE_LABELS[post.type]}+ </BreadcrumbItem>+ </Breadcrumbs>+ <Heading level={1} type="display-1">{post.title}- </XDSHeading>- <XDSText type="large" weight="normal" color="secondary">+ </Heading>+ <Text type="large" weight="normal" color="secondary">{post.description}- </XDSText>+ </Text><AuthorBylineauthors={post.authors}date={post.date}@@ -81,8 +82,8 @@ export function BlogArticle({post}: BlogArticleProps) {readingTimeMinutes={post.readingTimeMinutes}variant="full"/>- <XDSDivider />- </XDSVStack>+ <Divider />+ </VStack>{/* Cover — custom image when provided, else a neutral placeholder */}{post.coverImage ? (@@ -96,44 +97,47 @@ export function BlogArticle({post}: BlogArticleProps) {)}{/* Body */}- <XDSMarkdown headingLevelStart={2}>{post.body}</XDSMarkdown>+ <Markdown headingLevelStart={2}>{post.body}</Markdown>{post.tags.length > 0 ? (- <XDSHStack gap={1} xstyle={styles.tagRow}>+ <HStack gap={1} xstyle={styles.tagRow}>{post.tags.map(tag => (- <XDSBadge key={tag} label={tag} variant="neutral" />+ <Badge key={tag} label={tag} variant="neutral" />))}- </XDSHStack>+ </HStack>) : null}- {/* Related docs — clickable cards, not styled links */}+ {/* Related content */}{post.relatedDocs && post.relatedDocs.length > 0 ? (- <XDSVStack gap={4}>- <XDSDivider />- <XDSHeading level={2} type="display-3">+ <VStack gap={6}>+ <Divider />+ <Heading level={2} type="display-3">Related- </XDSHeading>- <XDSVStack gap={2}>+ </Heading>+ {/* minWidth caps this at 2 columns within the ~752px article+ column; 'fit' lets a lone card stretch to fill when it wraps to+ one column (an explicit `max` would cap track width at 50% and+ prevent the fill). */}+ <Grid columns={{minWidth: 280, repeat: 'fill'}} gap={2}>{post.relatedDocs.map(doc => (- <XDSClickableCard+ <ClickableCardkey={doc.href}href={doc.href}label={doc.title}+ padding={3}variant="muted">- <XDSText type="body" weight="medium">- {doc.title}- </XDSText>- </XDSClickableCard>+ <HStack justify="between" align="center" gap={2}>+ <Text type="body" weight="medium">+ {doc.title}+ </Text>+ <Icon icon="chevronRight" size="sm" color="secondary" />+ </HStack>+ </ClickableCard>))}- </XDSVStack>- </XDSVStack>+ </Grid>+ </VStack>) : null}-- <XDSDivider />- <XDSLink href="/blog" label="Back to all posts">- ← Back to all posts- </XDSLink>- </XDSVStack>- </XDSSection>+ </VStack>+ </Section>);}diff --git a/apps/docsite/src/components/blog/BlogCard.module.css b/apps/docsite/src/components/blog/BlogCard.module.cssnew file mode 100644index 0000000000..ccf7978c5e--- /dev/null+++ b/apps/docsite/src/components/blog/BlogCard.module.css@@ -0,0 +1,29 @@+/* Copyright (c) Meta Platforms, Inc. and affiliates. */++/*+ * Hover affordances for BlogCard, driven by the card Link's :hover. Plain+ * descendant selectors — no StyleX marker/ancestor machinery needed. Theme+ * tokens (--color-*, --duration-*, --ease-*) are real CSS custom properties.+ */++.cover::after {+ content: '';+ position: absolute;+ inset: 0;+ pointer-events: none;+ background-color: transparent;+ transition: background-color var(--duration-fast) var(--ease-standard);+}++@media (hover: hover) {+ /* Subtle currentColor tint over the cover, mirroring ClickableCard. */+ .card:hover .cover::after {+ background-color: color-mix(in srgb, currentColor 5%, transparent);+ }++ /* Promote secondary text to the primary text color on hover. */+ .card:hover .description,+ .card:hover .byline * {+ color: var(--color-text-primary);+ }+}diff --git a/apps/docsite/src/components/blog/BlogCard.tsx b/apps/docsite/src/components/blog/BlogCard.tsxindex 930de3f36e..07eb425e3a 100644--- a/apps/docsite/src/components/blog/BlogCard.tsx+++ b/apps/docsite/src/components/blog/BlogCard.tsx@@ -3,10 +3,11 @@/*** @file BlogCard.tsx*- * A blog index card built on XDSClickableCard: a neutral- * cover placeholder on top, then type badge, title, description excerpt,- * byline, and tag chips. The whole card navigates to the post; nested elements- * (tags, author links) remain independently interactive.+ * A blog index card built on Link: a neutral+ * cover placeholder on top, then title, description excerpt, byline, and a+ * chip row whose first badge is the post type followed by tag chips. The whole+ * card navigates to the post; nested elements (tags, author links) remain+ * independently interactive.** The `feature` variant gives the latest post a larger treatment. This is* derived from sort order by the index page — never from per-post metadata.@@ -17,35 +18,43 @@*/import * as stylex from '@stylexjs/stylex';-import {XDSText, XDSHeading} from '@xds/core/Text';-import {XDSVStack, XDSHStack} from '@xds/core/Layout';-import {XDSBadge} from '@xds/core/Badge';-import {XDSClickableCard} from '@xds/core/ClickableCard';+import {Text, Heading} from '@xds/core/Text';+import {VStack, HStack} from '@xds/core/Layout';+import {Badge} from '@xds/core/Badge';+import {Link} from '@xds/core/Link';+import {AspectRatio} from '@xds/core/AspectRatio';import type {BlogPost} from '../../lib/blog/schema';import {POST_TYPE_LABELS} from '../../lib/blog/schema';import {AuthorByline} from './AuthorByline';+import css from './BlogCard.module.css';const styles = stylex.create({card: {+ display: 'block',+ width: '100%',height: '100%',+ color: 'inherit',+ textDecoration: {+ default: 'none',+ ':hover': 'none',+ },},inner: {height: '100%',},// Neutral cover placeholder (cover generator deferred). Calm, theme-driven.- cover: (feature: boolean) => ({- width: '100%',- aspectRatio: feature ? '16 / 7' : '16 / 9',+ // Hover tint lives in BlogCard.module.css (.cover::after).+ cover: {borderRadius: 'var(--radius-container)',backgroundColor: 'var(--color-background-muted)',border: '1px solid var(--color-border)',- }),+ overflow: 'hidden',+ },coverImg: {width: '100%',height: '100%',objectFit: 'cover',display: 'block',- borderRadius: 'var(--radius-container)',},excerpt: {display: '-webkit-box',@@ -53,7 +62,7 @@ const styles = stylex.create({WebkitBoxOrient: 'vertical',overflow: 'hidden',},- tagRow: {+ postTags: {flexWrap: 'wrap',},});@@ -65,46 +74,51 @@ export interface BlogCardProps {export function BlogCard({post, feature = false}: BlogCardProps) {return (- <XDSClickableCard+ <Linkhref={`/blog/${post.slug}`}label={post.title}- padding={4}- xstyle={styles.card}>- <XDSVStack gap={3} xstyle={styles.inner}>- {post.coverImage ? (- <img- src={post.coverImage}- alt={post.coverAlt ?? ''}- {...stylex.props(styles.cover(feature), styles.coverImg)}- />- ) : (- <div {...stylex.props(styles.cover(feature))} aria-hidden="true" />- )}- <XDSVStack gap={2}>- <XDSHStack gap={1} align="center" xstyle={styles.tagRow}>- <XDSBadge label={POST_TYPE_LABELS[post.type]} variant="neutral" />- </XDSHStack>- <XDSVStack gap={1}>- <XDSHeading level={feature ? 2 : 3}>{post.title}</XDSHeading>- <XDSText type="body" color="secondary" xstyle={styles.excerpt}>+ color="inherit"+ display="block"+ xstyle={styles.card}+ className={css.card}>+ <VStack gap={3} xstyle={styles.inner}>+ <AspectRatio ratio={16 / 9} xstyle={styles.cover} className={css.cover}>+ {post.coverImage ? (+ <img+ src={post.coverImage}+ alt={post.coverAlt ?? ''}+ {...stylex.props(styles.coverImg)}+ />+ ) : (+ <div aria-hidden="true" />+ )}+ </AspectRatio>+ <VStack gap={3}>+ <VStack gap={1}>+ <Heading level={feature ? 1 : 3}>{post.title}</Heading>+ <Text+ type="body"+ color="secondary"+ xstyle={styles.excerpt}+ className={css.description}>{post.description}- </XDSText>- </XDSVStack>+ </Text>+ </VStack><AuthorBylineauthors={post.authors}date={post.date}readingTimeMinutes={post.readingTimeMinutes}variant="compact"+ className={css.byline}/>- {post.tags.length > 0 ? (- <XDSHStack gap={1} xstyle={styles.tagRow}>- {post.tags.map(tag => (- <XDSBadge key={tag} label={tag} variant="neutral" />- ))}- </XDSHStack>- ) : null}- </XDSVStack>- </XDSVStack>- </XDSClickableCard>+ <HStack gap={1} xstyle={styles.postTags}>+ <Badge label={POST_TYPE_LABELS[post.type]} variant="cyan" />+ {post.tags.map(tag => (+ <Badge key={tag} label={tag} variant="neutral" />+ ))}+ </HStack>+ </VStack>+ </VStack>+ </Link>);}diff --git a/apps/docsite/src/components/blog/BlogIndex.tsx b/apps/docsite/src/components/blog/BlogIndex.tsxindex 15c50cc670..87e5788f00 100644--- a/apps/docsite/src/components/blog/BlogIndex.tsx+++ b/apps/docsite/src/components/blog/BlogIndex.tsx@@ -19,26 +19,20 @@import {useState, useMemo} from 'react';import * as stylex from '@stylexjs/stylex';-import {XDSText, XDSHeading} from '@xds/core/Text';-import {XDSVStack} from '@xds/core/Layout';-import {XDSSection} from '@xds/core/Section';-import {XDSGrid} from '@xds/core/Grid';-import {XDSCarousel} from '@xds/core/Carousel';-import {XDSTabList, XDSTab} from '@xds/core/TabList';+import {Text, Heading} from '@xds/core/Text';+import {VStack} from '@xds/core/Layout';+import {Section} from '@xds/core/Section';+import {Grid} from '@xds/core/Grid';+import {ToggleButton, ToggleButtonGroup} from '@xds/core/ToggleButton';+import {EmptyState} from '@xds/core/EmptyState';import type {BlogPost, BlogPostType} from '../../lib/blog/schema';import {POST_TYPE_LABELS} from '../../lib/blog/schema';import {BlogCard} from './BlogCard';const styles = stylex.create({- header: {- maxWidth: 720,- },- filterRow: {- marginBottom: 4,- },- empty: {- paddingBlock: 48,- textAlign: 'center',+ typeFilter: {+ flexWrap: 'wrap',+ justifyContent: 'center',},});@@ -72,63 +66,59 @@ export function BlogIndex({posts, availableTypes}: BlogIndexProps) {const restPosts = showFeature ? filtered.slice(1) : filtered;return (- <XDSSection maxWidth={1100} padding={6}>- <XDSVStack gap={6}>- <XDSVStack gap={4} xstyle={styles.header}>- <XDSHeading level={1} type="display-1">+ <Section maxWidth={800} padding={6} style={{marginInline: 'auto'}}>+ <VStack gap={10}>+ {/* Header */}+ <VStack gap={2}>+ <Heading level={1} type="display-1" justify="center">Blog- </XDSHeading>- <XDSText type="large" weight="normal" color="secondary">- Notes on building Astryx — releases, guides, stories, and- perspectives on designing a system for humans and agents.- </XDSText>- </XDSVStack>+ </Heading>+ <Text weight="normal" color="secondary" justify="center">+ Releases, guides, and stories on building Astryx for humans and+ agents.+ </Text>+ </VStack>{availableTypes.length > 1 ? (- <XDSCarousel gap={0}>- <XDSTabList- value={activeType}- onChange={v => setActiveType(v as 'all' | BlogPostType)}- size="md"- xstyle={styles.filterRow}>- <XDSTab value="all" label={`All (${counts.all})`} />- {availableTypes.map(t => (- <XDSTab- key={t}- value={t}- label={`${POST_TYPE_LABELS[t]} (${counts[t]})`}- />- ))}- </XDSTabList>- </XDSCarousel>+ <ToggleButtonGroup+ label="Filter posts by type"+ value={activeType}+ onChange={value =>+ setActiveType((value as 'all' | BlogPostType) ?? 'all')+ }+ xstyle={styles.typeFilter}>+ <ToggleButton value="all" label={`All (${counts.all})`} />+ {availableTypes.map(t => (+ <ToggleButton+ key={t}+ value={t}+ label={`${POST_TYPE_LABELS[t]} (${counts[t]})`}+ />+ ))}+ </ToggleButtonGroup>) : null}{filtered.length === 0 ? (- <div {...stylex.props(styles.empty)}>- <XDSText type="body" color="secondary">- No posts yet. Check back soon.- </XDSText>- </div>+ <EmptyState+ title="No posts yet"+ description="Check back soon for releases, guides, and stories."+ />) : (- <XDSVStack gap={6}>- {featurePost ? (- <XDSGrid columns={1} gap={4}>- <BlogCard post={featurePost} feature />- </XDSGrid>- ) : null}+ <VStack gap={10}>+ {featurePost ? <BlogCard post={featurePost} feature /> : null}{restPosts.length > 0 ? (- <XDSGrid+ <Gridcolumns={{minWidth: 320, repeat: 'fill'}}- gap={4}- rowGap={6}>+ gap={5}+ rowGap={10}>{restPosts.map(post => (<BlogCard key={post.slug} post={post} />))}- </XDSGrid>+ </Grid>) : null}- </XDSVStack>+ </VStack>)}- </XDSVStack>- </XDSSection>+ </VStack>+ </Section>);}diff --git a/apps/docsite/src/components/component-detail/ComponentDetailClient.tsx b/apps/docsite/src/components/component-detail/ComponentDetailClient.tsxindex dc284d6138..6cb2291dd5 100644--- a/apps/docsite/src/components/component-detail/ComponentDetailClient.tsx+++ b/apps/docsite/src/components/component-detail/ComponentDetailClient.tsx@@ -28,13 +28,11 @@ import type {ComponentEntry} from '../../generated/componentRegistry';import type {BlockEntry} from '../../generated/blockRegistry';import {showcaseRegistry} from '../../generated/showcaseRegistry';import {exampleRegistry} from '../../generated/exampleRegistry';-import {spacingVars} from '@xds/core/theme/tokens.stylex';import {trackNavigate} from '../../lib/analytics';const styles = stylex.create({section: {marginInline: 'auto',- paddingBottom: `calc(${spacingVars['--spacing-12']} * 2)`,},});diff --git a/apps/docsite/src/components/docs/DocPageLayout.tsx b/apps/docsite/src/components/docs/DocPageLayout.tsxindex 49e3d57d66..c8db08a0ed 100644--- a/apps/docsite/src/components/docs/DocPageLayout.tsx+++ b/apps/docsite/src/components/docs/DocPageLayout.tsx@@ -13,12 +13,9 @@ import {Text, Heading} from '@xds/core/Text';import {VStack} from '@xds/core/Layout';import {Section} from '@xds/core/Section';import {Divider} from '@xds/core/Divider';-import {spacingVars} from '@xds/core/theme/tokens.stylex';-const styles = stylex.create({section: {marginInline: 'auto',- paddingBottom: `calc(${spacingVars['--spacing-12']} * 2)`,},});diff --git a/apps/docsite/src/content/blog/posts/introducing-astryx.md b/apps/docsite/src/content/blog/posts/introducing-astryx.mdindex 3a24220a70..7fa3594be7 100644--- a/apps/docsite/src/content/blog/posts/introducing-astryx.md+++ b/apps/docsite/src/content/blog/posts/introducing-astryx.md@@ -20,7 +20,7 @@ Open source is how the best ideas in our industry travel. The tools we reach forWe're excited to introduce Astryx by Meta, an open source design system that's AI fluent and fully customizable without dependencies. It's a complete, production-ready (and growing) toolkit with 150+ accessible components, brand-level theming, dark mode, ready-to-ship templates, and a CLI – all as one cohesive system, built on React and StyleX.-Astryx isn't new. It's matured within Meta for the last eight years and powers over 13,000 apps, shaped by the designers, engineers, and product teams who depend on it every day. What's new is that it's now yours, too.+Astryx has matured within Meta for the last eight years and powers over 13,000 apps. It's shaped by the designers, engineers, and product teams who depend on it every day and now, it's yours, too.## Start anywhere, change anything, and ship faster@@ -32,4 +32,4 @@ Astryx is built to end that trade-off. The system controls behavior, accessibiliThe way we build software is changing, and Astryx is designed for people and the agents building alongside them. Design systems have historically been designed for human consumption but as more code is written by agents, we have to rethink how design systems are structured and the role that they play. Astryx was built ground-up to be AI-operable, opposed to retrofitting existing design systems to play nicely with agent behaviors. It's an open source design system built for how we build in this new world.-Astryx is in Beta and ready for you to build with today. Try it out at [astryxdesign.com](https://astryxdesign.com) and on [GitHub](https://github.com/facebookexperimental/xds).+Astryx is in Beta and ready for you to build with today. Try it out at [Astryx Design](TODO_ASTRYX_DESIGN_URL) and on [GitHub](https://github.com/facebook/astryx).