Skip to content
kadalccPublic

About

Open-source React components for power users: a data grid on TanStack Table v9 and shadcn/ui that one command copies into your project. MIT.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Kadal UI

Components you own.

Open-source React components for power users, starting with a data grid on TanStack Table v9 and shadcn/ui. One command copies the source into your project. MIT.

npm version npm downloads a month CI Licence: MIT shadcn registry Sponsor Kadal UI

A data grid is where your users spend their day, and the one component every vendor sells you with a licence key. Kadal UI's grid is MIT and it lives in your repository: sorting, faceted filters, fuzzy search, grouping with aggregation, 50,000 virtualised rows, inline editing, spreadsheet-style keyboard ranges and clipboard, export, saved views and URL state, typed from the row to the cell. It is built on TanStack Table v9 and the Base UI flavour of shadcn/ui, and it is distributed as a shadcn registry, so you install it the way you install a shadcn button and change it the way you change one.

npx shadcn@latest add @kadal/data-grid

The Kadal UI data grid: a toolbar with search, filter chips and a grouping bar; a table with a pinned column, multi-sort badges, status badges, formatted currency and percentages, a selected range of cells; the pager underneath

Your first grid in 5 minutes →
Or try every feature in the playground, no install.

Docs · Data grid · API · Playground · Changelog · Sponsor


Start in 30 seconds

You need a React 19 project with Tailwind CSS v4 and shadcn/ui set up for Base UI (npx shadcn@latest init -b base). Then:

npx shadcn@latest add @kadal/data-grid       # or: npx @kadal/ui add data-grid

That copies the grid's 21 TypeScript files into components/ui/data-grid/, adds the shadcn primitives it uses, and installs TanStack Table, TanStack Virtual and dnd kit. No CSS to import: it is Tailwind over your theme tokens, so it takes your colours and dark mode as they are.

import { DataGrid, createDataGridColumns } from "@/components/ui/data-grid"

type Order = { id: string; customer: string; status: "paid" | "open" | "refunded"; total: number; placedAt: Date }

const col = createDataGridColumns<Order>()
const columns = col.columns([
  col.select(),
  col.text("customer", { header: "Customer", editable: true }),
  col.enum("status", { options: [{ value: "paid", label: "Paid" }, { value: "open", label: "Open" }, { value: "refunded", label: "Refunded" }] }),
  col.currency("total", { header: "Total", currency: "EUR" }),
  col.date("placedAt", { header: "Placed" }),
  col.actions(({ row }) => <OrderMenu order={row.original} />),
])

export function Orders({ orders }: { orders: Order[] }) {
  return (
    <DataGrid
      data={orders}
      columns={columns}
      getRowId={(o) => o.id}
      persist="orders"
      onCellEdit={({ row, columnId, value }) => save(row.id, columnId, value)}
      bulkActions={(rows) => <Button onClick={() => archive(rows)}>Archive {rows.length}</Button>}
    />
  )
}

What's in the grid

Typed columns (docs) A builder per column kind (text, number, currency, percent, date, datetime, boolean, enum, tags, link, …) that checks keys against your row type and types format, validate and onEdit to the real value. Each kind brings its sort, filter, editor, aggregation and export format.
Sorting (docs) Click to sort, shift-click to add a key, numbered badges, a menu for the rest.
Filtering (docs) Facets with counts and search, text operators, number and date ranges, booleans; chips to clear; filter values that round-trip through URLs.
Search (docs) Fuzzy, ranked, across every data column, debounced.
Pagination or 50,000 rows (docs) A pager with page size, go-to-page and counts, or virtualised rows with the sticky header and pinning intact.
Selection and bulk actions (docs) Checkboxes, shift-click ranges, select all on the page, a bar for what happens next.
Pin, reorder, resize, hide (docs) Pin to either end (logical start/end, RTL-aware), drag headers, drag edges or double-click to fit, a searchable column list.
Group and aggregate (docs) Group by any column; sums, means, counts and ranges in group rows and footers, formatted like the column.
Tree data (docs) Nested rows with an expander column and selection that follows the tree.
Inline editing (docs) Enter, F2 or double-click; text, number, select, checkbox, date and textarea editors; validation; Tab moves on.
Keyboard and clipboard (docs) Arrow keys, Home/End, PageUp/Down, Shift to extend a range, ⌘A, ⌘C as tab-separated text that pastes into a spreadsheet.
Export (docs) CSV and JSON of what's on screen or the selection, values as displayed.
Saved views and URL state (docs) Columns, sort, sizes, pinning, order, grouping, density and page size remembered per user; named views; filters, search and page in the URL with nuqs.
Server-side (docs) Hand it a page and a row count; sort and filter state comes back for your query (a TanStack Query example included).
States, density, row pinning Loading, error and empty states; compact/comfortable/spacious; rows pinned top or bottom.
Accessible, translatable, composable A real grid with roles, aria-sort, roving focus and live announcements; every label a function you can replace; every part usable on its own.

