Skip to content

feat(ui): the start page gets search, state filter, three views and the order menu - #550

Merged
p-i-p merged 3 commits into
mainfrom
feat/start-page-filter
Nov 17, 2026
Merged

p-i-p merged 3 commits into
mainfrom
feat/start-page-filter

Conversation

@p-i-p

@p-i-p p-i-p commented Nov 17, 2026

Copy link
Copy Markdown
Member

The start page gets a search, a state filter, three views and the sidebar's order menu. Three commits, each one a step of its own; merge them with "rebase" so they land one by one.

Commit What ADR
8bafdfe A search by name or folder, and the state chips "All", "Running", "Needs attention" ADR-0107
e56b41a Large tiles, small tiles, a sortable list (a switch beside the search) ADR-0108
e00e73c The sidebar's order menu on the start page, one choice for both ADR-0109

UI only: no hub, API or stack-file change.

Review cards

The owner approved all points in the conversation on 2026-11-17: ADR-0107 points 1 to 4, ADR-0108 points 1 to 4, ADR-0109 points 1 to 3.

ADR-0107: search and state filter

# Category Point Beats Reversing costs
1 concept A search field above the tiles; every word typed must be part of the stack's name or repository folder, whatever the case. Sharing the sidebar's field. Low: UI only.
2 concept Three state filters with their counts, combined with the text. A search field alone. Low: UI only.
3 concept The search finds the stack itself, not its worktrees. Searching worktrees too (every stack's lanes on this page). Low.
4 term Text and state stay with the browser tab (session storage). Starting empty each time. Low.

ADR-0108: large tiles, small tiles, a list

# Category Point Beats Reversing costs
1 concept Three views of the same stacks; a switch beside the search; search and state apply in each. A page of its own for each view. Low: UI only.
2 concept The small tile is the same tile, closer together (no time up, no ports shift, one attention line). A second tile component. Low.
3 concept The list is a table with the sortable headers every table has; until a column is chosen it keeps the tiles' order; a column's order applies in the list only. One order for every view. Low.
4 term "Large tiles", "Small tiles", "List"; the choice is kept in the browser (local storage). Keeping the view per tab. Low.

ADR-0109: one order for the sidebar and the start page

# Category Point Beats Reversing costs
1 concept The start page gets the sidebar's order menu as a button in the filter row. A menu of its own. Low: UI only.
2 concept The order is one setting for the sidebar and the start page, effective in both at once. Two separate orders. Medium: the state lives in one shared module.
3 concept The menu orders the tiles and the list; a column chosen on the list's header overrides it. The menu for the tiles only. Low.

Decided on its own, not on the cards: / focuses the search and Esc clears it; a hidden stack stays out, but a line says how many hidden stacks match; a click on a list row opens the stack; the tile's figures moved into ui/src/lib/stackFigures.ts; the sidebar's order state moved into useStackOrdering, the menu into StackOrderMenu.vue.

Checked

  • npx vitest run (282 tests) and npm run typecheck in ui/.
  • In the browser (mock hub, port 5199): the three views, search, chips, column sort, row click, the menu and its effect on the sidebar, a narrow screen.

🤖 Generated with Claude Code

p-i-p and others added 3 commits November 17, 2026 16:10
A field above the tiles finds a stack by its name or repository folder
(every word typed must match, whatever the case), and three chips, "All",
"Running" and "Needs attention", each with its count, narrow the tiles by
state. `/` jumps to the field, Esc clears it; text and state are kept in
the tab's session storage, so a visit to a stack and back finds them as
left. A hidden stack stays out of the tiles, but the line under them says
how many hidden stacks match what was typed.

`matchesQuery` is the stack's own part of the sidebar's `filterStacks`,
which now uses it, so both read the words the same way (ADR-0107).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
… or a list

A switch beside the search chooses how the stacks show: large tiles (as
before), small tiles (the same tile, closer together, without the time up and
the ports shift, with only the first thing that needs attention) or a list. The
list is a table with a column each for state, services, lanes, time up, last
commit and what needs attention, sortable by its headers like every table;
until a column is chosen it keeps the tiles' order. A row has the favourite
star and programs, and a click on it opens the stack. The search and the state
filter apply in every view, and the choice is kept in the browser.

The tile's figures moved out of `StackTile.vue` into `stackFigures`, so the
tile, the row and the sorting read the same values (ADR-0108).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…r both

The start page has the menu that orders the stacks (by name, last opened
first, last edited first; favourites always first) as a button in its filter
row. It orders the tiles and the list; in the list a column chosen on its
header still overrides it.

The order is one choice for the sidebar and the start page: choosing it in
either shows in both at once, where the start page used to take it only when
it opened. The menu is a component both pages use (`StackOrderMenu`), and the
snapshots of last opened and last edited moved out of the sidebar into
`useStackOrdering`, which both pages use (ADR-0109).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@p-i-p
p-i-p merged commit f2c0d7e into main Nov 17, 2026
10 checks passed
@p-i-p
p-i-p deleted the feat/start-page-filter branch November 17, 2026 16:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant