Skip to content
Back to search

openstatus

MarketplaceWorks with Claude CodeGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/openstatushq--data-table-filters/badge.svg)](/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.

  1. {
  2. "name": "openstatus",
  3. "description": "Plugins from openstatus for building data-heavy React interfaces.",
  4. "owner": {
  5. "name": "openstatus",
  6. "url": "https://github.com/openstatushq"
  7. },
  8. "plugins": [
  9. {
  10. "name": "data-table-filters",
  11. "source": "./",
  12. "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.",
  13. "version": "1.0.0",
  14. "author": {
  15. "name": "openstatus",
  16. "url": "https://openstatus.dev"
  17. },
  18. "homepage": "https://data-table.openstatus.dev",
  19. "license": "MIT",
  20. "category": "development",
  21. "tags": ["react", "data-table", "shadcn", "tanstack-table", "drizzle"]
  22. }
  23. ]
  24. }
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.

  1. <div align="center">
  2. <a href="https://data-table.openstatus.dev">
  3. <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">
  4. </a>
  5. <h1>data-table-filters</h1>
  6. <p><strong>Filterable, infinite-scroll data tables for React and shadcn/ui, installed as source you own.</strong></p>
  7. <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>
  8. <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>
  9. <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
  10. <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>
  11. <a href="https://data-table.openstatus.dev">Website</a> •
  12. <a href="https://data-table.openstatus.dev/docs">Documentation</a> •
  13. <a href="https://data-table.openstatus.dev/docs/quick-start">Quick Start</a> •
  14. <a href="https://data-table.openstatus.dev/infinite">Live Demo</a>
  15. <p align="center">
  16. <a href="https://vercel.com/open-source-program">
  17. <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
  18. </a>
  19. </p>
  20. <sub>Built by <a href="https://www.openstatus.dev">openstatus</a>, and used in production in the openstatus dashboard.</sub>
  21. </div>
  22. ## Why data-table-filters?
  23. - **One schema, everything generated.** A single `createTableSchema` definition drives the columns, filter controls, row detail sheet, Drizzle route handler, and MCP tool schema.
  24. - **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.
  25. - **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.
  26. - **Bring your own store.** Keep filter state in the URL (nuqs), zustand, memory, or your own adapter.
  27. - **AI-ready.** Natural-language filtering, an MCP endpoint for agents, and a Claude Code plugin that sets the table up for you.
  28. - **Tested against the real CLI.** CI installs the blocks into fresh Next.js apps and typechecks them on every registry change and nightly.
  29. ## Quick Start
  30. > **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.
  31. One command installs the core block and the schema system:
  32. ```bash
  33. npx shadcn@latest add @data-table-filters/data-table @data-table-filters/data-table-schema
  34. ```
  35. Then render a table from any array of objects — columns, filters, and cell renderers are inferred:
  36. ```tsx
  37. import { DataTableAuto } from "@/components/data-table/data-table-auto";
  38. const data = [
  39. {
  40. name: "Alice",
  41. role: "admin",
  42. rating: 5,
  43. created_at: "2026-01-15T10:00:00Z",
  44. },
  45. { name: "Bob", role: "user", rating: 3, created_at: "2026-02-20T14:30:00Z" },
  46. ];
  47. export default function Page() {
  48. return <DataTableAuto data={data} />;
  49. }
  50. ```
  51. 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):
  52. ```bash
  53. pnpm dlx shadcn@latest init @data-table-filters/data-table-example-infinite --name logs-viewer --template next -p lyra
  54. ```
  55. Requires pnpm (`npm i -g pnpm`); `npx` and `npm run dev` work the same if you prefer npm.
  56. 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.
  57. ## Blocks
  58. | Block | Install | What it adds |
  59. | ------------------------------ | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
  60. | `data-table` | `@data-table-filters/data-table` | Core: table engine, store, 4 filter types, memory adapter |
  61. | `data-table-filter-command` | `@data-table-filters/data-table-filter-command` | Command palette with history + keyboard shortcuts |
  62. | `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) |
  63. | `data-table-sheet` | `@data-table-filters/data-table-sheet` | Row detail side panel |
  64. | `data-table-nuqs` | `@data-table-filters/data-table-nuqs` | nuqs URL state adapter |
  65. | `data-table-zustand` | `@data-table-filters/data-table-zustand` | zustand state adapter |
  66. | `data-table-schema` | `@data-table-filters/data-table-schema` | Declarative schema system with `col.*` factories |
  67. | `data-table-drizzle` | `@data-table-filters/data-table-drizzle` | Drizzle ORM server-side helpers |
  68. | `data-table-query` | `@data-table-filters/data-table-query` | React Query infinite query integration |
  69. | `data-table-filter-command-ai` | `@data-table-filters/data-table-filter-command-ai` | AI-powered natural language → filter inference |
  70. | `data-table-mcp` | `@data-table-filters/data-table-mcp` | MCP server endpoint for AI agents |
  71. | `data-table-actions` | `@data-table-filters/data-table-actions` | Row and bulk actions rendered from server metadata |
  72. | `data-table-remote` | `@data-table-filters/data-table-remote` | Headless table that renders from an API endpoint's manifest |
  73. | `data-table-chart` | `@data-table-filters/data-table-chart` | Timeline chart over the table: stacked buckets per level, drag to zoom the time filter |
  74. | `data-table-example-infinite` | `@data-table-filters/data-table-example-infinite` | Ready-to-run `/example` route: schema, mock API, infinite table with URL state |
  75. Blocks install by name from the shadcn registry directory; the JSON form `https://data-table.openstatus.dev/r/<block>.json` works too.
  76. ## For AI Agents
  77. Install the plugin in Claude Code:
  78. ```bash
  79. /plugin marketplace add openstatushq/data-table-filters
  80. /plugin install data-table-filters@openstatus
  81. ```
  82. Or install the skill with any agent that supports the `skills` CLI:
  83. ```bash
  84. npx skills add https://github.com/openstatushq/data-table-filters --skill data-table-filters
  85. ```
  86. Then just say "add a filterable data table" — the skill detects your stack, installs the right blocks, generates a schema, and wires everything up.
  87. Or point any MCP client at the docs and let the agent ask them questions —
  88. `search_docs`, `get_doc`, `list_blocks`, `get_install_plan`:
  89. ```bash
  90. claude mcp add --transport http data-table-filters https://data-table.openstatus.dev/api/mcp
  91. ```
  92. Machine-readable docs, for agents without the skill:
  93. | Endpoint | What it is |
  94. | ------------------------------------------------------------------- | ---------------------------------------------------- |
  95. | [`/api/mcp`](https://data-table.openstatus.dev/api/mcp) | These docs as an MCP server (Streamable HTTP) |
  96. | [`/llms.txt`](https://data-table.openstatus.dev/llms.txt) | Index: blocks, install recipes, docs links |
  97. | [`/llms-full.txt`](https://data-table.openstatus.dev/llms-full.txt) | Every documentation page in one file |
  98. | [`/r/index.md`](https://data-table.openstatus.dev/r/index.md) | Block catalog with install commands and dependencies |
  99. | `/docs/<page>.md` | Any docs page as raw markdown |
  100. 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.
  101. ## Table Schema
  102. Define your entire table — columns, filters, display, sorting, row details — in one place with `createTableSchema` and `col.*` factories.
  103. ```tsx
  104. import {
  105. col,
  106. createTableSchema,
  107. type InferTableType,
  108. } from "@/lib/table-schema";
  109. const LEVELS = ["error", "warn", "info", "debug"] as const;
  110. export const tableSchema = createTableSchema({
  111. level: col.presets.logLevel(LEVELS),
  112. date: col.presets.timestamp().label("Date").size(200).sheet(),
  113. latency: col.presets
  114. .duration("ms")
  115. .label("Latency")
  116. .sortable()
  117. .size(110)
  118. .sheet(),
  119. status: col.presets.httpStatus().label("Status").size(60),
  120. host: col.string().label("Host").size(125).sheet(),
  121. });
  122. export type ColumnSchema = InferTableType<typeof tableSchema.definition>;
  123. ```
  124. **Generators** produce everything the table components need from a single schema:
  125. ```tsx
  126. const columns = generateColumns<ColumnSchema>(tableSchema.definition);
  127. const filterFields = generateFilterFields<ColumnSchema>(tableSchema.definition);
  128. const sheetFields = generateSheetFields<ColumnSchema>(tableSchema.definition);
  129. ```
  130. **Presets** cover common patterns: `logLevel`, `httpStatus`, `httpMethod`, `duration`, `timestamp`, `traceId`, `pathname`.
  131. ## Examples
  132. - [`/default`](https://data-table.openstatus.dev/default) — client-side pagination (nuqs or zustand)
  133. - [`/infinite`](https://data-table.openstatus.dev/infinite) — infinite scroll with server-side filtering, live mode, row details
  134. - [`/drizzle`](https://data-table.openstatus.dev/drizzle) — Drizzle ORM + Supabase PostgreSQL with cursor-based pagination, faceted search, and live data via Vercel cron
  135. - [`/headless`](https://data-table.openstatus.dev/headless) — a table with no schema of its own: paste a manifest URL and it renders that endpoint
  136. - [`/light`](https://data-table.openstatus.dev/light) — OpenStatus Light Viewer (UI for [`vercel-edge-ping`](https://github.com/OpenStatusHQ/vercel-edge-ping))
  137. - [`/builder`](https://data-table.openstatus.dev/builder) — interactive schema builder (paste JSON/CSV, live table preview, export TS)
  138. ## BYOS (Bring Your Own Store)
  139. A pluggable adapter pattern for filter state management. Three built-in adapters:
  140. - **nuqs** — URL-based state (shareable URLs, browser history)
  141. - **zustand** — client-side state (existing store integration)
  142. - **memory** — ephemeral in-memory state (embedded tables, builder)
  143. Or implement the `StoreAdapter` interface for a custom solution. See the [Docs](https://data-table.openstatus.dev/docs) for details.
  144. ## Built With
  145. - [nextjs](https://nextjs.org)
  146. - [tanstack-query](https://tanstack.com/query/latest)
  147. - [tanstack-table](https://tanstack.com/table/latest)
  148. - [shadcn/ui](https://ui.shadcn.com)
  149. - [cmdk](http://cmdk.paco.me)
  150. - [nuqs](http://nuqs.47ng.com)
  151. - [zustand](https://zustand.docs.pmnd.rs)
  152. - [drizzle-orm](https://orm.drizzle.team)
  153. - [zod](https://zod.dev)
  154. - [superjson](https://github.com/flightcontrolhq/superjson)
  155. - [date-fns](https://date-fns.org)
  156. - [recharts](https://recharts.org)
  157. - [dnd-kit](https://dndkit.com)
  158. ## Documentation
  159. Full documentation lives at [data-table.openstatus.dev/docs](https://data-table.openstatus.dev/docs):
  160. - [Quick Start](https://data-table.openstatus.dev/docs/quick-start)
  161. - [For AI Agents](https://data-table.openstatus.dev/docs/agents)
  162. - [Block catalog](https://data-table.openstatus.dev/r/index.md)
  163. ## Contributing
  164. Contributions are welcome. To run the docs site and demos locally:
  165. ```bash
  166. pnpm install
  167. pnpm dev
  168. ```
  169. 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.
  170. 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/`.
  171. ## Built by openstatus
  172. 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.
  173. 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.
  174. ## Credits
  175. - [sadmann17](https://x.com/sadmann17) for the dope `<Sortable />` component around `@dnd-kit` (see [sortable.sadmn.com](https://sortable.sadmn.com))
  176. - [shelwin\_](https://x.com/shelwin_) for the draggable chart inspiration (see [zoom-chart-demo.vercel.app](https://zoom-chart-demo.vercel.app))
  177. ## License
  178. [MIT](./LICENSE) © [openstatus](https://www.openstatus.dev)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.