Skip to content

feat(setup): make Overview a health check once setup is done - #44

Merged
dizys merged 1 commit into
mainfrom
ux/3-overview
Oct 19, 2026
Merged

dizys merged 1 commit into
mainfrom
ux/3-overview

Conversation

@dizys

@dizys dizys commented Oct 19, 2026 •

Copy link
Copy Markdown
Owner

Third of four stacked PRs reworking the setup console's UX. Based on #43.

Once setup was done, Overview had little to say. A "Ready" line was followed by readouts, a copy of the device list and a log. Disk pressure was a separate notice, and an anonymous home volume, a real data-loss risk, sat as a small badge three pages away. Overview now leads with which server this is, then becomes a health check.

Screenshots

Same sample data before and after (scripts/fixtures/console), light theme; desktop at 1280 px, phone at 390 px. Click an image for full size.

BeforeAfter
Overview, set up: “At a glance” and the second device list give way to a Ready line, then Updates and Recent side by side.
Overview, set up, beforeOverview, set up, after
Overview, needing attention: the disk notice joins Needs you, with the anonymous volume, the failed port and the old settings, worst first, each with one action. Updates are no longer listed as needing you.
Overview, needing attention, beforeOverview, needing attention, after
BeforeAfterBeforeAfter
Overview on a phone, needing attention: each action sits under its text.
Overview on a phone, beforeOverview on a phone, after

What Overview shows

  • Its server. Under the title, the server's public host and how long T3 Code has been up ("t3.example.com · T3 Code is running, up 24 hours."), and Open T3 Code beside it.
  • Setup, until it's done. The checklist from before, unchanged.
  • Ready. One line with what's set up, and whether anything needs you.
  • Needs you. Worst first, each item with one thing to do:
    • Agents and tools that failed or are signed out (Retry, Sign in).
    • A port that wouldn't publish (Retry).
    • A home or state folder a recreate would lose (How to fix, which opens the copy-paste commands from Server).
    • A disk over 80% full (Free up space).
    • Settings an older image left behind (Review).
    • A T3 Code update that didn't finish (Review).
    • T3 Connect waiting for a restart (Restart T3 Code).
      On a phone each action sits under its text, so the text reads whole.
  • Updates and Recent, side by side on a desktop. Up to four releases with Update (T3 Code's asks first, since it restarts) and Update all, then the last six things that happened.

Updates no longer appear under Needs you. They're offered, not owed, and they have their own card and page. The "At a glance" readouts and the second device list are gone; the Ready line and Access cover them.

Also

  • Needs you's actions look alike. A failed row's Retry is no longer amber there, and every Retry has the same icon.
  • The Ready line keeps each number with its noun ("3 devices paired"), so a line never breaks between them.
  • The palette (Ctrl K) offers the container's problems too (Fix the home folder's anonymous volume…, Review settings left by an older image).
  • Extra-small buttons stay small on phones. Touch sizing had raised them to 16px text, larger than the section titles beside them.
  • Recent sets versions in monospace, and prose in normal type.
  • The setup page guide describes the health check.

Test plan

  • node --test tests/*.test.mjs: 601 pass. New tests check that the container's problems each come with their one action, worst first; that a long error shows only its first line; and that a failed port is an item with Retry. Updated tests check that updates aren't "needs you"
  • scripts/ui-audit.js: no findings across all pages and sizes
  • Storage, auto-update, context, skills, form-drafts and row audits pass
  • CI: lint, versions, and the browser and core images built and smoke-tested on amd64 and arm64

Stack: #42 Foundations → #43 Structure → #44 Overview → #45 Instructions & skills

🤖 Generated with Claude Code

Overview opens with which server this is: its public host, T3 Code's
version and uptime, and Open T3 Code. Until setup is done it is the
checklist, as before. After that it is a Ready line, then:

- Needs you, worst first, each with its one action: agents and tools
  that failed or are signed out, a port that would not publish, a home
  or state folder the next recreate would lose (How to fix opens the
  commands from Server), a disk over 80% full, settings an older image
  left behind, a T3 Code update that did not finish, and T3 Connect
  waiting on a restart. On a phone each action sits under its words.
- Updates beside Recent: up to four releases with Update (T3 Code's asks
  first, since it restarts) and Update all, then the last six events.

Updates leave Needs you: they are offered, not owed, and have their own
card and page. The At a glance readouts and the second device list go;
the Ready line and Access say the same. Needs you's buttons now look
alike, extra-small buttons stay small at touch density, and Recent sets
only versions in monospace.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@dizys
dizys changed the base branch from ux/2-structure to main October 19, 2026 08:53
@dizys
dizys merged commit c9ce6e1 into main Oct 19, 2026
14 checks 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