Notes Workspace¶
Notes Workspace is the flagship VMx example portfolio: one scenario, four idiomatic hosts, and one shared VM contract.
Open the VM layer walkthrough · SVG · PNG
Canonical Sources¶
- Cross-flavor parity matrix: examples/notes-showcase-parity.md
- VM hierarchy diagram source: examples/assets/notes-showcase-vm-hierarchy.svg
- Scenario proposal: spec/proposals/2026-05-29-notes-showcase-scenario.md
Flavor Hosts¶
- C# / Avalonia: examples/csharp/avalonia/NotesShowcase/README.md
- Python / Textual: examples/python/textual/notes_showcase/README.md
- TypeScript / React: examples/typescript/react/notes-showcase/README.md
- Swift / SwiftUI: examples/swift/notes-showcase/README.md
What It Exercises¶
The portfolio is the working example for the current full-parity surface:
- notebook tree projection representing the
HierarchicalVMcapability - selectable notes list through
CompositeVM.current - strict
FormVMediting and validation DerivedPropertystatus and enablementSearchableState, paged notes, and token-paged global search- dialogs, notifications, confirmation flows, and theme state
- edit/preview mode with
DiscriminatorVM
Important Modeling Note¶
The notebooks tree in the current flagship apps is not built from direct
HierarchicalVM subclasses. All four flavors use flat ComponentVM-based
adapters that represent the HierarchicalVM capability and preserve the same
tree messaging contract.
Use the parity matrix for the exact row-by-row feature coverage, then drill into the flavor README you care about for project layout and run commands.