diff --git a/lib/main_common.dart b/lib/main_common.dart
index 98d2790f0..1a1820c9d 100644
--- a/lib/main_common.dart
+++ b/lib/main_common.dart
@@ -28,5 +28,10 @@ void mainCommon(AppFlavor flavor) {
     reportService.recordError(errorAndStacktrace.first, errorAndStacktrace.last);
   }).sendPort);
 
+  // Errors during the widget build phase will show by default:
+  // - in debug mode: error on red background
+  // - in release mode: plain grey background
+  // This can be modified via `ErrorWidget.builder`
+
   runApp(AvesApp(flavor: flavor));
 }