/data-table-filters

name: data-table-filters
description: >
  Install and extend data-table-filters — a React data table system with faceted filters
  (checkbox, input, slider, timerange), sorting, infinite scroll, virtualization, and BYOS
  state management. Delivered as 15 shadcn registry blocks installable via
  `npx shadcn@latest add`. Use when: (1) installing data-table-filters from the shadcn
  registry, (2) adding extension blocks (command palette, AI filters, cell renderers, sheet panel,
  store adapters, schema system, Drizzle helpers, query layer), (3) configuring store
  adapters (nuqs/zustand/memory), (4) generating table schemas from a data model,
  (5) wiring up server-side filtering with Drizzle ORM, (6) connecting the React Query
  fetch layer, (7) auto-inferring schemas from raw JSON data with DataTableAuto / inferSchemaFromJSON,
  (8) adding AI-powered natural language filtering, (9) exposing tables as MCP endpoints for AI agents,
  (10) troubleshooting integration issues.
  Triggers on mentions of "data-table-filters", "data-table.openstatus.dev", filterable data
  tables with shadcn, DataTableAuto, auto-infer, AI filters, MCP server, or any of the registry block names.

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.

> **Prerequisite.** Works on either shadcn library: the CLI default, Base UI (`npx shadcn@latest init -d`), or Radix (`npx shadcn@latest init -b radix -p lyra`). CI installs into both and typechecks them on every registry change and nightly.

Registry Blocks

Install any block via `npx shadcn@latest add @data-table-filters/<block>`. The CLI handles dependencies, path rewriting, and CSS variable injection.

| Block | Install | What it adds | | -------------------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **data-table** | `@data-table-filters/data-table` | Core: table engine, store, 4 filter types, memory adapter (63 files) | | **data-table-filter-command** | `@data-table-filters/data-table-filter-command` | Command palette with history + keyboard shortcuts | | **data-table-cell** | `@data-table-filters/data-table-cell` | 12 cell renderers (text, code, number, bar, heatmap, gauge, badge, boolean, star, status-code, level-indicator, timestamp) | | **data-table-sheet** | `@data-table-filters/data-table-sheet` | Row detail side panel (auto-installs cells) | | **data-table-nuqs** | `@data-table-filters/data-table-nuqs` | nuqs URL state adapter | | **data-table-zustand** | `@data-table-filters/data-table-zustand` | zustand state adapter | | **data-table-schema** | `@data-table-filters/data-table-schema` | Declarative schema system with `col.*` factories | | **data-table-drizzle** | `@data-table-filters/data-table-drizzle` | Drizzle ORM server-side helpers (auto-installs schema) | | **data-table-query** | `@data-table-filters/data-table-query` | React Query infinite query integration | | **data-table-filter-command-ai** | `@data-table-filters/data-table-filter-command-ai` | AI-powered natural language → filter inference (provider-agnostic) | | **data-table-mcp** | `@data-table-filters/data-table-mcp` | MCP server endpoint for AI agents (stateless, serverless-compatible) | | **data-table-actions** | `@data-table-filters/data-table-actions` | Row and bulk actions rendered from server metadata (requires drizzle) | | **data-table-remote** | `@data-table-filters/data-table-remote` | Headless table driven by an endpoint's manifest — schema, capabilities, row identity | | **data-table-chart** | `@data-table-filters/data-table-chart` | Timeline chart over the table: stacked buckets per level, drag to zoom the time filter | | **data-table-example-infinite** | `@data-table-filters/data-table-example-infinite` | Ready-to-run `/example` route: schema, mock API, infinite table with URL state |

Blocks install by name from the shadcn registry directory; the JSON form `https://data-table.openstatus.dev/r/<block>.json` works too.

Quick Start

1. Run `scripts/detect-stack.sh` to detect the user's project setup. It reports which component library the project is on — either works. If it prints `shadcn/ui: not initialized`, initialize with `npx shadcn@latest init -d` (or `init -b radix -p lyra` for R