Skip to content

docs(blueprints): refresh S04/S07/S08 wireframes, complete the inventory and add a blueprint check - #167

Merged
TOMOKI977 merged 2 commits into
mainfrom
docs/23-screen-specs-completion
Oct 11, 2026
Merged

TOMOKI977 merged 2 commits into
mainfrom
docs/23-screen-specs-completion

Conversation

@Pericena

Copy link
Copy Markdown
Contributor

Closes #23

What

Acceptance criteria (#23)

  • Every screen ID (S01-S12) has a committed PNG at 1440 and 390 px
  • Every screen documents loading, empty, error and success
  • Data field names match docs/domain/model.md (checked in CI)
  • The component inventory lists every reusable component with its screens
  • Wireframe source: there is no Figma file for this project. As frontend owner I confirm that the committed PNGs in docs/blueprints/wireframes/ are the accepted replacement: they are rendered from the app's real components with one command and checked in CI, so they stay in sync with the code
  • The frontend owner confirms the specs are buildable without design questions

Verification

  • bash scripts/tests/blueprints.test.sh: 262 passed, 0 failed (a removed PNG is caught)
  • flutter test tool/wireframes/wireframes_test.dart: every wireframe matches the app, on two consecutive runs
  • All script tests pass: blueprints 262, cloudflare-pages-build 8, env-inventory 83, escrow-deploy 144, fund-accounts 86, seed-preflight 52

Follow-up (app, not docs)

On phones the bottom navigation bar covers the end of the deploy sheet (see S08-deploy-sheet-390.png): the same fix as the hire sheet in #144.

…ory and add a blueprint check

Refs #23.

- S04, S07 and S08 wireframes no longer matched the app: they predated
  the hire relay (#144), wallet sign-in (#149), the funds check (#159)
  and the Studio builder (#145). They are regenerated from the app at
  1440 and 390 px; the other 30 generated wireframes still match and are
  unchanged.
- screens.md: S04 states now cover the wallet sign-in step, the funds
  check before any signature, resuming an unfinished hire, and the
  confirming/held result. S06 lists HireDetailView. The inventory adds
  HireDetailView and Puls3Mark and explains the (new) planned components.
- The wireframe tool fills a valid manifest before opening the deploy
  sheet, and seeds the demo wallet so the S08 PNG is the same on every
  run.
- scripts/tests/blueprints.test.sh checks offline that every screen ID
  has a 1440 and a 390 px PNG, every wireframe is linked and every link
  resolves, every screen documents its four states, data, actions and
  components, and every Entity.field exists in docs/domain/model.md.
@Pericena Pericena added area: blueprints Wireframes, UX flows, screen specs type: docs Documentation deliverable P0 Blocks a deadline deliverable labels Oct 11, 2026
@Pericena Pericena self-assigned this Oct 11, 2026
@Pericena
Pericena requested a review from TOMOKI977 October 11, 2026 16:10

@TOMOKI977 TOMOKI977 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. The reviewed scope is complete, the current head is mergeable, and all applicable checks are green.

@Pericena
Pericena requested a review from TOMOKI977 October 11, 2026 16:56
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 11, 2026 •

Copy link
Copy Markdown

Deploying puls3 with  Cloudflare Pages  Cloudflare Pages

Latest commit: 06f44be
Status: ✅  Deploy successful!
Preview URL: https://ce006db7.puls3-4lw.pages.dev
Branch Preview URL: https://docs-23-screen-specs-complet.puls3-4lw.pages.dev

View logs

@TOMOKI977
TOMOKI977 merged commit 5a2b9f8 into main Oct 11, 2026
10 checks passed
@TOMOKI977
TOMOKI977 deleted the docs/23-screen-specs-completion branch October 11, 2026 17:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: blueprints Wireframes, UX flows, screen specs P0 Blocks a deadline deliverable type: docs Documentation deliverable

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: wireframes and screen specs for all MVP screens

2 participants