Skip to content

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

TypeScript

feat(docsite): craft gallery with overlay cards + tabs (#2002)

Cindy Zhang30f7fd3271b0
diff --git a/apps/docsite/src/app/craft/page.tsx b/apps/docsite/src/app/craft/page.tsx
index 140a27dd62..0bdc0af4d3 100644
--- a/apps/docsite/src/app/craft/page.tsx
+++ b/apps/docsite/src/app/craft/page.tsx
@@ -1,83 +1,224 @@
/**
* Page type: craft landing
- * Template gallery with tabs: All, Templates, Components.
+ * Template gallery with hover overlay cards.
* All data from pipeline registries.
*/
-import {XDSHeading, XDSText} from '@xds/core/Text';
-import {XDSVStack} from '@xds/core/Layout';
+'use client';
+
+import {useState, useMemo} from 'react';
+import * as stylex from '@stylexjs/stylex';
+import {XDSText} from '@xds/core/Text';
+import {XDSVStack, XDSHStack} from '@xds/core/Layout';
import {XDSSection} from '@xds/core/Section';
import {XDSGrid} from '@xds/core/Grid';
+import {XDSCard} from '@xds/core/Card';
import {XDSClickableCard} from '@xds/core/ClickableCard';
+import {XDSButton} from '@xds/core/Button';
+import {XDSOverlay} from '@xds/core/Overlay';
+import {XDSTabList, XDSTab} from '@xds/core/TabList';
+import {XDSCarousel} from '@xds/core/Carousel';
import {XDSBadge} from '@xds/core/Badge';
import {templates} from '../../generated/templateRegistry';
-import {blocks, showcaseCount} from '../../generated/blockRegistry';
+import {blocks} from '../../generated/blockRegistry';
+import {packages} from '../../generated/packageRegistry';
const showcases = blocks.filter(b => b.isShowcase);
+const themePackages = packages.filter(p => p.name.includes('theme-'));
+
+const styles = stylex.create({
+ heroTitle: {
+ textAlign: 'center' as const,
+ },
+ cardImage: {
+ display: 'block',
+ width: '100%',
+ aspectRatio: '16/10',
+ backgroundColor: 'var(--color-background-muted)',
+ borderRadius: 'var(--radius-container)',
+ },
+ comingSoon: {
+ height: '100%',
+ display: 'flex',
+ alignItems: 'center',
+ justifyContent: 'center',
+ },
+ overlayInner: {
+ display: 'flex',
+ flexDirection: 'column' as const,
+ justifyContent: 'flex-end',
+ height: '100%',
+ padding: 16,
+ },
+});
+
+type Tab = 'all' | 'templates' | 'theme' | 'showcases';
+
+interface CraftItem {
+ type: 'template' | 'showcase';
+ name: string;
+ description: string;
+ slug: string;
+ href: string;
+ isReady: boolean;
+}
+
+function buildItems(): {templates: CraftItem[]; showcases: CraftItem[]} {
+ return {
+ templates: templates.map(t => ({
+ type: 'template' as const,
+ name: t.name,
+ description: t.description,
+ slug: t.slug,
+ href: `/craft/templates/${t.slug}`,
+ isReady: t.isReady,
+ })),
+ showcases: showcases.map(b => ({
+ type: 'showcase' as const,
+ name: b.name,
+ description: b.description,
+ slug: b.dirName,
+ href: `/components/${b.componentsUsed[0] || b.category.split('/').pop()}`,
+ isReady: true,
+ })),
+ };
+}
export default function CraftPage() {
+ const [activeTab, setActiveTab] = useState<Tab>('all');
+ const allItems = useMemo(buildItems, []);
+
+ const handleTabChange = (v: string) => {
+ setActiveTab(v as Tab);
+ };
+
+ const items =
+ activeTab === 'templates'
+ ? allItems.templates
+ : activeTab === 'showcases'
+ ? allItems.showcases
+ : [...allItems.templates, ...allItems.showcases];
+
return (
- <XDSSection maxWidth="lg" padding={6}>
- <XDSVStack gap={8}>
- <XDSVStack gap={2}>
- <XDSHeading level={1}>Craft</XDSHeading>
- <XDSText type="large" color="secondary">
- Browse templates, component showcases, and examples. Copy the source
- code to get started.
- </XDSText>
- </XDSVStack>
+ <XDSSection maxWidth="xl" padding={6}>
+ <XDSVStack gap={6}>
+ <XDSText type="display-1" xstyle={styles.heroTitle}>
+ Craft what you imagine.
+ </XDSText>
- {/* Templates */}
- <XDSVStack gap={4}>
- <XDSHeading level={2}>Page Templates ({templates.length})</XDSHeading>
- <XDSGrid columns={{minWidth: 280, repeat: 'fit'}} gap={4} rowGap={6}>
- {templates.map(t => (
- <XDSClickableCard
- key={t.slug}
- label={t.name}
- href={`/craft/templates/${t.slug}`}
- padding={5}>
- <XDSVStack gap={2}>
- <XDSText type="body" weight="bold">
- {t.name}
- </XDSText>
- <XDSText type="supporting" color="secondary">
- {t.description}
- </XDSText>
- {!t.isReady && (
- <XDSBadge label="Coming Soon" variant="warning" />
- )}
- </XDSVStack>
- </XDSClickableCard>
- ))}
- </XDSGrid>
- </XDSVStack>
+ <XDSCarousel gap={0}>
+ <XDSTabList value={activeTab} onChange={handleTabChange} size="md">
+ <XDSTab
+ value="all"
+ label={`All (${allItems.templates.length + allItems.showcases.length})`}
+ />
+ <XDSTab
+ value="templates"
+ label={`Templates (${allItems.templates.length})`}
+ />
+ <XDSTab value="theme" label="Theme" />
+ <XDSTab
+ value="showcases"
+ label={`Components (${allItems.showcases.length})`}
+ />
+ </XDSTabList>
+ </XDSCarousel>
- {/* Showcases */}
- <XDSVStack gap={4}>
- <XDSHeading level={2}>
- Component Showcases ({showcaseCount})
- </XDSHeading>
- <XDSGrid columns={{minWidth: 280, repeat: 'fit'}} gap={4} rowGap={6}>
- {showcases.map(b => (
- <XDSClickableCard
- key={b.dirName}
- label={b.name}
- href={`/components/${b.componentsUsed[0] || b.category.split('/').pop()}`}
- padding={5}>
- <XDSVStack gap={2}>
- <XDSText type="body" weight="bold">
- {b.name}
- </XDSText>
- <XDSText type="supporting" color="secondary">
- {b.description}
- </XDSText>
- </XDSVStack>
- </XDSClickableCard>
+ {activeTab === 'theme' ? (
+ <ThemeGrid />
+ ) : (
+ <XDSGrid columns={{minWidth: 300, repeat: 'fill'}} gap={4} rowGap={6}>
+ {items.map(item => (
+ <TemplateCard key={`${item.type}-${item.slug}`} item={item} />
))}
</XDSGrid>
- </XDSVStack>
+ )}
</XDSVStack>
</XDSSection>
);
}
+
+function ThemeGrid() {
+ return (
+ <XDSGrid columns={{minWidth: 260, repeat: 'fill'}} gap={4} rowGap={6}>
+ {themePackages.map(pkg => (
+ <XDSClickableCard
+ key={pkg.name}
+ label={pkg.displayName}
+ href={`/packages/${pkg.name.replace('@xds/', '')}`}
+ padding={5}>
+ <XDSVStack gap={2}>
+ <XDSText type="body" weight="bold">
+ {pkg.displayName}
+ </XDSText>
+ <XDSText type="supporting" color="secondary">
+ {pkg.description}
+ </XDSText>
+ <XDSBadge label={`v${pkg.version}`} variant="info" />
+ </XDSVStack>
+ </XDSClickableCard>
+ ))}
+ <XDSClickableCard label="Theme Editor" href="/craft/theme" padding={5}>
+ <XDSVStack gap={2}>
+ <XDSText type="body" weight="bold">
+ Theme Editor
+ </XDSText>
+ <XDSText type="supporting" color="secondary">
+ Customize colors, typography, radius, and more with a live preview.
+ </XDSText>
+ </XDSVStack>
+ </XDSClickableCard>
+ </XDSGrid>
+ );
+}
+
+function TemplateCard({item}: {item: CraftItem}) {
+ return (
+ <XDSCard padding={0}>
+ <XDSOverlay
+ showOn="hover"
+ scrim="dark"
+ content={
+ <div {...stylex.props(styles.overlayInner)}>
+ <XDSVStack gap={2}>
+ <XDSVStack gap={0.5}>
+ <XDSText type="body" weight="bold" style={{color: '#fff'}}>
+ {item.name}
+ </XDSText>
+ <XDSText
+ type="supporting"
+ style={{color: 'rgba(255,255,255,0.7)'}}>
+ {item.description.slice(0, 80)}
+ {item.description.length > 80 ? '…' : ''}
+ </XDSText>
+ </XDSVStack>
+ <XDSHStack gap={2}>
+ <XDSButton
+ label="Preview"
+ variant="secondary"
+ size="sm"
+ href={item.href}
+ />
+ {item.type === 'template' && (
+ <XDSButton
+ label="Use"
+ variant="secondary"
+ size="sm"
+ href={item.href}
+ />
+ )}
+ </XDSHStack>
+ </XDSVStack>
+ </div>
+ }>
+ <div {...stylex.props(styles.cardImage)}>
+ {!item.isReady && (
+ <div {...stylex.props(styles.comingSoon)}>
+ <XDSBadge label="Coming Soon" variant="info" />
+ </div>
+ )}
+ </div>
+ </XDSOverlay>
+ </XDSCard>
+ );
+}