DataTable

Sortable, paginated data tables powered by @tanstack/react-table.

Preview

ID⇅	Name⇅	Email	Role⇅	Status⇅
1	Alice Johnson	alice@example.com	Admin	Active
2	Bob Smith	bob@example.com	Editor	Active
3	Carol White	carol@example.com	Viewer	Inactive
4	David Lee	david@example.com	Editor	Active
5	Eva Martinez	eva@example.com	Admin	Active

Page 1 of 2 · 8 rows

Installation

npm install @tanstack/react-table

Usage

import { createColumnHelper } from '@tanstack/react-table'
import { DataTable } from '@/components/ui/DataTable'

interface User { id: number; name: string; email: string; role: string }

const columnHelper = createColumnHelper<User>()

const columns = [
  columnHelper.accessor('id', { header: 'ID' }),
  columnHelper.accessor('name', { header: 'Name' }),
  columnHelper.accessor('email', { header: 'Email', enableSorting: false }),
  columnHelper.accessor('role', { header: 'Role' }),
]

const data: User[] = [
  { id: 1, name: 'Alice Johnson', email: 'alice@example.com', role: 'Admin' },
  // ...
]

export default function Page() {
  return <DataTable columns={columns} data={data} pageSize={5} />
}

Variants

Striped & Bordered

ID⇅	Name⇅	Email	Role⇅	Status⇅
1	Alice Johnson	alice@example.com	Admin	Active
2	Bob Smith	bob@example.com	Editor	Active
3	Carol White	carol@example.com	Viewer	Inactive
4	David Lee	david@example.com	Editor	Active
5	Eva Martinez	eva@example.com	Admin	Active

Page 1 of 2 · 8 rows

Compact (no pagination)

ID⇅	Name⇅	Email	Role⇅	Status⇅
1	Alice Johnson	alice@example.com	Admin	Active
2	Bob Smith	bob@example.com	Editor	Active
3	Carol White	carol@example.com	Viewer	Inactive
4	David Lee	david@example.com	Editor	Active

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a ui component named DataTable in React/Next.js.
Goal: recreate the same overall UI and behavior as the DataTable reference from a component gallery.
What it needs to communicate: Sortable, paginated data table powered by @tanstack/react-table..

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Keep the API concise and reusable.
- Make visual states feel polished and consistent across variants and sizes.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- columns: ColumnDef<TData>[] — required — Column definitions from @tanstack/react-table
- data: TData[] — required — Row data array
- pageSize: number — default 10 — Rows per page
- showPagination: boolean — default true — Show pagination controls
- striped: boolean — default false — Alternate row colors
- bordered: boolean — default false — Add border around table
- compact: boolean — default false — Reduce cell padding

Reference usage patterns:
- No examples were documented. Infer a sensible default presentation and one richer usage example.

Feature expectations:
- Column sorting with visual indicator
- Client-side pagination
- Striped and bordered variants
- Compact mode for dense data
- Generic type-safe column definitions

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`columns`*	`ColumnDef<TData>[]`	-	Column definitions from @tanstack/react-table
`data`*	`TData[]`	-	Array of row data objects
`pageSize`	`number`	`10`	Number of rows per page
`showPagination`	`boolean`	`true`	Show pagination controls
`striped`	`boolean`	`false`	Alternate row background colors
`bordered`	`boolean`	`false`	Add border around the table
`compact`	`boolean`	`false`	Reduce cell padding for dense display
`className`	`string`	-	Extra CSS classes for the wrapper

← Back to UI Components