Add Flutter CI workflow and sync hardening docs

2026-02-15 20:13:49 +01:00
parent 497805ed3b
commit f1442e89d8
3 changed files with 94 additions and 0 deletions
@@ -22,6 +22,25 @@ Use fake gateway for local/offline development:
 flutter run --dart-define=USE_FAKE_BACKEND=true
 ```

+## Background Sync
+
+Background sync (startup + resume + periodic ticks while authenticated) is
+enabled by default.
+
+Control flags:
+
+```bash
+flutter run \
+  --dart-define=ENABLE_BACKGROUND_SYNC=true \
+  --dart-define=BACKGROUND_SYNC_INTERVAL_SECONDS=180
+```
+
+Disable it explicitly:
+
+```bash
+flutter run --dart-define=ENABLE_BACKGROUND_SYNC=false
+```
+
 ## Local Persistence Backend

 Default local store: