An open source design system that's fully customizable and agent ready
TypeScript
feat(docsite): craft section + mobile nav SSR hint (#1992)
Cindy Zhanga22be4d7e4d3
diff --git a/apps/docsite/src/app/craft/page.tsx b/apps/docsite/src/app/craft/page.tsxnew file mode 100644index 0000000000..140a27dd62--- /dev/null+++ b/apps/docsite/src/app/craft/page.tsx@@ -0,0 +1,83 @@+/**+ * Page type: craft landing+ * Template gallery with tabs: All, Templates, Components.+ * All data from pipeline registries.+ */++import {XDSHeading, XDSText} from '@xds/core/Text';+import {XDSVStack} from '@xds/core/Layout';+import {XDSSection} from '@xds/core/Section';+import {XDSGrid} from '@xds/core/Grid';+import {XDSClickableCard} from '@xds/core/ClickableCard';+import {XDSBadge} from '@xds/core/Badge';+import {templates} from '../../generated/templateRegistry';+import {blocks, showcaseCount} from '../../generated/blockRegistry';++const showcases = blocks.filter(b => b.isShowcase);++export default function CraftPage() {+ 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>++ {/* 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>++ {/* 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>+ ))}+ </XDSGrid>+ </XDSVStack>+ </XDSVStack>+ </XDSSection>+ );+}diff --git a/apps/docsite/src/app/craft/templates/[slug]/page.tsx b/apps/docsite/src/app/craft/templates/[slug]/page.tsxnew file mode 100644index 0000000000..7dcce79443--- /dev/null+++ b/apps/docsite/src/app/craft/templates/[slug]/page.tsx@@ -0,0 +1,37 @@+/**+ * Page type: template viewer+ * Preview a template + view its source code.+ * TODO: render template in iframe, show source from pipeline.+ */++import {notFound} from 'next/navigation';+import {XDSHeading, XDSText} from '@xds/core/Text';+import {XDSVStack} from '@xds/core/Layout';+import {XDSSection} from '@xds/core/Section';+import {templates} from '../../../../generated/templateRegistry';++export function generateStaticParams() {+ return templates.map(t => ({slug: t.slug}));+}++export default async function TemplatePage({+ params,+}: {+ params: Promise<{slug: string}>;+}) {+ const {slug} = await params;+ const template = templates.find(t => t.slug === slug);+ if (!template) notFound();++ return (+ <XDSSection maxWidth="lg" padding={6}>+ <XDSVStack gap={4}>+ <XDSHeading level={1}>{template.name}</XDSHeading>+ <XDSText type="body" color="secondary">+ {template.description}+ </XDSText>+ {/* TODO: template preview iframe + source code viewer */}+ </XDSVStack>+ </XDSSection>+ );+}diff --git a/apps/docsite/src/app/craft/theme/page.tsx b/apps/docsite/src/app/craft/theme/page.tsxnew file mode 100644index 0000000000..00ddaebd37--- /dev/null+++ b/apps/docsite/src/app/craft/theme/page.tsx@@ -0,0 +1,24 @@+/**+ * Page type: theme editor+ * Live theme customization with token adjustments and preview.+ * All client-side — no AI/inference needed.+ * TODO: port ThemeEditorView from sandbox.+ */++import {XDSHeading, XDSText} from '@xds/core/Text';+import {XDSVStack} from '@xds/core/Layout';+import {XDSSection} from '@xds/core/Section';++export default function ThemeEditorPage() {+ return (+ <XDSSection maxWidth="lg" padding={6}>+ <XDSVStack gap={4}>+ <XDSHeading level={1}>Theme Editor</XDSHeading>+ <XDSText type="body" color="secondary">+ Customize colors, typography, radius, and more. Preview changes live.+ </XDSText>+ {/* TODO: port theme editor controls + live preview */}+ </XDSVStack>+ </XDSSection>+ );+}diff --git a/apps/docsite/src/app/layout.tsx b/apps/docsite/src/app/layout.tsxindex 073b7bb8e9..b0407dde51 100644--- a/apps/docsite/src/app/layout.tsx+++ b/apps/docsite/src/app/layout.tsx@@ -1,4 +1,5 @@import type {Metadata} from 'next';+import {headers} from 'next/headers';import './globals.css';import {Providers} from './providers';import {DocsShell} from '../components/DocsShell';@@ -13,7 +14,15 @@ export const metadata: Metadata = {'Open-source design system for building internal tools and products.',};-export default function RootLayout({children}: {children: React.ReactNode}) {+export default async function RootLayout({+ children,+}: {+ children: React.ReactNode;+}) {+ const headersList = await headers();+ const ua = headersList.get('user-agent') ?? '';+ const defaultIsMobile = /mobile|android|iphone|ipad/i.test(ua);+return (<html lang="en"><body>@@ -22,7 +31,8 @@ export default function RootLayout({children}: {children: React.ReactNode}) {components={components}packages={packages}docTopics={docTopics}- templates={templates}>+ templates={templates}+ defaultIsMobile={defaultIsMobile}>{children}</DocsShell></Providers>diff --git a/apps/docsite/src/components/DocsShell.tsx b/apps/docsite/src/components/DocsShell.tsxindex 209f55ad72..5956b2c6a1 100644--- a/apps/docsite/src/components/DocsShell.tsx+++ b/apps/docsite/src/components/DocsShell.tsx@@ -5,6 +5,7 @@ import {usePathname} from 'next/navigation';import {XDSAppShell} from '@xds/core/AppShell';import {XDSTopNav, XDSTopNavHeading} from '@xds/core/TopNav';import {XDSSideNav, XDSSideNavItem, XDSSideNavSection} from '@xds/core/SideNav';+import {XDSNavMenuItem} from '@xds/core/NavMenu';import {XDSButton} from '@xds/core/Button';import {XDSLink} from '@xds/core/Link';import {XDSHStack, XDSVStack} from '@xds/core/Layout';@@ -22,6 +23,7 @@ interface DocsShellProps {packages: PackageMeta[];docTopics: DocTopic[];templates: TemplateEntry[];+ defaultIsMobile?: boolean;}/** Foundations: tokens first, then alphabetical */@@ -161,6 +163,7 @@ export function DocsShell({packages,docTopics,templates,+ defaultIsMobile,}: DocsShellProps) {const pathname = usePathname();const [isSearchOpen, setIsSearchOpen] = useState(false);@@ -205,10 +208,22 @@ export function DocsShell({<XDSAppShellvariant="surface"height="auto"+ mobileNav={{defaultIsMobile}}topNav={<XDSTopNavlabel="XDS navigation"- heading={<XDSTopNavHeading logo={XDS_WORDMARK} headingHref="/" />}+ heading={+ <XDSTopNavHeading+ logo={XDS_WORDMARK}+ headingHref="/"+ menu={+ <>+ <XDSNavMenuItem label="Craft" href="/craft" />+ <XDSNavMenuItem label="Docs" href="/" />+ </>+ }+ />+ }endContent={<XDSHStack gap={2}><XDSButton