Startboard project

Startboard / Design system

Documentation v1.0.0 · Public product

Design system contents

Components

Board navigation

A small set of board chips makes the current collection easy to switch.

On this page

Purpose and placement

A small set of board chips makes the current collection easy to switch.

Anatomy

  • First five board chips
  • Active accent treatment
  • Overflow Boards trigger
  • Edit-mode toggle

Contract

Contract
Input or boundaryBehavior
boardsOrdered BoardItem array
activeBoardIdInitial preferred board or home fallback
SelectionLoad links; PATCH currentBoardId preference

States and feedback

  • Selected versus unselected chip
  • Overflow menu open/closed
  • Empty board selected
  • Loading links during board change

Interaction and composition

Selecting a board changes the active ID immediately, closes overflow, requests links and then persists the preference. The source catches preference failure without visible feedback. Keep this behavior distinct from board editing.

Responsive behavior

Chips wrap at narrow widths. Only the first five are direct chips; the remainder are menu items, preserving the source ordering.

Accessibility contract

Native buttons provide keyboard activation, but selected chips do not expose aria-pressed or tab semantics. Menus expose expanded state but are not ARIA menu widgets.

Known implementation gaps

If fetching board links fails, the selected board can show an empty or stale state. No retry action or announced selected-board change is implemented.

Source references

Source references
Repository fileResponsibility
app/(home)/AppHome.tsxSelection flow and board chips
app/api/preferences/route.tsPreference validation

Examples from the app

Actual Startboard source UI with isolated fictional records; both native themes at 2× resolution or higher. No live integrations or account writes. Captured at 2× resolution or higher. Select an image to inspect it full size.

Dashboard Empty Board Desktop Light · Screen · Light · Desktop · Empty Board · 2880 × 2000 px
Board Tabs Default Desktop Light · Component detail · Light · Desktop · 2436 × 168 px
Board Overflow Open Desktop Light · Component detail · Light · Desktop · Open · 1864 × 1264 px

Source audit: 2026-10-08 · Revision 08fa2595a668 · Documentation v1.0.0