OpenParable
Skip to content
← Back to skills

Tanstack Table

Development
tanstack-table

Tanstack Table is an Agent Skill for development published in the EpicenterHQ/epicenter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

TanStack Table UI state patterns for @tanstack/svelte-table, @tanstack/table-core, createTable, ColumnDef, FlexRender, renderComponent, sorting, filtering, pagination, row identity, and local table markup composition. Use when building or reviewing Svelte data tables, not Epicenter workspace storage tables.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/EpicenterHQ/epicenter/blob/HEAD/.agents/skills/tanstack-table/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/tanstack-table, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

TanStack Table

Reference Repositories

  • TanStack Table - Headless table state and row models
  • Svelte - Svelte 5 component and reactivity model

Upstream Grounding

When TanStack Table adapter APIs, row models, controlled state, sorting, filtering, pagination, or Svelte rendering helpers affect correctness, ask DeepWiki a narrow question against TanStack/table. Verify against the installed @tanstack/svelte-table and @tanstack/table-core versions.

This skill is for UI table state. Use workspace-api for Epicenter CRDT table storage and migrations.

Local API Baseline

Epicenter currently uses @tanstack/svelte-table with:

import {
	createTable as createSvelteTable,
	FlexRender,
	renderComponent,
} from '@tanstack/svelte-table';
import type { ColumnDef } from '@tanstack/table-core';

Table Construction Rules

  • Always set getRowId for persisted or local-first rows. Do not rely on array index identity.
  • Keep data referentially stable. Avoid creating a fresh array in the table options getter unless the table is intentionally rebuilt.
  • Define columns with satisfies ColumnDef<Row>[].
  • Give accessor columns stable ids, especially when sorting, hiding, or persisted preferences are involved.
  • Use renderComponent for reusable header and cell components.
  • Include only row models the UI uses: core always, sorted/filter/pagination only when the surface needs them.

Controlled State

  • Control only state Epicenter owns externally, such as sorting, global filter, column visibility, row selection, or pagination.
  • If an onXChange handler is present, the matching state.get x() must also be present.
  • Keep state ownership in one component or handle. Do not split sorting, filters, and pagination across unrelated stores without a reason.

Rendering

  • TanStack Table owns row, column, and cell state. @epicenter/ui/table owns semantic table markup and styling.
  • Render headers and cells with FlexRender.
  • Key rows by row.id and cells by cell.id.
  • Empty states stay in ui-design: when row count is zero, render Empty.Root in the table body or surrounding panel.
  • Add explicit keyboard behavior for clickable rows. A click handler alone is not a row interaction model.
  • Use TanStack Virtual separately for large lists. Do not treat virtualization as a built-in table feature.