Meridianby Commenda
Components

Table

Rows of records people scan, compare and open.

Rows of records people scan, compare and open: a toolbar, an optional summary, a header, rows and pagination, in a card or flat on the page. On the site it appears in product shots and in comparison tables on product and pricing pages.

Filing
Entity
Assignee
Status
Actions
Delaware annual reportAnnual · DelawareAcme Inc.Priya SinghOverdue1 Oct 2026
VAT return Q3Monthly · Federal Central Tax OfficeAcme GmbHLucas MoreauFiled7 Nov 2026
Confirmation statementAnnual · Companies HouseAcme UK LtdAisha KhanDue soon14 Nov 2026
GST returnQuarterly · IRASAcme Pte. Ltd.Jun TanIn review30 Nov 2026
Annual accountsAnnual · KVKAcme B.V.Mira de VriesNot started31 Jan 2027
1–5 of 5
Rows per page

Usage

Example.tsx
import { Table, TableCell } from "@commenda/meridian/ui/table";

<Table
  label="Filings"
  rows={filings}
  rowConfig={{ getId: (r) => r.id, getLabel: (r) => r.title }}
  columns={[
    { id: "filing", header: "Filing", value: (r) => r.title },
    { id: "entity", header: "Entity", cell: (r) => <TableCell type="entity" label={r.entity} icon={r.flag} /> },
  ]}
/>;

Containers

Card by default: white, radius 12, a 0.5 hairline, holding the toolbar, header, rows and pagination. Flat sits straight on the page when the page already frames it. Switch between them below; sort by Due, search, or open a row’s menu.

Filing
Entity
Assignee
Status
Actions
Delaware annual reportAnnual · DelawareAcme Inc.Priya SinghOverdue1 Oct 2026
VAT return Q3Monthly · Federal Central Tax OfficeAcme GmbHLucas MoreauFiled7 Nov 2026
Confirmation statementAnnual · Companies HouseAcme UK LtdAisha KhanDue soon14 Nov 2026
GST returnQuarterly · IRASAcme Pte. Ltd.Jun TanIn review30 Nov 2026
Annual accountsAnnual · KVKAcme B.V.Mira de VriesNot started31 Jan 2027
1–5 of 5
Rows per page

Density

Compact 40 is the default; relaxed 52 gives dense data room. A row with a second line grows to 52 (64 relaxed) and its other cells stretch to match. Header 36 at both.

Compact · 40

Filing
Status
Delaware annual reportAnnual · DelawareOverdue1 Oct 2026
VAT return Q3Monthly · Federal Central Tax OfficeFiled7 Nov 2026
Confirmation statementAnnual · Companies HouseDue soon14 Nov 2026

Relaxed · 52

Filing
Status
Delaware annual reportAnnual · DelawareOverdue1 Oct 2026
VAT return Q3Monthly · Federal Central Tax OfficeFiled7 Nov 2026
Confirmation statementAnnual · Companies HouseDue soon14 Nov 2026

Cell types

Read-only cell types in five families. Text left, numbers right. Each comes in compact and relaxed, and default, hover and selected.

Text

Delaware annual report
Text
Delaware annual reportDue 1 Mar 2027
Description
Payment from NASAFailed
Text + badge
EIN 84-1234567
Copy

People and places

Acme GmbH
Entity
Priya Singh
Person
Priya Singhpriya@acme.com
Person + email

Status

In review
Badge
Read only
Tag
Yes
No

Numbers

$12,480.00
Number
+$4,812.40
Positive
$419.00
Failed
+12.0%
Trend · positive
−4.2%
Trend · critical

Row actions

At most three per row: the main action as a bordered IconButton, one secondary action, then more for everything else. Each icon has a tooltip. Never a text or link button down every row. Use TableRowActions in a cell, or rowConfig.menu for the more menu.

Toolbar, summary and preset filters

Filters on the left, one dropdown each; an applied filter shows its value, with Clear after. Search is an icon that opens in place. The summary strip sits inside the container, read-only.

Total due this quarter
$48,210.00
Filed
$31,640.00
Overdue
$4,250.00
Upcoming
$12,320.00

Pagination

Pagination closes every table: the range, Rows per page (25 by default) and pages. Cursor lists show Previous and Next. The bulk-action bar is not in Meridian; product shots do not need it.

States

Loading shows skeleton rows at the current density; the toolbar and header stay so the page does not jump. Empty uses the Empty state: no results with Clear filters, or first use. Errors offer Try again.

Loading

Filing
Entity
Assignee
Status
0–0 of 0
Rows per page

Empty

Filing
Entity
Assignee
Status

No results for “Delaware 2027”

Try a different search, or clear the filters.

0–0 of 0
Rows per page

Error

Filing
Entity
Assignee
Status

Couldn’t load records

Couldn’t load filings

0–0 of 0
Rows per page

Anatomy

One row cell: compact 40 high, 12 side padding, text 13 in soft-pearl 1000. Entities lead with a 16 flag, 8 before the name. Rows are split by a 0.5 soft-pearl 300 line; hover and selected fill soft-pearl 200. Header 36.

API reference

PropTypeDescription
labelRequiredstringFrom Pathfinder.
rowsRequiredreadonly TRow[]From Pathfinder.
columnsRequiredreadonly TableColumn<TRow>[]From Pathfinder.
rowConfigRequiredObjectView fieldsFrom Pathfinder.
viewConfigObjectView fieldsFrom Pathfinder.
groupingConfigObjectView fieldsFrom Pathfinder.
container"card" | "flat"From Pathfinder.
controlsConfigObjectView fieldsHide record-list chrome when embedding a read-only table. Disabling pagination renders every local row.
sortingConfigObjectView fields · 2 shapesFrom Pathfinder.
searchConfigSelectionProps<string> & { getText?: ((row: TRow) => string) | undefined; placeholder?: string; }From Pathfinder.
filterConfigObjectView fieldsFrom Pathfinder.
selectionConfigSelectionProps<TableSelection> & { canSelect?: ((row: TRow) => boolean) | undefined; allMatching?: { queryKey: string; total: number; }; actions?: readonly TableAction[]; moreMenu?: DropdownMenu; }From Pathfinder.
toolbarConfigTableToolbarConfigView fieldsFrom Pathfinder.
stateConfigTabularStateConfigView fieldsFrom Pathfinder.
summaryReactNodeFrom Pathfinder.
footerConfigObjectView fieldsFrom Pathfinder.
classNamestringFrom Pathfinder.
dataModeConditional"local" | "remote"From Pathfinder.
paginationConfigConditionalObjectView fieldsFrom Pathfinder.
rowConfigObject fields
FieldTypeDescription
getIdRequired(row: TRow) => string
getLabelRequired(row: TRow) => string
onActivate(row: TRow) => void
menu(row: TRow) => DropdownMenu
viewConfigObject fields
FieldTypeDescription
densityObject
hiddenColumnsObject
columnWidthsObject
columnPinningObject
viewConfig.densityObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequired"compact" | "relaxed"
onValueChangeRequired(value: "compact" | "relaxed") => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValue"compact" | "relaxed"
onValueChange(value: "compact" | "relaxed") => void

Do not supply: value.

viewConfig.hiddenColumnsObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequiredreadonly string[]
onValueChangeRequired(value: readonly string[]) => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValuereadonly string[]
onValueChange(value: readonly string[]) => void

Do not supply: value.

viewConfig.columnWidthsObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequiredReadonly<Partial<Record<string, number>>>
onValueChangeRequired(value: Readonly<Partial<Record<string, number>>>) => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValueReadonly<Partial<Record<string, number>>>
onValueChange(value: Readonly<Partial<Record<string, number>>>) => void

Do not supply: value.

viewConfig.columnPinningObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequiredReadonly<Partial<Record<string, "start" | "end" | null>>>
onValueChangeRequired(value: Readonly<Partial<Record<string, "start" | "end" | null>>>) => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValueReadonly<Partial<Record<string, "start" | "end" | null>>>
onValueChange(value: Readonly<Partial<Record<string, "start" | "end" | null>>>) => void

Do not supply: value.

groupingConfigObject fields
FieldTypeDescription
getIdRequired(row: TRow) => string
getLabelRequired(id: string) => string
leading(id: string) => ReactNode
summary(id: string, pageRows: readonly TRow[]) => ReactNode
collapsedGroupsObject
groupingConfig.collapsedGroupsObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequiredreadonly string[]
onValueChangeRequired(value: readonly string[]) => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValuereadonly string[]
onValueChange(value: readonly string[]) => void

Do not supply: value.

controlsConfigObject fields
FieldTypeDescription
toolbarboolean
paginationboolean
sortingConfigObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequiredObject
onValueChangeRequired(value: TableSort | null) => void

Do not supply: defaultValue.

sortingConfig.valueObject fields
FieldTypeDescription
columnIdRequiredstring
directionRequired"desc" | "asc"

Option 2

FieldTypeDescription
defaultValueObject
onValueChange(value: TableSort | null) => void

Do not supply: value.

sortingConfig.defaultValueObject fields
FieldTypeDescription
columnIdRequiredstring
directionRequired"desc" | "asc"
filterConfigObject fields
FieldTypeDescription
filtersRequiredreadonly TableFilter<TRow>[]
operatorsObject
valueRequiredReadonly<Record<string, readonly string[]>>
onValueChangeRequired(value: Record<string, readonly string[]>) => void
filterConfig.operatorsObject fields

Choose one of these 2 shapes. Don't combine fields the chosen shape excludes.

Option 1

FieldTypeDescription
valueRequiredReadonly<Record<string, TableFilterOperator>>
onValueChangeRequired(value: Readonly<Record<string, TableFilterOperator>>) => void

Do not supply: defaultValue.

Option 2

FieldTypeDescription
defaultValueReadonly<Record<string, TableFilterOperator>>
onValueChange(value: Readonly<Record<string, TableFilterOperator>>) => void

Do not supply: value.

toolbarConfigObject fields
FieldTypeDescription
actionsreadonly TableAction[]Prefer named actions. Legacy actions use first=primary, second=secondary, remainder=overflow.
primaryActionTableAction & { menu?: DropdownMenu; icon?: ReactNode; }
secondaryActionObject
onExport() => void
moreMenuObject
toolbarConfig.secondaryActionObject fields
FieldTypeDescription
iconReactNode
idRequiredstring
labelRequiredstring
onActionRequired() => void
disabledboolean
toolbarConfig.moreMenuObject fields
FieldTypeDescription
groupsRequiredDropdownGroup[]
searchConfigObject
loadingConfigObject
emptyContentReactNode
footerContentReactNode
footerConfigObject
toolbarConfig.moreMenu.searchConfigObject fields
FieldTypeDescription
labelRequiredstring
valuestring
onValueChange(query: string) => void
filter"manual" | "local"
toolbarConfig.moreMenu.loadingConfigObject fields
FieldTypeDescription
isLoadingRequiredboolean
labelstring
toolbarConfig.moreMenu.footerConfigObject fields
FieldTypeDescription
labelRequiredstring
onActionRequired() => void
disabledboolean
stateConfigObject fields
FieldTypeDescription
isLoadingboolean
errorObject
emptyObject
stateConfig.errorObject fields
FieldTypeDescription
messageRequiredstring
onRetryRequired() => void
stateConfig.emptyObject fields
FieldTypeDescription
titleRequiredstring
descriptionstring
actionObject
stateConfig.empty.actionObject fields
FieldTypeDescription
iconReactNode
idRequiredstring
labelRequiredstring
onActionRequired() => void
disabledboolean
footerConfigObject fields
FieldTypeDescription
totalObject
addActionObject
footerConfig.totalObject fields
FieldTypeDescription
labelRequiredstring
cellsRequiredReadonly<Record<string, ReactNode>>
footerConfig.addActionObject fields
FieldTypeDescription
iconReactNode
idRequiredstring
labelRequiredstring
onActionRequired() => void
disabledboolean
paginationConfigObject fields
FieldTypeDescription
modeRequired"cursor"
hasNextRequiredboolean
hasPreviousRequiredboolean
onNextRequired() => void
onPreviousRequired() => void
summarystring
pageSizeRequirednumber
onPageSizeChange(size: number) => void

Best practices

  • Text left; numbers right with fixed decimals; a badge column shares its header’s alignment.
  • Entities and countries lead with their flag. Long names wrap to two lines instead of truncating.
  • Show a tertiary "–" in an empty cell, never a blank.
  • One more menu or the icon actions per row; never a link or text button repeated down the rows.
  • In a product shot, keep the toolbar and pagination so it reads as the real product. In a comparison table on a marketing page, drop them.
  • Hover and selected share soft-pearl 200; the checked box tells them apart.
  • Source: Pathfinder Table. Meridian keeps it as is; editable cells, the bulk-action bar and the prototype are not carried over.

On this page