Skip to content

feat(hub): wiki and mockups views in blueprints; document mockups - #90

Merged
tomasz-zajac-oss merged 1 commit into
mainfrom
feature/hub-wiki-views-docs
Sep 25, 2026
Merged

tomasz-zajac-oss merged 1 commit into
mainfrom
feature/hub-wiki-views-docs

Conversation

@tomasz-zajac-oss

Copy link
Copy Markdown
Collaborator

Summary

This PR adds wiki views and a mockups structure view to every blueprint, and documents mockups, screen flows and Radical Forge.

Blueprint views

  • New views in every blueprint:
    • Mockups (structure view): every screen flow with its wireframes on one canvas.
    • Governance (wiki): requirements, fitness functions and ADRs.
    • Requirements (wiki): requirements only.
  • Renamed view. The canvas governance view is now Governance map, so its name does not clash with the Governance wiki view after import.
  • conceptViews handles wiki and table views. They are converted like canvas views, including their per-view settings (wikiFocusId, wikiPageMode, tableActiveTab). They now appear in the Hub viewer and are created on import.
  • Hub viewer:
    • The view selector now works in Canvas, Wiki and Table mode. It lists the concept's views for the current mode, and "All elements" stays the default.
    • kindForViewId now looks up the loaded views to tell which mode a concept's view belongs to.
    • The /cv/<id> route parameter works in any mode, e.g. …/v/wiki/cv/view-wiki-requirements.

Documentation

  • Manual (website/manual.html):
    • New section Mockups & screen flows: the element, its relations, wireframes (AI generation, sanitising) and screen flows, with light and dark screenshots (website/screenshots/mockups-*.png).
    • New section Radical Forge: the stages, including Mockups before C4, and "Finish here" with the summary step. Forge was not documented before.
    • Hub section: blueprint screen flows and named views per mode.
    • Deep links section: the /cv/ parameter.
  • README: new feature bullets for UI mockups and Radical Forge; the Architecture Hub bullet mentions blueprint flows and views.
  • CHANGELOG (Unreleased): mockups, the Forge changes, blueprint flows and views, and the fixes to Hub views and import toasts.

Type of change

  • New feature
  • Documentation
  • Tests

Checklist

  • npm test passes (408/408)
  • npm run typecheck passes with no errors
  • New or changed behaviour is covered by tests:
    • conceptViews keeps wiki views (focus remapped on import) and drops unsupported kinds
    • kindForViewId resolves the mode of a concept view
    • the /cv/ route parameter round-trips in any mode
    • every blueprint has the Mockups, Governance and Requirements views, and the Requirements wiki view contains exactly the blueprint's requirements
  • Documentation updated (README, CHANGELOG, manual)

Test plan

  • Checked in npm run dev:web with headless Chromium:
    • Hub, E-commerce blueprint:
      • Canvas → Mockups shows 14 screens in 2 flows and no containers.
      • The Wiki selector lists All elements / Governance / Requirements; the table of contents shrinks from 46 entries to 10 and 5.
    • Deep link: bp-fintech-ledger-platform/v/wiki/cv/view-wiki-requirements opens straight into that wiki view.
    • Studio import: creates the "Governance [wiki]" and "Requirements [wiki]" views next to the canvas views.
    • No console errors.
  • Rendered the manual locally. The new sections, table-of-contents entries and screenshots display correctly.

🤖 Generated with Claude Code

Blueprint views
- Every blueprint gains a "Mockups" structure view (all screen flows with
  their wireframes on one canvas) and two wiki views: "Governance"
  (requirements, fitness functions, ADRs) and "Requirements". The canvas
  governance view is renamed "Governance map" so imported view names stay
  distinct.
- conceptViews now carries wiki and table views too (with wikiFocusId /
  wikiPageMode / tableActiveTab), so they reach the Hub viewer and are
  created on import like canvas views.
- Hub viewer: the view selector works in every mode — it lists the
  concept's views for Canvas, Wiki or Table ("All elements" = the default).
  kindForViewId resolves a concept view's mode from the loaded views; the
  route's named view (`/cv/<id>`) applies to any mode.

Documentation
- Manual: new "Mockups & screen flows" section (element, relations,
  wireframes, screen flows) with light/dark screenshots; new "Radical
  Forge" section (stages incl. Mockups, Finish here); Hub section covers
  blueprint screen flows and named views; deep links document `/cv/`.
- README: UI mockups and Radical Forge features; blueprint flows/views.
- CHANGELOG: mockups, Forge changes, blueprint flows and views, and the
  Hub view / import-toast fixes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tomasz-zajac-oss
tomasz-zajac-oss merged commit 0ae555a into main Sep 25, 2026
2 checks passed
@tomasz-zajac-oss
tomasz-zajac-oss deleted the feature/hub-wiki-views-docs branch September 25, 2026 10:43
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