Peach: Local-first video metadata scraper and media manager.
Table
A semantic HTML table component
Basic table
import {
Table,
TableHeader,
TableRow,
TableHead,
TableBody,
TableCell,
TableRoot,
} from '@vercel/geistcn/components';
import type { JSX } from 'react';
export function Component(): JSX.Element {
return (
<TableRoot>
<Table>
<TableHeader>
<TableRow>
<TableHead>Col 1</TableHead>
<TableHead>Col 2</TableHead>
<TableHead>Col 3</TableHead>
</TableRow>
</TableHeader>
<TableBody>
<TableRow>
<TableCell>Value 1.1</TableCell>
<TableCell>Value 1.2</TableCell>
<TableCell>Value 1.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 2.1</TableCell>
<TableCell>Value 2.2</TableCell>
<TableCell>Value 2.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 3.1</TableCell>
<TableCell>Value 3.2</TableCell>
<TableCell>Value 3.3</TableCell>
</TableRow>
</TableBody>
</Table>
</TableRoot>
);
}
Striped table
import {
Table,
TableHeader,
TableRow,
TableHead,
TableBody,
TableCell,
TableRoot,
} from '@vercel/geistcn/components';
import type { JSX } from 'react';
export function Component(): JSX.Element {
return (
<TableRoot>
<Table>
<TableHeader>
<TableRow>
<TableHead>Col 1</TableHead>
<TableHead>Col 2</TableHead>
<TableHead>Col 3</TableHead>
</TableRow>
</TableHeader>
<TableBody striped>
<TableRow>
<TableCell>Value 1.1</TableCell>
<TableCell>Value 1.2</TableCell>
<TableCell>Value 1.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 2.1</TableCell>
<TableCell>Value 2.2</TableCell>
<TableCell>Value 2.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 3.1</TableCell>
<TableCell>Value 3.2</TableCell>
<TableCell>Value 3.3</TableCell>
</TableRow>
</TableBody>
</Table>
</TableRoot>
);
}
Bordered table
import {
Table,
TableHeader,
TableRow,
TableHead,
TableBody,
TableCell,
TableRoot,
} from '@vercel/geistcn/components';
import type { JSX } from 'react';
export function Component(): JSX.Element {
return (
<TableRoot>
<Table>
<TableHeader>
<TableRow>
<TableHead>Col 1</TableHead>
<TableHead>Col 2</TableHead>
<TableHead>Col 3</TableHead>
</TableRow>
</TableHeader>
<TableBody bordered>
<TableRow>
<TableCell>Value 1.1</TableCell>
<TableCell>Value 1.2</TableCell>
<TableCell>Value 1.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 2.1</TableCell>
<TableCell>Value 2.2</TableCell>
<TableCell>Value 2.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 3.1</TableCell>
<TableCell>Value 3.2</TableCell>
<TableCell>Value 3.3</TableCell>
</TableRow>
</TableBody>
</Table>
</TableRoot>
);
}
Interactive table
import {
Table,
TableHeader,
TableRow,
TableHead,
TableBody,
TableCell,
TableRoot,
} from '@vercel/geistcn/components';
import type { JSX } from 'react';
export function Component(): JSX.Element {
return (
<TableRoot>
<Table>
<TableHeader>
<TableRow>
<TableHead>Col 1</TableHead>
<TableHead>Col 2</TableHead>
<TableHead>Col 3</TableHead>
</TableRow>
</TableHeader>
<TableBody interactive>
<TableRow>
<TableCell>Value 1.1</TableCell>
<TableCell>Value 1.2</TableCell>
<TableCell>Value 1.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 2.1</TableCell>
<TableCell>Value 2.2</TableCell>
<TableCell>Value 2.3</TableCell>
</TableRow>
<TableRow>
<TableCell>Value 3.1</TableCell>
<TableCell>Value 3.2</TableCell>
<TableCell>Value 3.3</TableCell>
</TableRow>
</TableBody>
</Table>
</TableRoot>
);
}
Full featured table
import {
Table,
TableColgroup,
TableCol,
TableHeader,
TableRow,
TableHead,
TableBody,
TableCell,
TableFooter,
TableRoot,
} from '@vercel/geistcn/components';
import type { JSX } from 'react';
const formatter = new Intl.NumberFormat('en-US', {
style: 'currency',
maximumFractionDigits: 2,
currency: 'usd',
});
function formatCurrency(amount: number): string {
return formatter.format(amount);
}
const items = [
{
product: 'Brake Pads Set',
usage: '100 sets',
price: '$50 per set',
charge: 5000,
},
{
product: 'Oil Filters',
usage: '200 filters',
price: '$10 per filter',
charge: 2000,
},
{
product: 'Car Batteries',
usage: '50 batteries',
price: '$100 per battery',
charge: 5000,
},
{
product: 'Headlight Bulbs',
usage: '300 bulbs',
price: '$15 per bulb',
charge: 4500,
},
{
product: 'Windshield Wipers',
usage: '250 pairs',
price: '$20 per pair',
charge: 5000,
},
{
product: 'Spark Plugs',
usage: '500 sets',
price: '$5 per set',
charge: 2500,
},
];
export function Component(): JSX.Element {
return (
<TableRoot>
<Table>
<TableColgroup>
<TableCol className="w-[44%]" />
<TableCol className="w-[22%]" />
<TableCol className="w-[22%]" />
<TableCol className="w-[11%]" />
</TableColgroup>
<TableHeader>
<TableRow>
<TableHead>Product</TableHead>
<TableHead>Usage</TableHead>
<TableHead>Price</TableHead>
<TableHead>Charge</TableHead>
</TableRow>
</TableHeader>
<TableBody interactive striped>
{items.map((item) => (
<TableRow key={item.product}>
<TableCell>{item.product}</TableCell>
<TableCell>{item.usage}</TableCell>
<TableCell>{item.price}</TableCell>
<TableCell>{formatCurrency(item.charge)}</TableCell>
</TableRow>
))}
</TableBody>
<TableFooter>
<TableRow>
<TableCell className="text-gray-1000 font-medium" colSpan={3}>
Subtotal
</TableCell>
<TableCell className="text-gray-1000 font-medium">
{formatCurrency(items.reduce((sum, val) => sum + val.charge, 0))}
</TableCell>
</TableRow>
</TableFooter>
</Table>
</TableRoot>
);
}
Virtualized table
'use client';
import {
ShowMore,
Table,
TableColgroup,
TableCol,
TableHeader,
TableRow,
TableHead,
TableBody,
TableCell,
TableRoot,
} from '@vercel/geistcn/components';
import { memo, useState, type JSX } from 'react';
const formatter = new Intl.NumberFormat('en-US', {
style: 'currency',
maximumFractionDigits: 2,
currency: 'usd',
});
function formatCurrency(amount: number): string {
return formatter.format(amount);
}
const items = [
{
product: 'Brake Pads Set',
usage: '100 sets',
price: '$50 per set',
charge: 5000,
},
{
product: 'Oil Filters',
usage: '200 filters',
price: '$10 per filter',
charge: 2000,
},
{
product: 'Car Batteries',
usage: '50 batteries',
price: '$100 per battery',
charge: 5000,
},
{
product: 'Headlight Bulbs',
usage: '300 bulbs',
price: '$15 per bulb',
charge: 4500,
},
{
product: 'Windshield Wipers',
usage: '250 pairs',
price: '$20 per pair',
charge: 5000,
},
{
product: 'Spark Plugs',
usage: '500 sets',
price: '$5 per set',
charge: 2500,
},
];
export function Component(): JSX.Element {
const [expanded, setExpanded] = useState(false);
return (
<div className="relative">
<TableRoot>
<Table>
<TableColgroup>
<TableCol className="w-[44%]" />
<TableCol className="w-[22%]" />
<TableCol className="w-[22%]" />
<TableCol className="w-[11%]" />
</TableColgroup>
<TableHeader>
<TableRow>
<TableHead>Product</TableHead>
<TableHead>Usage</TableHead>
<TableHead>Price</TableHead>
<TableHead>Charge</TableHead>
</TableRow>
</TableHeader>
<TableBody interactive striped virtualize>
{new Array(5_000).fill(null).map((_, index) => {
if (!expanded && index >= 9) return null;
const item = items[index % items.length];
if (!item) return null;
return <Row item={item} key={`${item.product}${index}`} />;
})}
</TableBody>
</Table>
</TableRoot>
{expanded ? null : (
<div className="from-background-100 pointer-events-none absolute bottom-0 left-0 h-[30%] w-full rounded bg-linear-to-t to-transparent opacity-80" />
)}
<div className={expanded ? 'h-16' : 'h-4'} />
<div className="pointer-events-none absolute bottom-0 left-0 flex h-[calc(100%-160px)] w-full flex-col justify-end">
<ShowMore
className="pointer-events-auto sticky bottom-4 mb-4"
expanded={expanded}
noBorder
onClick={() => setExpanded((x) => !x)}
/>
</div>
</div>
);
}
const Row = memo(function Row({
item,
}: {
item: (typeof items)[number];
}): JSX.Element {
return (
<TableRow>
<TableCell>{item.product}</TableCell>
<TableCell>{item.usage}</TableCell>
<TableCell>{item.price}</TableCell>
<TableCell>{formatCurrency(item.charge)}</TableCell>
</TableRow>
);
});
Best Practices
When to use
- Use
<Table>for tabular data where rows share the same shape and at least one column is sortable or comparable across rows. - For a row of descriptive content paired with a single action (membership row, integration row), use
Entityinstead. - For a key/value metadata block on a detail page, use
Description, not a two-column table.
Behavior
- When the underlying list is empty (filter cleared, never created), render
Empty Stateoutside the table rather than an empty<Table.Body>. - Render
—in cells where a value is unknown or not applicable. Don’t substituteN/A,null, or an empty string. - Sortable column headers are buttons. The visible label stays Title Case; the sort-direction arrow is decorative and the button announces the next sort state to assistive tech.
- Apply
tabular-nums(or Geist Mono) to numeric columns so digits align across rows for comparison.
Content
- Column headers (
<Table.Head>) are Title Case nouns or noun phrases:Last Used,Requests (7d),Created,Status. Never sentences. - Use the canonical short relative-time form in cells (
2m ago,5h ago); switch toMar 14, 2026past 7 days. SeeRelative Time Card. - Pagination labels are
PreviousandNext. Page-count copy readsPage 2 of 7or21–40 of 142with an en-dash inside the range.