rbrooks/Quest-Board

Watch

Fork 0

[UX] Redesign coverage: where every shipped and planned feature lives in Design A #656

New issue

Closed

opened 2026-09-15 18:21:00 +00:00 by claude-bot · 2 comments

claude-bot commented

2026-09-15 18:21:00 +00:00

Collaborator

Why

Owner, 2026-09-15: every new or planned feature must have a place in the redesign. The direction was settled on #363: Design A (Book & Table) is the base, with elements of B.

This review compared Design A as built (tools/feedback-site/static/mockups/a-book-and-table.html) against:

the surface inventory (#361)
every open issue that would put something on screen
every UI change merged since the inventory (v4.3.0, 2026-09-06)

What Design A draws

Shell:
- Desktop app bar: brand, breadcrumb, an empty space, an identity disc.
- Phone app bar: brand, page title, a "Contents" button that opens a sheet.
Navigation is the book's Contents:
- Home: Home, Needs you, the campaigns, and a "You" group with Profile and Help.
- In a campaign: This week, Sessions, Highlights, Storyline, Analytics, Settings.
- "The wiki": Front page & search, People, Places, Groups, Things, Quests, The map, The party, Handouts, Rules, and Wiki health (GM).
- "Running it" (GM): Prep, Suggested wiki updates.
Eleven screens:
1. Home
2. This week
3. At the table (GM desktop, player phone)
4. After the session
5. GM prep
6. Wiki front page & search
7. An article
8. Editing
9. The map
10. The party
11. A quest

Shell-level gaps: decide before the design system (#364)

These change the frame every screen sits in, so they come first.

No account menu. The identity disc does nothing. Profile and Help appear only in Home's Contents, and Admin, Sign out and the theme setting appear nowhere. (The theme switch on the mockup page belongs to the page, not the app.)
Proposal: the identity disc opens an account menu with:
- Profile, including pronouns (#653) and notification settings (#655)
- Help
- Admin, for admins only
- Theme
- Sign out
- later, Plan & billing (#642)
No place for the bell (#655). Desktop has an empty space before the identity disc, and the bell goes there. The phone app bar (brand, title, Contents) has to make room for it.
Settings is a placeholder, five read-only rows, yet more planned and shipped features land here than anywhere else.
Proposal: Settings in sections, each saying who can see it (member, GM or owner):
- General
- Members & characters
- Invites & joining
- Ownership & GMs
- Discord
- Recording & retention
- Wiki: edit permissions, reputation levels, calendar
- Content packs
- Foundry
- Archive, export, clone and delete
Players have no member list. Today's campaign page shows everyone; A cuts members to one row in Settings. Players need to see who is in the group, their characters and pronouns (#653), and who the owner and GMs are (#644).
Proposal: Members & characters is visible to every member, with GM and owner controls inline.
Articles have no room for more actions. A has no tabs and no overflow menu anywhere. Coming:
- Talk (#654)
- history and "View as…" (#593)
- references (#593)
- Send to Foundry and Push update (#13, #154, #156)
Proposal:
- Articles get tabs, Read · Talk · History: Wikipedia's shape, which is what #654 asked for.
- Everything else goes in a More menu.
- Sessions get a Talk tab too.
Suggested wiki updates is in two places. It is a GM Contents entry, and also a "Waiting for you" section on the wiki front page, whose code comment says it replaces the page.
Proposal: keep the page as the full queue, with the four-stage status the brief requires, and let the front page preview the first few.

In the app, not drawn in Design A

Each needs drawing before its lane of #366 starts.

Sessions:
- A proposed session and its voting grid. The brief lists the voting grid as something that must survive; A shows only a "Vote" button on a Home card.
- The list of sessions, and creating, rescheduling and cancelling a session, including recurring series.
- After the session, GM review mode. Screen 4 draws only the reading view. The GM side shipped after the mockups:
  - event corrections: strike, rewrite, mark as story, emphasise, regenerate, restore (#568, #596, #607, PR #602)
  - transcript approval and retry
  - processing, queued and failed states
  - the character pin (#422)
In person (#542). A needs a shared-screen face and a recording-source selector. #542's acceptance says the chosen direction's mockups include both, and A has neither.
Account and admin:
- Profile.
- Admin: now ten tabs with Content packs, plus #437's campaign list and #439's setup wizard.
Getting in:
- The Join page: it now has a "request sent" state for campaigns that approve new members (#643).
- Home's Join box: A's Home has only "New campaign", and the real Join box now accepts invite links (#643).
- Login, the sign-in error page, the public analytics link, Help, and the rules licences page (#553).
Wiki:
- Draft review (compare and edit).
- New article: A has only a stub.
Campaign milestones and the campaign timeline. Storyline and #593's campaign timeline are the likely home.
Lower risk: Highlights, Analytics and the Sessions index are coded in the mockup but not drawn as screens.

Planned features: where each lives

Status: Fits means A has the place. After gap N means it fits once that gap is decided. Needs a place means A has no home for it yet.

Issue	Where in Design A	Status
#121 Safety tools	A member-visible registry, plus a way to flag a concern from the session and from the table. A has no campaign-level spot for the registry, and Table mode has no flag control. Proposal: a "Table rules & safety" Contents entry, and a flag button in Table mode's bar and on This week.	Needs a place
#122 Stars & wishes	Prompt in Needs you and This week after a session; GM digest in After's side column	Fits
#123 Handouts (reshaped by #593)	The Handouts chapter, the party page, reveal in Table mode	Fits (drawn)
#124 Downtime	No between-sessions area. Proposal: a section on the party page beside "What we carry"	Needs a place
#125 Templates & cloning	"New campaign" on Home (start from a template); clone in Settings	After gap 3
#126 Calendar (remainder)	Settings → Wiki	After gap 3
#553 Rules lookup	Prep's Rules tool, Table mode's Look up, the wiki's Rules chapter: drawn. Content packs: Admin and Settings. Licences page: not drawn	Partly; after gaps 1 and 3
#593 Wiki	Screens 6–11. The 2026-09-15 additions (visibility blocks, references, View as…)	Drawn; additions after gap 5
#653 Pronouns	Roster on This week, "Who's here" in Table mode, party page, article head, event-log speakers: all drawn surfaces, and #364 needs one name-with-pronouns component. Profile field	Fits; profile after gap 1
#654 Discussions	Talk tab; the board as a "Discussions" Contents entry; rumours in the quest log (screen 11 already shows "rumours awaiting the GM's call"); Needs you	After gap 5
#655 Notifications	The bell; delivery settings in Profile	After gaps 1 and 2
#11 Weekly digest	Profile → notification settings	After gap 1
#422 Character pin	After → Attendance, in GM review mode	Needs review mode drawn
#424 Verified events	After → "What happened" (drawn, reading only); the GM controls	Needs review mode drawn
#437 Admin campaign list	Admin	After gap 1; Admin not drawn
#439 First-run setup	Admin, first run	Not drawn
#542 In-person	Shared-screen face, recording source, naming unnamed speakers	Needs drawing
#642 Hosted plans	Account menu → Plan & billing; a lapsed-campaign banner on This week and Home	After gap 1 (design only for now)
#5, #6 Foundry connection & health	Settings → Foundry	After gap 3
#8 Foundry member sync	Members & characters; party page	After gap 4
#9, #154, #156 Send, live push, push update	Prep's NPC tool; an article's More menu; Table mode's peek card (which already has Spotlight) for "Send to live scene"	After gap 5
#13 Push lore to journals	An article's More menu	After gap 5
#16 Foundry scene state (speculative)	Table mode's GM bar	Fits
#237 The Shelf Listens (speculative)	Table mode's GM side column, beside Look up and Quick note	Fits
#534 Beat Planner (remainder)	Settled by A: Prep's Beats section is the one editor	Fits

No UI footprint: #4, #7, #10, #14, #15, #24, #127, #143, #146, #148, #150, #151, #152, #157, #238, #634. #17 (Matrix) would mirror the Discord touchpoints and adds nothing to the web app.

Shipped since the inventory: must survive the rebuild

The inventory (#361) doesn't describe these six UI changes.

Feature	Today	Where in Design A
Content packs (#553, PR #563)	An Admin tab, and a GM panel on the campaign page	Admin (gap 1); Settings → Content packs (gap 3)
Campaign ownership (#644, PR #648)	Owner badge; Make GM / Remove GM; Transfer ownership with an acceptance banner; Profile's delete-account names owned campaigns	Members (gap 4); Settings → Ownership & GMs (gap 3); the transfer offer in Needs you
Invites with expiry, limits and approval (#643, PR #647)	Labelled invite links with expiry and use counts; an approval toggle and a waiting list; "Request sent" on the Join page; Home's Join box accepts links	Settings → Invites & joining (gap 3); Join page and Home Join (not drawn)
Heard-as aliases (#579, PR #581)	A field on the character form, shown beside the name	Members & characters (gap 4)
Event log with GM corrections (#568, #596, #607, #424 / PR #602)	Under the summary on the session page	After → GM review mode (not drawn)
Unsaved-changes prompt on in-app navigation (#464, PR #537)	Session notes and pending corrections	A dialog pattern in #364. The inventory's statement that only Prep guards against navigating away is no longer true.

The owner decides gaps 1–6.
Update the brief (#361) with the #363 decision, the six shipped features and the shell decisions.
Draw the shell decisions and the missing screens, either before #364 or at the start of each #366 lane: the owner's call (build order in #535).
From now on, every feature issue that puts something on screen says where it lives in Design A.

Acceptance criteria

Gaps 1–6 are decided and written into the brief.
Every open feature issue that puts something on screen is marked Fits in the table above.
Every "not drawn" surface is drawn before its #366 lane merges.

## Why **Owner, 2026-09-15:** every new or planned feature must have a place in the redesign. The direction was settled on #363: Design A (Book & Table) is the base, with elements of B. This review compared **Design A as built** (`tools/feedback-site/static/mockups/a-book-and-table.html`) against: - the surface inventory (#361) - every open issue that would put something on screen - every UI change merged since the inventory (v4.3.0, 2026-09-06) ## What Design A draws - **Shell:** - Desktop app bar: brand, breadcrumb, an empty space, an identity disc. - Phone app bar: brand, page title, a "Contents" button that opens a sheet. - **Navigation is the book's Contents:** - **Home:** Home, Needs you, the campaigns, and a "You" group with Profile and Help. - **In a campaign:** This week, Sessions, Highlights, Storyline, Analytics, Settings. - **"The wiki":** Front page & search, People, Places, Groups, Things, Quests, The map, The party, Handouts, Rules, and Wiki health (GM). - **"Running it"** (GM): Prep, Suggested wiki updates. - **Eleven screens:** 1. Home 2. This week 3. At the table (GM desktop, player phone) 4. After the session 5. GM prep 6. Wiki front page & search 7. An article 8. Editing 9. The map 10. The party 11. A quest ## Shell-level gaps: decide before the design system (#364) These change the frame every screen sits in, so they come first. 1. **No account menu.** The identity disc does nothing. Profile and Help appear only in Home's Contents, and Admin, Sign out and the theme setting appear nowhere. (The theme switch on the mockup page belongs to the page, not the app.) **Proposal:** the identity disc opens an account menu with: - Profile, including pronouns (#653) and notification settings (#655) - Help - Admin, for admins only - Theme - Sign out - later, Plan & billing (#642) 2. **No place for the bell (#655).** Desktop has an empty space before the identity disc, and the bell goes there. The phone app bar (brand, title, Contents) has to make room for it. 3. **Settings is a placeholder,** five read-only rows, yet more planned and shipped features land here than anywhere else. **Proposal:** Settings in sections, each saying who can see it (member, GM or owner): - General - Members & characters - Invites & joining - Ownership & GMs - Discord - Recording & retention - Wiki: edit permissions, reputation levels, calendar - Content packs - Foundry - Archive, export, clone and delete 4. **Players have no member list.** Today's campaign page shows everyone; A cuts members to one row in Settings. Players need to see who is in the group, their characters and pronouns (#653), and who the owner and GMs are (#644). **Proposal:** Members & characters is visible to every member, with GM and owner controls inline. 5. **Articles have no room for more actions.** A has no tabs and no overflow menu anywhere. Coming: - Talk (#654) - history and "View as…" (#593) - references (#593) - Send to Foundry and Push update (#13, #154, #156) **Proposal:** - Articles get tabs, **Read · Talk · History**: Wikipedia's shape, which is what #654 asked for. - Everything else goes in a **More** menu. - Sessions get a Talk tab too. 6. **Suggested wiki updates is in two places.** It is a GM Contents entry, and also a "Waiting for you" section on the wiki front page, whose code comment says it replaces the page. **Proposal:** keep the page as the full queue, with the four-stage status the brief requires, and let the front page preview the first few. ## In the app, not drawn in Design A Each needs drawing before its lane of #366 starts. - **Sessions:** - **A proposed session and its voting grid.** The brief lists the voting grid as something that must survive; A shows only a "Vote" button on a Home card. - **The list of sessions,** and creating, rescheduling and cancelling a session, including recurring series. - **After the session, GM review mode.** Screen 4 draws only the reading view. The GM side shipped after the mockups: - event corrections: strike, rewrite, mark as story, emphasise, regenerate, restore (#568, #596, #607, PR #602) - transcript approval and retry - processing, queued and failed states - the character pin (#422) - **In person (#542).** A needs a shared-screen face and a recording-source selector. #542's acceptance says the chosen direction's mockups include both, and A has neither. - **Account and admin:** - **Profile.** - **Admin:** now ten tabs with Content packs, plus #437's campaign list and #439's setup wizard. - **Getting in:** - **The Join page:** it now has a "request sent" state for campaigns that approve new members (#643). - **Home's Join box:** A's Home has only "New campaign", and the real Join box now accepts invite links (#643). - **Login, the sign-in error page, the public analytics link, Help, and the rules licences page (#553).** - **Wiki:** - **Draft review** (compare and edit). - **New article:** A has only a stub. - **Campaign milestones and the campaign timeline.** Storyline and #593's campaign timeline are the likely home. - **Lower risk:** Highlights, Analytics and the Sessions index are coded in the mockup but not drawn as screens. ## Planned features: where each lives **Status:** **Fits** means A has the place. **After gap N** means it fits once that gap is decided. **Needs a place** means A has no home for it yet. | Issue | Where in Design A | Status | |---|---|---| | #121 Safety tools | A member-visible registry, plus a way to flag a concern from the session and from the table. A has no campaign-level spot for the registry, and Table mode has no flag control. **Proposal:** a "Table rules & safety" Contents entry, and a flag button in Table mode's bar and on This week. | **Needs a place** | | #122 Stars & wishes | Prompt in Needs you and This week after a session; GM digest in After's side column | Fits | | #123 Handouts (reshaped by #593) | The Handouts chapter, the party page, reveal in Table mode | Fits (drawn) | | #124 Downtime | No between-sessions area. **Proposal:** a section on the party page beside "What we carry" | **Needs a place** | | #125 Templates & cloning | "New campaign" on Home (start from a template); clone in Settings | After gap 3 | | #126 Calendar (remainder) | Settings → Wiki | After gap 3 | | #553 Rules lookup | Prep's Rules tool, Table mode's Look up, the wiki's Rules chapter: drawn. Content packs: Admin and Settings. Licences page: not drawn | Partly; after gaps 1 and 3 | | #593 Wiki | Screens 6–11. The 2026-09-15 additions (visibility blocks, references, View as…) | Drawn; additions after gap 5 | | #653 Pronouns | Roster on This week, "Who's here" in Table mode, party page, article head, event-log speakers: all drawn surfaces, and #364 needs one name-with-pronouns component. Profile field | Fits; profile after gap 1 | | #654 Discussions | Talk tab; the board as a "Discussions" Contents entry; rumours in the quest log (screen 11 already shows "rumours awaiting the GM's call"); Needs you | After gap 5 | | #655 Notifications | The bell; delivery settings in Profile | After gaps 1 and 2 | | #11 Weekly digest | Profile → notification settings | After gap 1 | | #422 Character pin | After → Attendance, in GM review mode | Needs review mode drawn | | #424 Verified events | After → "What happened" (drawn, reading only); the GM controls | Needs review mode drawn | | #437 Admin campaign list | Admin | After gap 1; Admin not drawn | | #439 First-run setup | Admin, first run | Not drawn | | #542 In-person | Shared-screen face, recording source, naming unnamed speakers | **Needs drawing** | | #642 Hosted plans | Account menu → Plan & billing; a lapsed-campaign banner on This week and Home | After gap 1 (design only for now) | | #5, #6 Foundry connection & health | Settings → Foundry | After gap 3 | | #8 Foundry member sync | Members & characters; party page | After gap 4 | | #9, #154, #156 Send, live push, push update | Prep's NPC tool; an article's More menu; Table mode's peek card (which already has Spotlight) for "Send to live scene" | After gap 5 | | #13 Push lore to journals | An article's More menu | After gap 5 | | #16 Foundry scene state (speculative) | Table mode's GM bar | Fits | | #237 The Shelf Listens (speculative) | Table mode's GM side column, beside Look up and Quick note | Fits | | #534 Beat Planner (remainder) | Settled by A: Prep's Beats section is the one editor | Fits | **No UI footprint:** #4, #7, #10, #14, #15, #24, #127, #143, #146, #148, #150, #151, #152, #157, #238, #634. #17 (Matrix) would mirror the Discord touchpoints and adds nothing to the web app. ## Shipped since the inventory: must survive the rebuild The inventory (#361) doesn't describe these six UI changes. | Feature | Today | Where in Design A | |---|---|---| | Content packs (#553, PR #563) | An Admin tab, and a GM panel on the campaign page | Admin (gap 1); Settings → Content packs (gap 3) | | Campaign ownership (#644, PR #648) | Owner badge; Make GM / Remove GM; Transfer ownership with an acceptance banner; Profile's delete-account names owned campaigns | Members (gap 4); Settings → Ownership & GMs (gap 3); the transfer offer in Needs you | | Invites with expiry, limits and approval (#643, PR #647) | Labelled invite links with expiry and use counts; an approval toggle and a waiting list; "Request sent" on the Join page; Home's Join box accepts links | Settings → Invites & joining (gap 3); Join page and Home Join (not drawn) | | Heard-as aliases (#579, PR #581) | A field on the character form, shown beside the name | Members & characters (gap 4) | | Event log with GM corrections (#568, #596, #607, #424 / PR #602) | Under the summary on the session page | After → GM review mode (not drawn) | | Unsaved-changes prompt on in-app navigation (#464, PR #537) | Session notes and pending corrections | A dialog pattern in #364. The inventory's statement that only Prep guards against navigating away is no longer true. | ## Next 1. **The owner decides gaps 1–6.** 2. **Update the brief (#361)** with the #363 decision, the six shipped features and the shell decisions. 3. **Draw the shell decisions and the missing screens,** either before #364 or at the start of each #366 lane: the owner's call (build order in #535). 4. **From now on,** every feature issue that puts something on screen says where it lives in Design A. ## Acceptance criteria - Gaps 1–6 are decided and written into the brief. - Every open feature issue that puts something on screen is marked Fits in the table above. - Every "not drawn" surface is drawn before its #366 lane merges.

claude-bot added the

enhancement

frontend

labels

2026-09-15 18:21:09 +00:00

claude-bot added this to the v4.5.0 - UX Overhaul: Design Exploration & Rebuild milestone

2026-09-15 18:21:09 +00:00

claude-bot commented

2026-09-15 18:46:35 +00:00

Author

Collaborator

Gaps 1–6: the owner accepted all six proposals (2026-09-15).

The identity disc opens an account menu: Profile (with pronouns and notification settings), Help, Admin for admins, Theme, Sign out, and later Plan & billing.
The bell sits in the empty space before the identity disc on desktop; the phone app bar makes room for it.
Settings is divided into sections, each saying who can see it.
Members & characters is visible to every member, with GM and owner controls inline.
Articles get Read · Talk · History tabs plus a More menu, and sessions get a Talk tab.
Suggested wiki updates keeps its own page, and the wiki front page previews the first few.

The owner also decided that nothing gets built until every screen and surface in Quest Board has been mocked up for players and GMs, and reviewed. The first step is a full catalogue of every page and surface anyone can see, with every current and future feature placed in one. That work is tracked in its own issue, linked here once filed.

**Gaps 1–6: the owner accepted all six proposals (2026-09-15).** 1. The identity disc opens an account menu: Profile (with pronouns and notification settings), Help, Admin for admins, Theme, Sign out, and later Plan & billing. 2. The bell sits in the empty space before the identity disc on desktop; the phone app bar makes room for it. 3. Settings is divided into sections, each saying who can see it. 4. Members & characters is visible to every member, with GM and owner controls inline. 5. Articles get **Read · Talk · History** tabs plus a More menu, and sessions get a Talk tab. 6. Suggested wiki updates keeps its own page, and the wiki front page previews the first few. **The owner also decided that nothing gets built until every screen and surface in Quest Board has been mocked up** for players and GMs, and reviewed. The first step is a full catalogue of every page and surface anyone can see, with every current and future feature placed in one. That work is tracked in its own issue, linked here once filed.

claude-bot referenced this issue

2026-09-15 18:49:15 +00:00

[UX] Surface catalogue: every page and surface in Quest Board, with every current and future feature placed #657

claude-bot referenced this issue

2026-09-15 18:49:31 +00:00

v4.4.0 build order: UX Overhaul in six phases, with two review checkpoints #535

rbrooks referenced this issue from a commit

2026-09-15 19:29:52 +00:00

docs(design): catalogue every surface in Quest Board for the mockup round (#657)

claude-bot referenced this issue

2026-09-15 19:30:10 +00:00

docs(design): catalogue every surface in Quest Board for the mockup round (#657) #658

claude-bot referenced this issue

2026-09-15 19:48:59 +00:00

[UX] Mock up every catalogued surface, for players and GMs, before building #659

claude-bot referenced this issue

2026-09-15 19:49:13 +00:00

[UX] Surface catalogue: every page and surface in Quest Board, with every current and future feature placed #657

claude-bot commented

2026-09-15 19:49:17 +00:00

Author

Collaborator

Superseded by the surface catalogue (#657, merged in PR #658). Closing.

The shell gaps: all six were accepted (comment above) and are built into the catalogue's structure.
This issue's feature table became the catalogue's placement of every open issue's features, broken down further, alongside every current feature.
"Needs a place" items are now owner decisions with proposals: #121 is D2 and #124 is D3.
The "not drawn" surfaces, and the drawing of every surface, are tracked in #659.
The rule that every new feature states where it lives now means adding a row to the catalogue's ledgers/ledger-IS.md and rebuilding (see the catalogue's README).

**Superseded by the surface catalogue** (#657, merged in PR #658). Closing. - **The shell gaps:** all six were accepted (comment above) and are built into the catalogue's structure. - **This issue's feature table** became the catalogue's placement of every open issue's features, broken down further, alongside every current feature. - **"Needs a place" items** are now owner decisions with proposals: #121 is D2 and #124 is D3. - **The "not drawn" surfaces,** and the drawing of every surface, are tracked in #659. - **The rule that every new feature states where it lives** now means adding a row to the catalogue's `ledgers/ledger-IS.md` and rebuilding (see the catalogue's README).

claude-bot closed this issue

2026-09-15 19:49:21 +00:00

claude-bot referenced this issue

2026-09-16 02:03:10 +00:00

[UX] Campaign-wide search in the app bar #667

claude-bot referenced this issue

2026-09-16 02:05:32 +00:00

feat(design): campaign-wide search gets a surface (#667) #668

rbrooks referenced this issue from a commit

2026-09-16 02:32:37 +00:00

feat(feedback-site): lane 1 of the surface mockups — the shell (#659)

claude-bot referenced this issue