Files
PalladiumWallet/docs/adr/0021-in-app-overlays-instead-of-windows.md
T
davide b292590cdc docs: add docs-as-code process and one ADR per feature
docs/docs-as-code.md defines the workflow; docs/adr holds 31 ADRs
(retroactive, reconstructed from code and changelog) with a template and
index. docs/check-docs.sh validates ADR structure, index, cited code
paths, relative links and CLAUDE.md/AGENTS.md sync.
2026-11-03 09:45:51 +01:00

810 B

0021. In-app overlays instead of OS windows

  • Status: Accepted
  • Area: UI
  • Recorded: 2026-11-03 (retroactive: reconstructed from code, comments and changelog)

Context

Secondary windows and popups are slow on WSLg and do not exist on Android's single-view root.

Decision

Details (address, transaction), settings and help are full-screen Borders gated by an IsXxxOpen flag, with Open/Close commands, a backdrop handler and an Esc handler in MainView's code-behind. Close buttons bind via $parent[UserControl], not $parent[Window].

Consequences

  • Instant open/close and identical behaviour on desktop and Android.
  • Overlay state lives in the ViewModel and must be closed on navigation.

References

  • src/App/Views/MainView.axaml
  • src/App/Views/MainView.axaml.cs