Engineering Documentation

Updated: 2026-06-26 · Audited: 2026-06-26

This guide groups core engineering workflows for local development, verification, and operational debugging.

Start here

1. Use Development workflow for setup/build
2. Use Testing workflow for UI test execution
3. Use Crash investigation workflow only when needed

Development workflow

• .NET MAUI 10 setup and restore/build guidance
• Repository layout and common dev commands
• Live simulator/emulator debugging with MauiDevFlow
• Troubleshooting for SDK/workload/restore issues

Testing workflow

• Appium prerequisites and platform drivers
• Unified test runner usage (run-ui-tests.sh)
• Platform-specific test command paths and outputs

Crash investigation workflow

• Sentry triage and issue correlation
• Native log capture (iOS and Android)
• dSYM checks, symbolication, and root-cause documentation template

Performance profiling workflow

• Recording iOS simulator traces with xctrace / Xcode Time Profiler
• Exporting and analyzing hang windows (potential-hangs and time-profile schemas)
• Symbolicated call-stack analysis with Python
• Baseline comparison and fix validation

Detailed references