Skip to content

feat(ui): the app shell pieces (ui 0.11.0) - #13

Merged
mindsers merged 3 commits into
mainfrom
feat/shell-pieces
Nov 13, 2026
Merged

mindsers merged 3 commits into
mainfrom
feat/shell-pieces

Conversation

@mindsers

Copy link
Copy Markdown
Contributor

A second app is about to use the shell the main app built, so its router-free half moves into the library. Everything takes its labels, icons and links as props (renderLink, as PeriodStepper already does); nothing imports a router, a message catalogue or an icon set.

What's new

Component For
SidebarFrame, NavGroup, NavItem The quiet column on the left. current marks the page for the eye and for screen readers (aria-current="page"); shortcut shows a Kbd on hover and focus.
TopbarRow, Breadcrumb The 48 px bar: the trail ending with the page itself, then the page's actions. Positioning and phone stacking stay the app's, passed through className.
PageTitle The title row: the h1, its facts (meta), and the controls that change what the page shows.
QuickViews A list's quick views with counts: the segmented control from the tablet up, scrolling chips on a phone.
FilterButton, FilterChipBar The one « Filtres » button with its count, and the active filters as chips. The popover stays the app's: the button passes trigger props through, refs included, so a Radix asChild trigger works.
PaginationBar Where the reader is, and previous / next (links or buttons).
EmptyState One plain sentence and, when the reader can act, the action.
ErrorState An error in the page's place: code, title, what to do, the ways on, optional details.
AuthFrame The bare page outside an app's shell: one narrow column, an emblem, the action as title, a footer.

Not here, on purpose

  • No popover: the library still has no Radix dependency. Each app keeps its popover and its filter fields around FilterButton.
  • No sidebar behaviour: collapsing, the remembered state and the phone sheet stay the app's. The library only draws the column and its entries.
  • No entrance animation: animate-fade-in-up is an app utility; pass it through className where wanted.

Checked

  • pnpm test: 72 tests, including a behaviour test per new piece, and the existing check that nothing imports a router.
  • pnpm test:typecheck and pnpm build.
  • biome check.

Release: ui-v0.11.0 once merged.

A second app needs the shell the first one built, so its router-free half moves here: labels, icons and links
come in as props (`renderLink`), and nothing imports a router, a message catalogue or an icon set.

- SidebarFrame, NavGroup, NavItem: the quiet column, its groups and entries; `current` marks the page for the
  eye and for screen readers, `shortcut` shows on hover and focus.
- TopbarRow, Breadcrumb: the 48 px bar, the trail ending with the page itself, the actions on the right.
  Positioning and phone stacking stay the app shell's (pass them through `className`).
- PageTitle: the title row with its facts and the controls that change what the page shows.
- QuickViews: the segmented control from the tablet up, scrolling chips on a phone.
- FilterButton, FilterChipBar: the one « Filtres » button with its count, and the active filters as chips.
  The popover stays the app's; the button passes trigger props through, refs included.
- PaginationBar, EmptyState, ErrorState, AuthFrame: previous / next with the position, the empty list, an
  error in the page's place, the bare page outside the shell.
A limit nearly reached reads as a warning, and one reached as danger, rather than turning the success colour
once complete. Without the prop the ring is unchanged.
@mindsers
mindsers merged commit c929bec into main Nov 13, 2026
1 check passed
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