Skip to content

Client space UX review ​

Scope: client home, scripts, videos, billing, team, to-do, calendar, and the shared video player. Screenshots at 1365 and 390 wide in apps/docs/public/qa/client/.

Scores (1 to 10, before fixes) ​

CriterionScoreNote
Clarity of purpose6Each page has a purpose line, but home did not say what needed the client.
Visual hierarchy6Sections all shared one weight; the next action was not stated.
Consistency with the app5Two time zones (browser and London); "Pay" and "Logins" labels were unclear.
Forms and feedback states5Disabled buttons gave no reason; approve and delete were inconsistent (video confirmed, script did not).
Mobile at 390px7No horizontal scroll seen; action rows wrap.
Accessibility6Labels present; the video player had no name; delete buttons were unclear out of context.
Speed to complete main task6Approving a video takes 3 steps; the timestamp field asked for raw seconds.

What works ​

  • Every page has a header and a one-line summary of what it is for.
  • Loading, empty, and error states exist on every view, with retry.
  • Video approval already asks for confirmation.
  • The beUI controls are used throughout, with no native selects or date inputs.
  • Mobile layouts stack cleanly.

Suggestions ​

  1. P1, client-dashboard.tsx: no line says what needs the client. Added a summary ("You have 1 script to approve and 2 videos to review"). Done.
  2. P1, billing-team-view.tsx: members saw an error page for billing. They now see a plain message that billing is for the account admin. Done (UI gate; see note below).
  3. P1, client-area-format.ts, client-calendar.tsx, client-dashboard.tsx, scripts-view.tsx, videos-view.tsx, todo-view.tsx, billing-team-view.tsx: timestamps used the browser zone in some places. All now use the shared London formatter in lib/format-time.ts. Done.
  4. P1, scripts-view.tsx: "Approve script" had no confirmation. Now it asks to confirm and says approval makes the script final. Done.
  5. P2, videos-view.tsx: the timestamp asked for raw seconds. It now accepts "1:23" or seconds, and "Use the time the video is at" fills it in. Done.
  6. P2, scripts-view.tsx, videos-view.tsx, billing-team-view.tsx: disabled buttons gave no reason. Hints now sit beside them. Done.
  7. P2, todo-view.tsx: Delete removed items with no confirmation. It now asks "Confirm delete" or "Cancel". Done.
  8. P2, billing-team-view.tsx: the "Pay" button did not say what it does. It now reads "Pay £1,000.00". Done.
  9. P2, billing-team-view.tsx, client-dashboard.tsx: "Logins" and "Request login" were jargon. Renamed to "Who can sign in" and "Invite someone". Done.
  10. P3, video-player.tsx: the player had no accessible name and no fallback text. Added both. Done.

Not done or partly done ​

  • Server-side enforcement for billing. packages/api/src/routers/v1/client-area.ts (the billing handler) already rejects non-admins, so the page is safe. The UI gate is a presentation change only. [INFERENCE]: the API error text is correct, so no API change is needed.
  • Sub-account requester shown as a raw user id. This is in the owner Access tab (apps/web/src/components/owner/clients/access-rows.tsx) and the API (packages/api/src/client-area.ts, around line 551 sets requestedBy: actor.userId). Outside my files; the client Team page only receives the email, so it cannot show a name.
  • Calendar windows still start at midnight in the browser zone. Labels now use London dates, but the window boundary is not London-aligned. Fixing that needs an API-side window; not done.
  • Owner Money "Mark paid" confirmation, Insights blank space and file-size KB labels: owned by other spaces.

Internal documentation. Not for clients.