openstatus
Plugins from openstatus for building data-heavy React interfaces.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/openstatushq/data-table-filters with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/openstatushq/data-table-filters'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/openstatushq--data-table-filters)HTML
<a href="/listings/openstatushq--data-table-filters"><img src="/api/listings/openstatushq--data-table-filters/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
> **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.
One command installs the core block and the schema system:
npx shadcn@latest add @data-table-filters/data-table @data-table-filters/data-table-schema
Then render a table from any array of objects — columns, filters, and cell renderers are inferred:
import { DataTableAuto } from "@/components/data-table/data-table-auto";
const data = [
{
name: "Alice",
role: "admin",
rating: 5,
created_at: "2026-01-15T10:00:00Z",
},
{ name: "Bob", role: "user", rating: 3, created_at: "2026-02-20T14:30:00Z" },
];
export default function Page() {
return <DataTableAuto data={data} />;
}Starting from nothing? One command creates the Next.js app, initializes shadcn, and installs a working example with every block it needs (add `-b radix` before `-p lyra` for Radix). Run `cd logs-viewer && pnpm dev` and open [localhost:3000/example](http://localhost:3000/example):
pnpm dlx shadcn@latest init @data-table-filters/data-table-example-infinite --name logs-viewer --template next -p lyra
Requires pnpm (`npm i -g pnpm`); `npx` and `npm run dev` work the same if you prefer npm.
From `create-next-app` to a green `next build` this takes about 30 seconds on a clean machine. See the [Quick Start](https://data-table.openstatus.dev/docs/quick-start) for the full walkthrough, and add any block below as you need it.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 24 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "openstatus",
- "description": "Plugins from openstatus for building data-heavy React interfaces.",
- "owner": {
- "name": "openstatus",
- "url": "https://github.com/openstatushq"
- },
- "plugins": [
- {
- "name": "data-table-filters",
- "source": "./",
- "description": "Install and wire up data-table-filters — filterable, sortable React data tables with server-side filtering, faceted counts, infinite scroll, and virtualization, delivered as shadcn registry blocks.",
- "version": "1.0.0",
- "author": {
- "name": "openstatus",
- "url": "https://openstatus.dev"
- },
- "homepage": "https://data-table.openstatus.dev",
- "license": "MIT",
- "category": "development",
- "tags": ["react", "data-table", "shadcn", "tanstack-table", "drizzle"]
- }
- ]
- }
README.md · README · 241 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <a href="https://data-table.openstatus.dev">
- <img src="https://data-table.openstatus.dev/assets/data-table-infinite.png" alt="data-table-filters: an infinite-scroll log table with faceted filters" width="800">
- </a>
- <h1>data-table-filters</h1>
- <p><strong>Filterable, infinite-scroll data tables for React and shadcn/ui, installed as source you own.</strong></p>
- <a href="https://github.com/openstatusHQ/data-table-filters/actions/workflows/ci.yml"><img src="https://github.com/openstatusHQ/data-table-filters/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
- <a href="https://github.com/openstatusHQ/data-table-filters/actions/workflows/registry-install.yml"><img src="https://github.com/openstatusHQ/data-table-filters/actions/workflows/registry-install.yml/badge.svg" alt="Registry install"></a>
- <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
- <a href="https://github.com/openstatusHQ/data-table-filters"><img src="https://img.shields.io/github/stars/openstatusHQ/data-table-filters?style=social" alt="GitHub stars"></a>
- <a href="https://data-table.openstatus.dev">Website</a> •
- <a href="https://data-table.openstatus.dev/docs">Documentation</a> •
- <a href="https://data-table.openstatus.dev/docs/quick-start">Quick Start</a> •
- <a href="https://data-table.openstatus.dev/infinite">Live Demo</a>
- <p align="center">
- <a href="https://vercel.com/open-source-program">
- <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
- </a>
- </p>
- <sub>Built by <a href="https://www.openstatus.dev">openstatus</a>, and used in production in the openstatus dashboard.</sub>
- </div>
- ## Why data-table-filters?
- - **One schema, everything generated.** A single `createTableSchema` definition drives the columns, filter controls, row detail sheet, Drizzle route handler, and MCP tool schema.
- - **Filtering that scales.** Faceted filters (checkbox, input, slider, timerange), sorting, infinite scroll, and virtualization. With Postgres, filtering, facet counts, and cursor pagination run in SQL.
- - **You own the code.** Blocks install as source through the shadcn CLI, so you change what you need. Works with both Base UI and Radix.
- - **Bring your own store.** Keep filter state in the URL (nuqs), zustand, memory, or your own adapter.
- - **AI-ready.** Natural-language filtering, an MCP endpoint for agents, and a Claude Code plugin that sets the table up for you.
- - **Tested against the real CLI.** CI installs the blocks into fresh Next.js apps and typechecks them on every registry change and nightly.
- ## Quick Start
- > **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.
- One command installs the core block and the schema system:
- ```bash
- npx shadcn@latest add @data-table-filters/data-table @data-table-filters/data-table-schema
- ```
- Then render a table from any array of objects — columns, filters, and cell renderers are inferred:
- ```tsx
- import { DataTableAuto } from "@/components/data-table/data-table-auto";
- const data = [
- {
- name: "Alice",
- role: "admin",
- rating: 5,
- created_at: "2026-01-15T10:00:00Z",
- },
- { name: "Bob", role: "user", rating: 3, created_at: "2026-02-20T14:30:00Z" },
- ];
- export default function Page() {
- return <DataTableAuto data={data} />;
- }
- ```
- Starting from nothing? One command creates the Next.js app, initializes shadcn, and installs a working example with every block it needs (add `-b radix` before `-p lyra` for Radix). Run `cd logs-viewer && pnpm dev` and open [localhost:3000/example](http://localhost:3000/example):
- ```bash
- pnpm dlx shadcn@latest init @data-table-filters/data-table-example-infinite --name logs-viewer --template next -p lyra
- ```
- Requires pnpm (`npm i -g pnpm`); `npx` and `npm run dev` work the same if you prefer npm.
- From `create-next-app` to a green `next build` this takes about 30 seconds on a clean machine. See the [Quick Start](https://data-table.openstatus.dev/docs/quick-start) for the full walkthrough, and add any block below as you need it.
- ## Blocks
- | Block | Install | What it adds |
- | ------------------------------ | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
- | `data-table` | `@data-table-filters/data-table` | Core: table engine, store, 4 filter types, memory adapter |
- | `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 |
- | `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 |
- | `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 |
- | `data-table-mcp` | `@data-table-filters/data-table-mcp` | MCP server endpoint for AI agents |
- | `data-table-actions` | `@data-table-filters/data-table-actions` | Row and bulk actions rendered from server metadata |
- | `data-table-remote` | `@data-table-filters/data-table-remote` | Headless table that renders from an API endpoint's manifest |
- | `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.
- ## For AI Agents
- Install the plugin in Claude Code:
- ```bash
- /plugin marketplace add openstatushq/data-table-filters
- /plugin install data-table-filters@openstatus
- ```
- Or install the skill with any agent that supports the `skills` CLI:
- ```bash
- npx skills add https://github.com/openstatushq/data-table-filters --skill data-table-filters
- ```
- Then just say "add a filterable data table" — the skill detects your stack, installs the right blocks, generates a schema, and wires everything up.
- Or point any MCP client at the docs and let the agent ask them questions —
- `search_docs`, `get_doc`, `list_blocks`, `get_install_plan`:
- ```bash
- claude mcp add --transport http data-table-filters https://data-table.openstatus.dev/api/mcp
- ```
- Machine-readable docs, for agents without the skill:
- | Endpoint | What it is |
- | ------------------------------------------------------------------- | ---------------------------------------------------- |
- | [`/api/mcp`](https://data-table.openstatus.dev/api/mcp) | These docs as an MCP server (Streamable HTTP) |
- | [`/llms.txt`](https://data-table.openstatus.dev/llms.txt) | Index: blocks, install recipes, docs links |
- | [`/llms-full.txt`](https://data-table.openstatus.dev/llms-full.txt) | Every documentation page in one file |
- | [`/r/index.md`](https://data-table.openstatus.dev/r/index.md) | Block catalog with install commands and dependencies |
- | `/docs/<page>.md` | Any docs page as raw markdown |
- Cursor users can copy [`.cursor/rules/data-table-filters.mdc`](./.cursor/rules/data-table-filters.mdc) into their project; [`AGENTS.md`](./AGENTS.md) covers every other agent. See the [For AI Agents](https://data-table.openstatus.dev/docs/agents) docs page for the full rundown.
- ## Table Schema
- Define your entire table — columns, filters, display, sorting, row details — in one place with `createTableSchema` and `col.*` factories.
- ```tsx
- import {
- col,
- createTableSchema,
- type InferTableType,
- } from "@/lib/table-schema";
- const LEVELS = ["error", "warn", "info", "debug"] as const;
- export const tableSchema = createTableSchema({
- level: col.presets.logLevel(LEVELS),
- date: col.presets.timestamp().label("Date").size(200).sheet(),
- latency: col.presets
- .duration("ms")
- .label("Latency")
- .sortable()
- .size(110)
- .sheet(),
- status: col.presets.httpStatus().label("Status").size(60),
- host: col.string().label("Host").size(125).sheet(),
- });
- export type ColumnSchema = InferTableType<typeof tableSchema.definition>;
- ```
- **Generators** produce everything the table components need from a single schema:
- ```tsx
- const columns = generateColumns<ColumnSchema>(tableSchema.definition);
- const filterFields = generateFilterFields<ColumnSchema>(tableSchema.definition);
- const sheetFields = generateSheetFields<ColumnSchema>(tableSchema.definition);
- ```
- **Presets** cover common patterns: `logLevel`, `httpStatus`, `httpMethod`, `duration`, `timestamp`, `traceId`, `pathname`.
- ## Examples
- - [`/default`](https://data-table.openstatus.dev/default) — client-side pagination (nuqs or zustand)
- - [`/infinite`](https://data-table.openstatus.dev/infinite) — infinite scroll with server-side filtering, live mode, row details
- - [`/drizzle`](https://data-table.openstatus.dev/drizzle) — Drizzle ORM + Supabase PostgreSQL with cursor-based pagination, faceted search, and live data via Vercel cron
- - [`/headless`](https://data-table.openstatus.dev/headless) — a table with no schema of its own: paste a manifest URL and it renders that endpoint
- - [`/light`](https://data-table.openstatus.dev/light) — OpenStatus Light Viewer (UI for [`vercel-edge-ping`](https://github.com/OpenStatusHQ/vercel-edge-ping))
- - [`/builder`](https://data-table.openstatus.dev/builder) — interactive schema builder (paste JSON/CSV, live table preview, export TS)
- ## BYOS (Bring Your Own Store)
- A pluggable adapter pattern for filter state management. Three built-in adapters:
- - **nuqs** — URL-based state (shareable URLs, browser history)
- - **zustand** — client-side state (existing store integration)
- - **memory** — ephemeral in-memory state (embedded tables, builder)
- Or implement the `StoreAdapter` interface for a custom solution. See the [Docs](https://data-table.openstatus.dev/docs) for details.
- ## Built With
- - [nextjs](https://nextjs.org)
- - [tanstack-query](https://tanstack.com/query/latest)
- - [tanstack-table](https://tanstack.com/table/latest)
- - [shadcn/ui](https://ui.shadcn.com)
- - [cmdk](http://cmdk.paco.me)
- - [nuqs](http://nuqs.47ng.com)
- - [zustand](https://zustand.docs.pmnd.rs)
- - [drizzle-orm](https://orm.drizzle.team)
- - [zod](https://zod.dev)
- - [superjson](https://github.com/flightcontrolhq/superjson)
- - [date-fns](https://date-fns.org)
- - [recharts](https://recharts.org)
- - [dnd-kit](https://dndkit.com)
- ## Documentation
- Full documentation lives at [data-table.openstatus.dev/docs](https://data-table.openstatus.dev/docs):
- - [Quick Start](https://data-table.openstatus.dev/docs/quick-start)
- - [For AI Agents](https://data-table.openstatus.dev/docs/agents)
- - [Block catalog](https://data-table.openstatus.dev/r/index.md)
- ## Contributing
- Contributions are welcome. To run the docs site and demos locally:
- ```bash
- pnpm install
- pnpm dev
- ```
- Open [localhost:3000](http://localhost:3000). No environment variables are needed for the default examples; the Drizzle example needs `DATABASE_URL` set to a PostgreSQL connection string.
- Before opening a PR, run `pnpm format`, `pnpm lint`, `pnpm typecheck`, and `pnpm test`. Rebuild the registry with `pnpm registry:build` if you touched `packages/registry/src/`.
- ## Built by openstatus
- data-table-filters is built and maintained by [openstatus](https://www.openstatus.dev), the open-source uptime monitoring and status page platform. It powers the tables in the openstatus dashboard.
- Looking for a specific use case, or want to hire us? Write to [hire@openstatus.dev](mailto:hire@openstatus.dev) or [book a call](https://cal.com/team/openstatus/30min). You can also [sponsor openstatus](https://github.com/sponsors/openstatusHQ) on GitHub.
- ## Credits
- - [sadmann17](https://x.com/sadmann17) for the dope `<Sortable />` component around `@dnd-kit` (see [sortable.sadmn.com](https://sortable.sadmn.com))
- - [shelwin\_](https://x.com/shelwin_) for the draggable chart inspiration (see [zoom-chart-demo.vercel.app](https://zoom-chart-demo.vercel.app))
- ## License
- [MIT](./LICENSE) © [openstatus](https://www.openstatus.dev)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.