Project page and Home row: show the state, don't spell it out #263

Closed
opened 2026-10-27 18:14:05 -04:00 by cmoriarty · 2 comments
Owner

What happens
The project page (#250) is mostly text: the brief, the milestone, every item as a long sentence, Next and Later, and a line of times. You have to read it to learn what is running and how far along it is.

On Home, the project row shows a gray ▤ square while it says "running", so its state doesn't read at a glance either.

Fix
Show it with components, not sentences:

  • Home row: the same status dot as a run row, a small progress bar (items done of total), and the current item's short name.
  • Page header: a state chip, a progress bar, and a bar splitting the time into Braid's own and waiting on you.
  • Plan items: a stepper or cards (done, running, to do), each linked to its run. Show a short title; the "done when" on hover or expand.
  • The brief, Next and Later: folded behind a disclosure.

Done when
A glance at the row or the page tells you the state, the progress and what is running now, without reading a sentence.

Now
The project page:
The project page

Its row on Home:
Its row on Home

From the #260 re-run, run 121's project.

**What happens** The project page (#250) is mostly text: the brief, the milestone, every item as a long sentence, Next and Later, and a line of times. You have to read it to learn what is running and how far along it is. On Home, the project row shows a gray ▤ square while it says "running", so its state doesn't read at a glance either. **Fix** Show it with components, not sentences: - **Home row**: the same status dot as a run row, a small progress bar (items done of total), and the current item's short name. - **Page header**: a state chip, a progress bar, and a bar splitting the time into Braid's own and waiting on you. - **Plan items**: a stepper or cards (done, running, to do), each linked to its run. Show a short title; the "done when" on hover or expand. - **The brief, Next and Later**: folded behind a disclosure. **Done when** A glance at the row or the page tells you the state, the progress and what is running now, without reading a sentence. **Now** The project page: ![The project page](https://forgejo.underthere.xyz/attachments/94640031-5d6a-41cb-b31e-319b242f27b4) Its row on Home: ![Its row on Home](https://forgejo.underthere.xyz/attachments/d7e1c452-2c52-43fe-9a99-e0889c3fb6e6) _From the #260 re-run, run 121's project._
Author
Owner

One more: the row's "0 of 2 items" counts only the current milestone. After the first milestone's 3 items were done, the plan moved on and the row read "0 of 2", so an hour of finished work looked like none.

Show the whole project's progress (for example "3 done · now 0 of 2", or a bar across milestones).

**One more:** the row's "0 of 2 items" counts only the current milestone. After the first milestone's 3 items were done, the plan moved on and the row read "0 of 2", so an hour of finished work looked like none. Show the whole project's progress (for example "3 done · now 0 of 2", or a bar across milestones).
Author
Owner

Shipped in #301 (5355515, deployed). It's part of the change planned-projects-finish-right, which is archived once its other issues are verified on the same project.

Seen on production with the Breakout project (runs 138 and 139):

  • Home row: the run row's status dot, a progress bar with one segment per milestone, milestone 1 of 6 · 0 of 2 items, and the running item's name. Why the project stands where it does is in the hover.
  • Page: a state chip, the same bar, a time bar of Braid's own time against time waiting on you, and the plan's items as a stepper (the running item is marked and linked to its run). The goal, Next and Later are behind "About this plan".
  • #4607's point: progress now counts finished milestones, so a finished milestone no longer reads as "0 of 2".
Shipped in #301 (5355515, deployed). It's part of the change `planned-projects-finish-right`, which is archived once its other issues are verified on the same project. Seen on production with the Breakout project (runs 138 and 139): - **Home row:** the run row's status dot, a progress bar with one segment per milestone, `milestone 1 of 6 · 0 of 2 items`, and the running item's name. Why the project stands where it does is in the hover. - **Page:** a state chip, the same bar, a time bar of Braid's own time against time waiting on you, and the plan's items as a stepper (the running item is marked and linked to its run). The goal, Next and Later are behind "About this plan". - **#4607's point:** progress now counts finished milestones, so a finished milestone no longer reads as "0 of 2".
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
cmoriarty/braid#263
No description provided.