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.
This commit is contained in:
1 parent
ce8d777c63
commit
b292590cdc
36 files changed
+987
No files matched your search
@@ -0,0 +1,25 @@
|
||||
# 0002. One shared Avalonia UI with thin platform heads
|
||||
|
||||
- **Status:** Accepted
|
||||
- **Area:** Architecture
|
||||
- **Recorded:** 2026-11-03 (retroactive: reconstructed from code, comments and changelog)
|
||||
|
||||
## Context
|
||||
|
||||
The wallet targets Windows, Linux and Android. Maintaining separate UIs would triple the surface to test and make behaviour drift between platforms.
|
||||
|
||||
## Decision
|
||||
|
||||
Write the UI once in the library `src/App` (Avalonia UI 12, .NET 10). `MainView` (a `UserControl`) is the shared root: hosted by `MainWindow` on desktop and used as the single-view root on Android. The heads `src/App.Desktop` (WinExe) and `src/App.Android` carry only the entry point and platform packages. Top-level services (file picker, clipboard) are reached through `TopLevel.GetTopLevel(this)`; platform differences are gated by `MainWindowViewModel.IsDesktop`.
|
||||
|
||||
## Consequences
|
||||
|
||||
- One code path for UI logic and one localization table.
|
||||
- UI must stay mobile-friendly (no OS windows, see 0021) and avoid desktop-only APIs outside `IsDesktop` guards.
|
||||
- Android needs its own workload, SDK and signing flow (0028, 0029).
|
||||
|
||||
## References
|
||||
|
||||
- `src/App/Views/MainView.axaml`
|
||||
- `src/App.Desktop`
|
||||
- `src/App.Android`
|
||||
Reference in new issue
Block a user