secondsky/claude-skills / plugins/tanstack-table/skills/tanstack-table
tanstack-table
VerifiedTanStack Table v8 headless data tables with server-side features for Cloudflare Workers + D1. Use for pagination, filtering, sorting, virtualization, or encountering state management, TanStack Query coordination, URL sync errors.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.1 KB |
| references/cloudflare-d1-examples.md | markdown | 3.4 KB |
| references/common-errors.md | markdown | 4.5 KB |
| references/feature-controls.md | markdown | 4.3 KB |
| references/performance-virtualization.md | markdown | 2.4 KB |
| references/query-integration.md | markdown | 5.1 KB |
| references/server-side-patterns.md | markdown | 8.9 KB |
| templates/basic-client-table.tsx | other | 2.7 KB |
| templates/column-configuration.tsx | other | 4.1 KB |
| templates/controlled-table-state.tsx | other | 9.0 KB |
| templates/d1-database-example.tsx | other | 9.2 KB |
| templates/package.json | manifest | 631 B |
| templates/server-paginated-table.tsx | other | 6.2 KB |
| templates/shadcn-styled-table.tsx | other | 3.2 KB |
| templates/virtualized-large-dataset.tsx | other | 4.7 KB |
references/feature-controls.md
View on GitHub# Table State & Feature Controls (Column Visibility, Pinning, Ordering, Filtering, Selection)
Practical recipes for managing controlled state in TanStack Table v8 without hurting performance. Use these snippets when you need persistent UI (URL/state sync), custom toolbars, or advanced UX like pinned columns and fuzzy search.
## Minimal Controlled State
- Control only the state you actually need; letting the table manage the rest avoids unnecessary renders.
- Safe set to control together: `sorting`, `pagination`, `columnFilters`, `globalFilter`, `columnVisibility`, `columnOrder`, `columnPinning`, `rowSelection`.
- Avoid controlling `columnSizingInfo` unless you are persisting drag state—docs note it triggers frequent updates.
```ts
const table = useReactTable({
data,
columns,
state: {
sorting,
pagination,
columnFilters,
globalFilter,
columnVisibility,
columnOrder,
columnPinning,
rowSelection,
},
onSortingChange: setSorting,
onPaginationChange: setPagination,
onColumnFiltersChange: setColumnFilters,
onGlobalFilterChange: setGlobalFilter,
onColumnVisibilityChange: setColumnVisibility,
onColumnOrderChange: setColumnOrder,
onColumnPinningChange: setColumnPinning,
onRowSelectionChange: setRowSelection,
getCoreRowModel: getCoreRowModel(),
getFilteredRowModel: getFilteredRowModel(),
getSortedRowModel: getSortedRowModel(),
getPaginationRowModel: getPaginationRowModel(),
getFacetedRowModel: getFacetedRowModel(), // needed for faceting UIs
getFacetedUniqueValues: getFacetedUniqueValues(), // needed for faceted filters
})
```
## Column Visibility
- Default: all columns visible. Hide by toggling `columnVisibility` state keyed by column id.
- Provide a simple UI toggle list: `table.getAllLeafColumns().map(column => column.getCanHide() && ...)`.
- Persist visibility in URL/localStorage for user preference-heavy tables.
## Column Pinning (Freeze Columns)
- State shape: `{ left: string[]; right: string[] }`.
- Order precedence: pinning → manual column order → grouping. Changing `columnOrder` only affects center (unpinned) columns.
- Pin defaults via `initialState.columnPinning`, or control via `onColumnPinningChange`.
- Use `column.getCanPin()`, `column.pin('left' | 'right' | false)`, and `row.getLeft/Center/RightVisibleCells()` when rendering split tables.
## Column Ordering
- Control with `columnOrder: string[]`. For one-off defaults, set `initialState.columnOrder`; if you also supply `state.columnOrder`, only the controlled state is used.
- For drag-and-drop, prefer `@dnd-kit/core` over `react-dnd` (better React 18/19 compatibility).
## Filtering: Column, Global, Fuzzy, Faceted
- Enable filtering with `getFilteredRowModel: getFilteredRowModel()`.
- Fuzzy global search: set `filterFns: { fuzzy: fuzzyFilter }` and `globalFilterFn: 'fuzzy'`, where `fuzzyFilter` uses `rankItem` from `@tanstack/match-sorter-utils`.
- Faceted filters (chips/dropdowns) need `getFacetedRowModel` plus `getFacetedUniqueValues`/`getFacetedMinMaxValues`.
- Debounce text inputs (~150–300ms) to avoid chatty re-renders on every keystroke.
## Sorting
- Controlled sorting needs `state.sorting`, `onSortingChange`, and `getSortedRowModel()`.
- For server-side sorting: set `manualSorting: true` and include sorting state in your fetch key/params.
## Pagination
- Client-side: add `getPaginationRowModel()`; default page size is 10. Set `initialState.pagination` to customize.
- Server-side: set `manualPagination: true`, supply `pageCount`, and include pagination state in your fetch.
## Row Selection & Pinning
- Enable with `enableRowSelection: true`; control via `rowSelection` state and `onRowSelectionChange`.
- Pinned rows use state `{ top: string[]; bottom: string[] }`; enable with `enableRowPinning` and render pinned rows separately or with sticky CSS.
## Column Sizing
- For resizable columns: set `columnResizeMode: 'onChange' | 'onEnd'` and add `getHeaderGroups` resize handles.
- Persist widths via `columnSizing` state; avoid controlling `columnSizingInfo` unless you must capture drag-in-progress.
## Performance Guardrails
- Memoize `data` and `columns`; avoid recreating `filterFns`.
- Keep render paths light when controlling many states; prefer derived UI components (toolbars) over inline heavy logic.
- Virtualize (`@tanstack/react-virtual`) when rendering 1k+ client-side rows even with pagination to smooth scroll.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |