Table
Lists records such as builds, test runs, and cache entries in rows and columns.
Basic
Text, status, and time cells for a list of recent builds.
| Command | Status | Duration | Ran at |
|---|---|---|---|
|
tuist build App
|
Passed
|
2m 14s
|
|
|
tuist test AppTests
|
Failed
|
4m 51s
|
|
|
tuist build App --configuration Release
|
Cancelled
|
38s
|
|
<.table
id="table-basic-recent-builds"
rows={[
%{
id: 1,
command: "tuist build App",
status: "success",
label: "Passed",
duration: "2m 14s",
ran_at: ~U[2026-10-20 09:42:00Z]
},
%{
id: 2,
command: "tuist test AppTests",
status: "error",
label: "Failed",
duration: "4m 51s",
ran_at: ~U[2026-10-20 08:17:00Z]
},
%{
id: 3,
command: "tuist build App --configuration Release",
status: "warning",
label: "Cancelled",
duration: "38s",
ran_at: ~U[2026-10-19 17:05:00Z]
}
]}
>
<:col :let={build} label="Command">
<.text_cell label={build.command} />
</:col>
<:col :let={build} label="Status">
<.status_badge_cell status={build.status} label={build.label} />
</:col>
<:col :let={build} label="Duration">
<.text_cell label={build.duration} />
</:col>
<:col :let={build} label="Ran at">
<.time_cell time={build.ran_at} show_time />
</:col>
</.table>
Text cells
text_cell
holds a label with an optional icon and sublabel.
text_and_description_cell
adds a second line.
| Module | Binary size |
|---|---|
|
TuistKit
Tuist
•
Framework
|
4.8 MB
(uncompressed)
|
|
TuistCore
Tuist
•
Framework
|
2.1 MB
(uncompressed)
|
|
ProjectDescription
Tuist
•
Dynamic framework
|
1.3 MB
(uncompressed)
|
<.table
id="table-text-cells-modules"
rows={[
%{id: 1, name: "TuistKit", project: "Tuist", target: "Framework", size: "4.8 MB"},
%{id: 2, name: "TuistCore", project: "Tuist", target: "Framework", size: "2.1 MB"},
%{
id: 3,
name: "ProjectDescription",
project: "Tuist",
target: "Dynamic framework",
size: "1.3 MB"
}
]}
>
<:col :let={module} label="Module">
<.text_and_description_cell
label={module.name}
icon="package"
description={module.project}
secondary_description={module.target}
/>
</:col>
<:col :let={module} label="Binary size">
<.text_cell label={module.size} sublabel="(uncompressed)" />
</:col>
</.table>
Actions
button_cell
holds one or more buttons.
link_button_cell
renders a single text action.
| Token | Details | |
|---|---|---|
|
ci-main
Read and write cache
|
|
|
|
release-pipeline
Upload previews
|
|
<.table
id="table-actions-tokens"
rows={[
%{id: 1, name: "ci-main", scope: "Read and write cache"},
%{id: 2, name: "release-pipeline", scope: "Upload previews"}
]}
>
<:col :let={token} label="Token">
<.text_and_description_cell label={token.name} description={token.scope} />
</:col>
<:col :let={_token} label="Details">
<.link_button_cell label="View usage" variant="secondary" underline />
</:col>
<:col :let={_token} label="">
<.button_cell>
<:button>
<.button icon_only variant="secondary" size="small" aria-label="Edit token">
<.pencil />
</.button>
</:button>
<:button>
<.button icon_only variant="destructive" size="small" aria-label="Revoke token">
<.trash />
</.button>
</:button>
</.button_cell>
</:col>
</.table>
Expandable rows
Rows open in place to reveal details without leaving the table.
| Task | Result |
|---|---|
|
Compile TuistKit
|
Cache hit
|
|
Restored from the remote cache in 1.2s Key 6f3a9c1e |
|
|
Compile TuistCore
|
Cache miss
|
|
Inputs changed in Sources/TuistCore/Graph.swift |
|
|
Link Tuist
|
Built
|
<.table
id="table-expandable-rows-tasks"
rows={[
%{
id: 1,
task: "Compile TuistKit",
status: "success",
label: "Cache hit",
details: ["Restored from the remote cache in 1.2s", "Key 6f3a9c1e"]
},
%{
id: 2,
task: "Compile TuistCore",
status: "attention",
label: "Cache miss",
details: ["Inputs changed in Sources/TuistCore/Graph.swift"]
},
%{id: 3, task: "Link Tuist", status: "success", label: "Built", details: []}
]}
row_expandable={fn task -> task.details != [] end}
>
<:col :let={task} label="Task">
<.text_cell label={task.task} />
</:col>
<:col :let={task} label="Result">
<.status_badge_cell status={task.status} label={task.label} />
</:col>
<:expanded_content :let={task}>
<p :for={detail <- task.details}>{detail}</p>
</:expanded_content>
</.table>
Sorted column
sort_order
shows the sort direction next to the column label.
| Test case | Duration |
|---|---|
|
testCacheWarmsAllTargets
|
12.4s
|
|
testGeneratesWorkspace
|
3.8s
|
|
testResolvesPackages
|
1.1s
|
<.table
id="table-sorted-column-tests"
rows={[
%{id: 1, name: "testCacheWarmsAllTargets", duration: "12.4s"},
%{id: 2, name: "testGeneratesWorkspace", duration: "3.8s"},
%{id: 3, name: "testResolvesPackages", duration: "1.1s"}
]}
>
<:col :let={test} label="Test case">
<.text_cell label={test.name} />
</:col>
<:col :let={test} label="Duration" sort_order="desc">
<.text_cell label={test.duration} />
</:col>
</.table>
Empty state
Shown in place of the rows when
rows
is empty.
| Test case | Flaky runs |
|---|---|
|
No flaky tests
Tests that pass and fail on the same commit appear here.
|
|
<.table id="table-empty-state-flaky-tests" rows={[]}>
<:col label="Test case"></:col>
<:col label="Flaky runs"></:col>
<:empty_state>
<.table_empty_state
icon="chart_column"
title="No flaky tests"
subtitle="Tests that pass and fail on the same commit appear here."
/>
</:empty_state>
</.table>
Guidelines
-
Pass the records in
rowsand define each column with acolslot. Render one cell component inside every column so spacing and typography stay consistent. -
Give each row an
id, or passrow_key. A stringidbecomes the row's DOM id as is, and any other value is prefixed with the tableid, so keys must be unique on the page. -
Use
row_navigatewhen a row opens a detail page. The first cell becomes a real link, so people can open it in a new tab. -
Expandable rows toggle on the client and need no
handle_event. Useexpanded_rowsfor rows that start open, androw_toggleonly when the details load from the server. -
Pair
sort_orderwithpatchon sortable columns, so the header links to the new order and shows its direction. -
Pass an
empty_stateslot with atable_empty_statethat says what will appear there and when.
API reference
<.table>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
expand_label
|
string
|
"Toggle row details"
|
Accessible label for the disclosure button that expands/collapses a row.
|
|
expanded_rows
|
list
|
[]
|
A list of row keys/IDs that are currently expanded.
|
|
id
Required
|
string
|
–
|
A uniqie identifier for the table
|
|
row_click
|
fun
|
nil
|
A function to generate the click handler for a row.
|
|
row_expandable
|
fun
|
nil
|
A function to determine if a row can be expanded. Returns true/false.
|
|
row_key
|
fun
|
nil
|
A function to generate the row key. Required when using a LiveView stream. If using streams and not provided, defaults to the
id
key of the stream.
|
|
row_navigate
|
fun
|
nil
|
A function to generate the link to navigate to when clicking on a row.
|
|
row_toggle
|
fun
|
nil
|
Optional function returning the disclosure button's JS command. Use with expanded_rows for server-managed lazy loading.
|
|
rows
Required
|
list
|
–
|
The table content
|
| Slot | Description |
|---|---|
|
:col
Required
|
Attributes:
labeliconpatchsort_order
|
|
:empty_state
|
|
|
:expanded_content
|
Content to display when a row is expanded
|
<.text_cell>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
icon
|
string
|
nil
|
An optional icon to render next to the label. Mutually exclusive with
image
.
|
|
label
|
string
|
nil
|
The label of the cell
|
|
sublabel
|
string
|
nil
|
An optional sublabel
|
Also accepts global attributes.
| Slot | Description |
|---|---|
|
:image
|
An optional image to render next to the label. Mutually exclusive with
icon
. Takes precedence over
icon
.
|
<.text_and_description_cell>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
description
|
string
|
nil
|
The description of the cell
|
|
icon
|
string
|
nil
|
An optional icon to render next to the label. Mutually exclusive with
image
.
|
|
label
|
string
|
nil
|
The label of the cell
|
|
secondary_description
|
string
|
nil
|
The secondary description of the cell
|
|
truncate
|
boolean
|
true
|
Cap the cell to a single line per row and clip overflow with an ellipsis, instead of letting free-form content (e.g. a command with many target arguments) widen the column unbounded. On by default; pass
truncate={false}
to opt out.
|
Also accepts global attributes.
| Slot | Description |
|---|---|
|
:image
|
An optional image to render next to the label. Takes precedence over
icon
.
|
<.badge_cell>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
color
|
string
|
"neutral"
|
The color of the badge
"neutral""destructive""warning""attention""success""information""focus""primary""secondary"
|
|
icon
|
string
|
nil
|
An optional icon to render next to the label.
|
|
label
|
string
|
nil
|
The label of the badge
|
|
size
|
string
|
"medium"
|
The size of the badge
"small""medium""large"
|
|
style
|
string
|
"fill"
|
The style of the badge
"fill""light-fill"
|
Also accepts global attributes.
<.status_badge_cell>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
label
|
string
|
nil
|
The label of the badge
|
|
status
Required
|
string
|
–
|
The status of the badge
"success""error""warning""disabled""attention""in_progress"
|
Also accepts global attributes.
<.tag_cell>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
icon
|
string
|
nil
|
An optional icon to render next to the label.
|
|
label
|
string
|
nil
|
The label of the badge
|
Also accepts global attributes.
<.time_cell>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
relative
|
boolean
|
false
|
Whether to show the time relative to now.
|
|
show_time
|
boolean
|
false
|
Whether to show the time or date only.
|
|
time
Required
|
DateTime
|
–
|
The time to render.
|
Also accepts global attributes.
<.button_cell>
Also accepts global attributes.
<.link_button_cell>
Also accepts global attributes.
<.table_empty_state>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
icon
|
string
|
nil
|
Icon to show in the empty state.
|
|
subtitle
|
string
|
nil
|
Subtitle of the empty state.
|
|
title
|
string
|
nil
|
Title of the empty state.
|
| Slot | Description |
|---|---|
|
inner_block
|
Custom empty state content. Supersedes all attributes.
|