Documentation

KanuniLabs DataGrid

KanuniLabs DataGrid is a high-performance data grid for React and plain JavaScript. Columns are encoded into typed arrays and the filter/sort pipeline moves to a Web Worker once the dataset gets large, so scrolling, sorting and filtering a million rows stays responsive.

Why this grid

  • Fast on large data, measurably. Sort, filter and search over 1,000,000 rows are timed against the published package. The performance guide lists every number, including the one-time cost of the first text sort and search, and the command to reproduce them.
  • Small DOM. Rows and columns are virtualized. A 100,000-row grid keeps roughly 25 rows mounted.
  • Pinned columns that cannot drift. Pinned columns are sticky cells inside a single scroll container — there is no second table to keep in sync.
  • Keyboard and screen-reader ready. A complete WAI-ARIA grid model, virtual focus, and one tab stop for the header instead of one per column.
  • Free core. Everything on this page is in the free Community package.

Packages

PackageDescriptionLicense
@kanunilabs/datagrid-reactReact components and hooksFree (proprietary)
@kanunilabs/datagridThe same grid without React — createGrid()Free (proprietary)
@kanunilabs/datagrid-coreFramework-agnostic engine (comes with either)Free (proprietary)
@kanunilabs/datagrid-react-enterpriseEditing rules and undo, master-detail, charts — ReactCommercial
@kanunilabs/datagrid-enterpriseThe same Enterprise features, no ReactCommercial

Installing a renderer pulls in the core automatically:

npm i @kanunilabs/datagrid-react
npm i @kanunilabs/datagrid

A first grid

A complete component — paste it into a React app and it renders:

import { DataGrid, type ReactGridColumnDef } from '@kanunilabs/datagrid-react';
import '@kanunilabs/datagrid-react/styles.css';

type Sale = { id: number; product: string; revenue: number };

const rows: Sale[] = [
  { id: 1, product: 'Desk lamp', revenue: 1240.5 },
  { id: 2, product: 'Office chair', revenue: 3899 },
  { id: 3, product: 'Monitor arm', revenue: 712.25 },
];

const usd = (v: unknown) =>
  typeof v === 'number' ? v.toLocaleString('en-US', { style: 'currency', currency: 'USD' }) : '';

const columns: ReactGridColumnDef<Sale>[] = [
  { field: 'id', headerName: 'ID', dataType: 'number', width: 80, pin: 'left' },
  { field: 'product', headerName: 'Product', width: 220 },
  { field: 'revenue', headerName: 'Revenue', dataType: 'number', width: 140, valueFormatter: usd },
];

export default function SalesGrid() {
  return <DataGrid gridId="sales" dataSource={rows} rowKey="id" columns={columns} style={{ height: 400 }} />;
}

In the Next.js App Router, put 'use client'; at the top of this file: the grid holds state, so it is a client component (Next.js and SSR).

Or skip the setup: the same grid on 100,000 generated rows, as a ready Vite project.

Runs in your browser: installs from npm and starts Vite. Nothing to set up.

rowKey is required — selection and focus are keyed by row identity, which is what lets them survive sorting and filtering.

Where to next

Status

The Community edition is feature-complete for its v1 scope. Cell/row/batch editing, master-detail, multi-level grouping, charts and grouping on the server ship in the Enterprise edition — in both renderers. Loading rows from a server as the user scrolls is Community.

Missing something? Tell us what you need — feature requests are read by the people who write the code.