Data Table Filters

A shadcn registry for building filterable, sortable data tables with infinite scroll and virtualization. Start with the core block, then extend with optional blocks for command palette, cell renderers, sheet panels, store adapters, schema generation, Drizzle ORM helpers, and React Query integration.

Registry Blocks

Install any block via npx shadcn@latest add <url> . The CLI handles dependencies, path rewriting, and CSS variable injection.

Block Install URL What it adds

data-table https://data-table.openstatus.dev/r/data-table.json

Core: table engine, store, 4 filter types, memory adapter (~52 files)

data-table-filter-command .../r/data-table-filter-command.json

Command palette with history + keyboard shortcuts

data-table-cell .../r/data-table-cell.json

8 cell renderers (text, code, badge, boolean, number, status-code, level-indicator, timestamp)

data-table-sheet .../r/data-table-sheet.json

Row detail side panel (auto-installs cells)

data-table-nuqs .../r/data-table-nuqs.json

nuqs URL state adapter

data-table-zustand .../r/data-table-zustand.json

zustand state adapter

data-table-schema .../r/data-table-schema.json

Declarative schema system with col.* factories

data-table-drizzle .../r/data-table-drizzle.json

Drizzle ORM server-side helpers (auto-installs schema)

data-table-query .../r/data-table-query.json

React Query infinite query integration

All URLs use base https://data-table.openstatus.dev .

Quick Start

• Run scripts/detect-stack.sh to detect the user's project setup

• Install core: npx shadcn@latest add https://data-table.openstatus.dev/r/data-table.json

• Scaffold a minimal working table (see below)

• Extend with additional blocks as needed

Next.js? Use the data-table-filters repo as a reference — it's a full Next.js app with all blocks wired up.

Minimal Working Table (Memory Adapter)

Note: DataTableInfinite internally renders DataTableProvider , which already wraps children with ControlsProvider and DataTableStoreSync . You do NOT need to add these separately. The only wrapper you need is DataTableStoreProvider (for the BYOS adapter).

"use client"; import { DataTableInfinite } from "@/components/data-table/data-table-infinite"; import type { DataTableFilterField } from "@/components/data-table/types"; import { useMemoryAdapter } from "@/lib/store/adapters/memory"; import { DataTableStoreProvider } from "@/lib/store/provider/DataTableStoreProvider"; import type { ColumnDef } from "@tanstack/react-table";

const columns: ColumnDef<YourData>[] = [ /* user's columns / ]; const filterFields: DataTableFilterField<YourData>[] = [ / user's filters */ ];

export function MyTable({ data }: { data: YourData[] }) { const adapter = useMemoryAdapter(/* schema definition */); return ( <DataTableStoreProvider adapter={adapter}> <DataTableInfinite columns={columns} data={data} filterFields={filterFields} /> </DataTableStoreProvider> ); }

Wiring Extension Blocks

After installing a block via npx shadcn@latest add , wire it into the table.

Command Palette → commandSlot

<DataTableInfinite commandSlot={<DataTableFilterCommand schema={schema} tableId="my-table" />} />

Sheet Detail Panel → sheetSlot

<DataTableInfinite sheetSlot={ <DataTableSheetDetails title="Details">{content}</DataTableSheetDetails> } />

Cell Renderers → column definitions

import { DataTableCellBadge } from "@/components/data-table/data-table-cell"; // Use in columnDef.cell

Custom Filter Types → FILTER_COMPONENTS

All 4 filter types ship with core. To add custom types:

import { FILTER_COMPONENTS } from "@/components/data-table/data-table-filter-controls"; FILTER_COMPONENTS.myCustom = MyCustomFilterComponent;

All Slot Props

DataTableInfinite accepts: commandSlot , sheetSlot , toolbarActions , chartSlot , footerSlot .

See references/component-catalog.md for full wiring details.

Store Adapter Configuration

• memory (default) — Ephemeral, zero config. For prototyping, embedded components, builders.

• nuqs — URL state. Shareable links, bookmarkable filters. Requires framework setup.

• zustand — Client state. For existing zustand apps, complex app state.

Install adapter block, swap in provider. See references/store-adapters.md.

Schema Generation

Install: npx shadcn@latest add .../r/data-table-schema.json

Map data model → createTableSchema

• col.* :

• string → col.string().filterable("input")

• number → col.number().filterable("slider", { min, max })

• boolean → col.boolean().filterable("checkbox")

• Date → col.timestamp().filterable("timerange")

• enum → col.enum(values).filterable("checkbox")

Presets: col.presets.logLevel() , .httpStatus() , .duration() , .timestamp() , .traceId() , .pathname() , .httpMethod() .

See references/schema-api.md.

Server-Side Integration

Install: npx shadcn@latest add .../r/data-table-drizzle.json

Scaffold route handler with createDrizzleHandler({ db, table, columnMapping, cursorColumn, schema }) .

For non-Drizzle ORMs: implement response shape { data, facets, totalRowCount, filterRowCount, nextCursor, prevCursor } .

See references/drizzle-integration.md.

Fetch Layer

Install: npx shadcn@latest add .../r/data-table-query.json

Wire createDataTableQueryOptions({ queryKeyPrefix, apiEndpoint, searchParamsSerializer }) .

See references/fetch-layer.md.

Troubleshooting

• Missing CSS vars: Core injects --color-success/warning/error/info . Check cssVars applied to CSS.

• Import path mismatches: shadcn CLI rewrites @/ paths per components.json aliases.

• nuqs: silent failure or crash: Two required setup steps — <NuqsAdapter> in root layout AND <Suspense> around the table component. See references/store-adapters.md.

• nuqs: filters not applied from URL on load: Pass server-parsed search params as initialState to the nuqs adapter. See the SSR Hydration section in references/store-adapters.md.

• nuqs: phantom filters with empty string: Use field.string() (null default), not field.string().default("") .

• Sheet dropdown missing: SheetField.type must match the filter type (not "readonly" ) to get the filter dropdown. Use generateSheetFields() to auto-derive from filter config.

• Filter not rendering: Verify filter type string matches FILTER_COMPONENTS key.

• Tailwind v4: Registry targets v4. Class syntax differs from v3.