Skip to content

docs(ui): Compass Settings design record (RIG-4775) - #1929

Merged
mattwilkinsonn merged 5 commits into
mainfrom
compass-ui/rig-4775-settings-design
Oct 10, 2026
Merged

mattwilkinsonn merged 5 commits into
mainfrom
compass-ui/rig-4775-settings-design

Conversation

@rigel-mintaka

@rigel-mintaka rigel-mintaka commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This is the design record for the Compass Settings page (RIG-4775). It folds in RIG-3121 (the Providers section, enrollment E5). Record: docs/designs/ui/compass-settings/design.md. Ledger: DL-431 to DL-436 are added.

Decisions

  • Navigation (DL-431): a section nav with the route /settings/:section. Bare /settings redirects to the first section; openers target the last section shown.
  • Rows (DL-433): a two-column grid of rows with a line between them, built on .cx-input, .cx-select and .cx-btn. Choices are aria-pressed buttons; there is no new switch primitive.
  • Saving (DL-434): device preferences apply immediately. Providers makes one RPC per action, as enrollment E5 specifies.
  • Sections: General, Appearance, Models, Providers.

Matt's rulings (2026-10-08, RIG-4829)

  1. Tracker editor (DL-432): delete the client-side editor and setTrackerConfig. A server-backed Tracker section returns with the tracker contract.
  2. Usage-data control (DL-435): none for now; the deployer decides at build time.
  3. Settings openers (DL-436): follow DL-390. They navigate the focused view; Mod-click or middle-click opens a deduped tab.

Sequencing

Verification

  • rumdl is clean.
  • design-ledger-gate is OK: 384 rows, 159 records.
  • Docs only.

Ledger-impact: DL-431 to DL-436 added.
Spec-impact: none. Refs RIG-4775

@trunk-io

trunk-io Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

😎 This pull request was merged.

@linear-code

linear-code Bot commented Oct 7, 2026

Copy link
Copy Markdown

RIG-4775

@github-actions

github-actions Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

@rigel-mintaka
rigel-mintaka marked this pull request as ready for review October 7, 2026 11:28
Comment thread docs/designs/ui/compass-settings/design.md Outdated
Comment thread docs/designs/ui/compass-settings/design.md Outdated
Comment thread docs/designs/ui/compass-settings/design.md Outdated
@rigel-mintaka
rigel-mintaka force-pushed the compass-ui/rig-4775-settings-design branch 2 times, most recently from 0626043 to c00c15c Compare October 9, 2026 03:48
rigel-mintaka and others added 5 commits October 10, 2026 00:31
Section nav and /settings/:section routing, row anatomy on the shared
primitives, a per-section save model, and the Providers section from the
enrollment record (RIG-3121). Two open questions for Matt.

Ledger-impact: DL-431, DL-433, DL-434 added.
Spec-impact: none. Refs RIG-4775

Co-authored-by: Matt Wilkinson <matt@rigel.build>
showSettings opens through the layout so dedupe applies; redirect change
stated; nav selection attributes; one held id per open question.

Co-authored-by: Matt Wilkinson <matt@rigel.build>
Co-authored-by: Matt Wilkinson <matt@rigel.build>
OQ1 deletes the tracker editor (DL-432), OQ2 adds no usage-data control
(DL-435), OQ3 keeps DL-390 for Settings openers (DL-436).

Co-authored-by: Matt Wilkinson <matt@rigel.build>
DECISIONS.md is now one front-matter file per decision under
docs/designs/decisions/; the rows this record added move there unchanged.

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@rigel-mintaka
rigel-mintaka force-pushed the compass-ui/rig-4775-settings-design branch from c00c15c to 7264c75 Compare October 10, 2026 04:36
@rigel-mintaka

Copy link
Copy Markdown
Contributor Author

Review at head 7264c75

Result: clean. High 0, medium 0, low 0.

Scope: the commit that moves this record's decisions into per-decision files (DL-431..436) after #2005 split DECISIONS.md, plus the rebase onto main 2442f58. The design.md content was reviewed earlier (Review4775Fold, clean).

Check Result
Each file's decision/status text matches its old table row (after | unescape); no row missing, no extra file pass
Each record: path and anchor resolves to a heading (gate's slug logic) pass
Front matter matches decisions/README.md key order and quoting (compared with DL-416) pass
No remaining DECISIONS.md edit or link in the branch pass
design-ledger-gate OK, 390 decision files
rumdl on the new files clean

@mattwilkinsonn
mattwilkinsonn merged commit 848b5de into main Oct 10, 2026
16 checks passed
@mattwilkinsonn
mattwilkinsonn deleted the compass-ui/rig-4775-settings-design branch October 10, 2026 05:26
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