feat(ui): add list-level ui.listView config (initialColumns + initialSort) by borisno2 · Pull Request #552 · OpenSaasAU/stack

borisno2 · 2026-06-06T05:00:14Z

Summary

Adds a list-level ui.listView config to core's ListConfig, mirroring Keystone 1:1 so migrators can map per-list defaults directly. Wires it through AdminUI → ListView → ListViewClient.

initialColumns: string[] — drives the list table's default column selection and order.
initialSort: { field, direction } — sets the default sort.
label / labelField / description are intentionally deferred (different concerns).

lists: {
  Post: list({
    fields: { title: text(), status: text(), createdAt: timestamp() },
    ui: {
      listView: {
        initialColumns: ['title', 'status'],
        initialSort: { field: 'createdAt', direction: 'desc' },
      },
    },
  }),
}

When ui.listView is absent, behaviour is unchanged: all non-system fields are shown and no default sort is applied.

How it's consumed

core (packages/core/src/config/types.ts): new ListUIConfig / ListViewUIConfig types, exposed on ListConfig.ui; exported from @opensaas/stack-core config entry. list() passes ui through unchanged.
AdminUI (packages/ui/src/components/AdminUI.tsx): the ListView branch reads config.lists[listKey].ui?.listView and passes initialColumns as the columns prop and initialSort as a new prop.
ListView (packages/ui/src/components/ListView.tsx): accepts initialSort and threads it to the client component (plain serializable data across the server/client boundary).
ListViewClient (packages/ui/src/components/ListViewClient.tsx): seeds sortBy/sortOrder state from initialSort; existing columns already drives selection/order.

Tests

packages/core/tests/config.test.ts: ui.listView (initialColumns + initialSort) is accepted; ui stays undefined when not configured.
packages/ui/tests/components/ListViewClient.test.tsx: column order from initialColumns; default sort + direction from initialSort; sort indicator on the seeded column; no default sort when initialSort absent.
packages/ui/tests/components/AdminUIListView.test.tsx: AdminUI passes initialColumns/initialSort from config to ListView; passes undefined when ui.listView absent.

All green: stack-core 588 tests, stack-ui 190 tests. Lint (0 errors), format:check pass.

Fixes #550

https://claude.ai/code/session_01ULd2HCT8dUve9aa9gKi6sX

Generated by Claude Code

Add a list-level `ui.listView` block to core's `ListConfig` mirroring Keystone: - `initialColumns: string[]` drives the list table's default column selection and order. - `initialSort: { field, direction }` sets the default sort. AdminUI reads `config.lists[listKey].ui?.listView` and passes `initialColumns` as the ListView `columns` prop and threads `initialSort` through ListView into ListViewClient, which seeds the initial `sortBy`/`sortOrder`. Absent config leaves current behaviour unchanged (all non-system fields, no default sort). `label`/`labelField`/`description` are intentionally deferred. Fixes #550 https://claude.ai/code/session_01ULd2HCT8dUve9aa9gKi6sX

changeset-bot · 2026-06-06T05:00:18Z

🦋 Changeset detected

Latest commit: 5cfe15e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 9 packages

Name	Type
@opensaas/stack-core	Minor
@opensaas/stack-ui	Minor
@opensaas/stack-auth	Minor
@opensaas/stack-cli	Minor
@opensaas/stack-rag	Minor
@opensaas/stack-storage	Minor
@opensaas/stack-tiptap	Minor
@opensaas/stack-storage-s3	Minor
@opensaas/stack-storage-vercel	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-06-06T05:00:20Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
stack-docs	Ready	Preview, Comment	Jun 6, 2026 5:00am

github-actions · 2026-06-06T05:06:02Z