Skip to content

Build plugin Browse experience - #2750

Closed
brsbl wants to merge 9 commits into
bb/plugin-discovery-servicesfrom
bb/plugin-discovery-browse-components
Closed

Build plugin Browse experience#2750
brsbl wants to merge 9 commits into
bb/plugin-discovery-servicesfrom
bb/plugin-discovery-browse-components

Conversation

@brsbl

@brsbl brsbl commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator

Product intent and requirements

  • Make Browse scalable and scannable through category shelves while keeping the existing creation hero intact.
  • Use one shared search, category-filter, sort, and card system so Browse states feel like one product rather than separate layouts.
  • Let users search and filter without losing shelf context; sorting may flatten results when ranking becomes the primary task.
  • Keep category and install metadata compact, semantic, and subordinate to plugin identity.
  • Reuse shared collection and hero primitives so later plugin surfaces do not fork the interaction model.

What was wrong

Browse presented one publisher-grouped grid, so users could not scan plugins by job, restore shelf context after sorting, or understand category consistently across shelf and flat-list states. The hero and shared collection primitives were also app-local, which prevented reuse by derivative plugin pages.

What changed

  • Adds category shelves, New & Notable, category filtering, search, and recently-added/most-installed sorting. Sorting flattens Browse; clearing it restores shelves.
  • Applies the approved card rules: author artwork remains unchanged, icon tiles stay neutral, category shelves own repeated context, and flat results use semantic category pills.
  • Adds compact install controls with install counts and progress states.
  • Extracts the showcase hero into a shared package and extends shared collection/toolbar primitives used by plugin pages.

Before and after

Matched captures use the same branch web-app data, route, settled state, and 1440×900 Chrome for Testing viewport.

Before — service parent 7416f20621066f378a784b1e7443b68eb34bd902

Before: Browse uses publisher-grouped cards

After — Browse head b7a79a6f983f9499fc2952985847e1a84e1b079f

After: Browse uses category shelves, category controls, and semantic card metadata

Category filtering

The parent has no category control. On the exact head, the same catalog and viewport expose the searchable count-and-checkbox category menu.

Before — no category control After — category menu open
Before: publisher Browse has no category control After: searchable category menu with plugin-count badges and checkbox selection

Sorting and flat results

The parent has no sort control. On the exact head, sort=most-installed&direction=desc flattens the same catalog into descending install order and shows category pills on every applicable card.

Before — publisher groups After — most-installed flat list
Before: publisher-grouped Browse without sort state After: flat Browse results sorted by install count with category pills

How you verified

  • Exact parent and head branch web apps launched with scripts/bb-dev-app branch ... and inspected in Chrome for Testing 151.0.7922.71 at 1440×900.
  • Confirmed the default shelves, open category menu, and most-installed flat state rendered from the same dev data without app errors; Chrome emitted only the known Jotai development warning.
  • Pull-request CI is green on exact head b7a79a6f983f9499fc2952985847e1a84e1b079f; all required checks passed and the platform-inapplicable jobs were skipped.
  • No CI-equivalent tests, typechecks, or lint were run locally per repository policy. Pull-request CI is the validation path.

BB-Thread-ID: thr_9tmqez22hd

AGENT GENERATED

SawyerHood added a commit that referenced this pull request Sep 2, 2026
SawyerHood added a commit that referenced this pull request Sep 2, 2026
SawyerHood added a commit that referenced this pull request Sep 2, 2026
SawyerHood added a commit that referenced this pull request Sep 2, 2026
SawyerHood added a commit that referenced this pull request Sep 2, 2026
SawyerHood added a commit that referenced this pull request Sep 2, 2026
@SawyerHood

Copy link
Copy Markdown
Collaborator

Closing: the Browse redesign landed in a rebuilt form in #2941 (category shelves, multi-category filter, sorts, cards, single detail panel). The components and tests were ported from this PR with credit. Thank you for the design work.

AGENT GENERATED

@SawyerHood SawyerHood closed this Sep 2, 2026
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.

2 participants