Not a dependency. Your code.

The registry copies source, not a build. After add, the grid is yours: rename a label, swap an icon, delete a feature, add a column kind. When a new version ships, npx shadcn@latest add @kadal/data-grid --diff shows what changed, and --overwrite takes it. Keep your own additions in files next to the grid and the overwrite stays painless.

What you get is current: React 19, TypeScript 7, Tailwind v4, shadcn/ui on Base UI (the default since July 2026), TanStack Table v9 (tree-shaken features, store-based state, React Compiler safe).

Registry

Item Install
data-grid The grid: 21 files under components/ui/data-grid/ npx shadcn@latest add @kadal/data-grid
data-grid-url-state Filters, search and page in the URL (nuqs) npx shadcn@latest add @kadal/data-grid-url-state
data-grid-demo-data The seeded demo rows the docs use npx shadcn@latest add @kadal/data-grid-demo-data
data-grid-basic, data-grid-sorting, … (30 examples, one per docs page) The examples from the docs, as files npx shadcn@latest add @kadal/data-grid-demo

Register the namespace once in components.json ("registries": { "@kadal": "https://ui.kadal.cc/r/{name}.json" }), or let the CLI do it. Without a namespace: npx shadcn@latest add kadalcc/ui/data-grid installs straight from this repository. The registry is static JSON at ui.kadal.cc/r/registry.json.

The CLI

@kadal/ui is a small, dependency-free wrapper around the shadcn CLI that knows this registry:

npx @kadal/ui add data-grid          # registers @kadal and adds the item (runs shadcn init -b base if needed)
npx @kadal/ui list                   # what's in the registry
npx @kadal/ui diff data-grid         # what changed upstream since your copy
npx @kadal/ui docs data-grid --open  # the docs page
npx @kadal/ui mcp --client claude    # the shadcn MCP server, configured for this registry

For AI agents

An Agent Skill teaches Claude Code, Cursor or any skills-aware agent to add the grid to a project and write columns for it; npx skills add kadalcc/ui installs it, and the repository is a Claude Code plugin marketplace (/plugin marketplace add kadalcc/ui). The shadcn MCP server serves this registry to any MCP client once the namespace is in components.json (npx @kadal/ui mcp). The docs are also at ui.kadal.cc/llms.txt.

Documentation

Installation · Quick start · Type safety · Theming · Every feature · API reference · CLI · Compared with other grids · FAQ

Repository

path
apps/www/registry/kadal/ui/data-grid the grid's source, the files the registry serves
apps/www/registry/kadal/examples the examples on every docs page
apps/www/registry.json the registry manifest; shadcn build writes apps/www/public/r
apps/www ui.kadal.cc: landing, docs (Astro + Starlight), playground (LiveCodes)
packages/cli @kadal/ui on npm
skills/kadal-ui the Agent Skill

bun install, bun run dev (the site, with every example live), bun run typecheck, bun run test, bun run test:e2e (Playwright on Chromium, Firefox and WebKit), bun run build. CONTRIBUTING.md has the rest.

Licence

MIT. Use it in anything, including closed-source products; keep the notice. The docs text is CC BY 4.0.

Contributing

A bug report with a playground link that reproduces it is the most useful thing you can send, and pull requests are welcome. Questions go to Discussions or the Kadal Discord; ideas to a feature request; anything else to feedback. Please follow the code of conduct, and report security issues privately as SECURITY.md describes.

Sponsors

There is no paid tier of Kadal UI. Sponsorships pay for time on issues, docs, new components and the features you ask for. Sponsor Kadal UI on GitHub; the tiers and what each one gets are on ui.kadal.cc/sponsor, and backers are listed in BACKERS.md. Companies can sponsor by invoice.

Your logo here: be the first company to sponsor Kadal UI.

More from Kadal

The paid products that also fund this work:

  • Kadal Deck, the AI presentation app: make slides with AI, rehearse them, present them live while the room follows on their phones. Its engine is open source too (kadalcc/deck).
  • Kadal Store: printable planners, music, sound effects, shaders and 3D. Pay once, keep the files.
  • Need a team that builds AI products end to end? work.kadal.cc.

Made in Chennai, India by Kadal · ui.kadal.cc · hello@kadal.cc · Contact and office

About

Open-source React components for power users: a data grid on TanStack Table v9 and shadcn/ui that one command copies into your project. MIT.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages