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.
24 lines
810 B
Markdown
24 lines
810 B
Markdown
# 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 `Border`s 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`
|