Vercel Labs Setup
Source: <reference-project> @ src/app/layout.tsx
import { ThemeProvider, BaseSurface } from 'ds-react'
import './globals.css'
export default function RootLayout({ children }) {
return (
<html lang="en" data-ds-color-scheme="dark">
<body>
<ThemeProvider>
<BaseSurface style={{ backgroundColor: 'var(--ds-surface-default)' }}>
{children}
</BaseSurface>
</ThemeProvider>
</body>
</html>
)
}
Companion CSS — src/app/globals.css
@import "ds-themes/light.css";
body {
background-color: var(--ds-surface-default);
color: var(--ds-text-default);
}
When to Load References
| Trigger | Files to load | Notes |
|---|---|---|
| button asks | references/components/button.md | per-component file |
Hard rules
- The body/root MUST paint with
var(--ds-surface-default)via the<BaseSurface style>prop ORbody { background-color: ... }inglobals.css. A token-painted component on an unpainted shell is the canonical mode-mismatch bug — seereferences/anti-patterns.mdshell/unpainted-body. <html data-ds-color-scheme="<mode>">MUST be paired with the matching theme CSS import (@import "ds-themes/<mode>.css";). The attribute sets the resolution context; the import provides the values — seeshell/mode-attribute-no-theme-import.- Any prop, variant, token, or asset the agent cannot ground in source gets a literal
[VERIFY]marker inline.
Final checks
After generating UI: cite each component used; confirm shell parity.
In scope: tokens, assets, component descriptions, component APIs.