List View
The List View is generated for GET /resources endpoints (collection endpoints that return an array of records). It renders a full-featured data table using TanStack Table.
Features
- Sorting: click any column header to sort ascending or descending
- Pagination: automatic offset, cursor, or page-based pagination detected from query parameters
- Row actions: Edit and Delete buttons on each row, linked to the corresponding edit form and delete confirmation
- Navigation: clicking a row opens the Detail View for that record
- Column generation: columns are derived from the response schema's top-level fields
Pagination detection
The adapter detects the pagination strategy from the query parameters defined in the spec:
| Strategy | Detected params |
|---|---|
| Offset | limit + offset |
| Page | page + per_page (or pageSize) |
| Cursor | cursor + limit |
If no pagination params are found, the table renders all returned records without pagination controls.
Example spec
paths:
/pets:
get:
summary: List all pets
parameters:
- name: limit
in: query
schema:
type: integer
- name: offset
in: query
schema:
type: integer
responses:
'200':
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Pet'
This produces a paginated table with offset-based pagination controls.
Customisation
Replace the entire List View for a specific resource using the Override System:
overrideRegistry.register({
id: 'pets.list',
mode: 'component',
component: MyCustomPetTable,
});