mobile-app

Flutter respondent client for GeoSenEsm. Respondents log in, complete scheduled surveys (online and offline), and sync location / sensor data to survey-api.

Stack	Flutter 3.16+, Dart ≥ 3.3, Dio, GetX, GetStorage, sqflite, geolocator, flutter_blue_plus, flutter_local_notifications, sentry_flutter
Platforms	Android, iOS
Backend	survey-api (base URL entered on login, stored as apiUrl)
White-label variants	geosenesm, urbeat
Sibling clients	survey-admin-panel (researchers)

---

Repository contents

Path	Purpose
lib/presentation/	Screens, GetX controllers, bindings
lib/domain/	Use cases, entities, service contracts
lib/data/	HTTP datasources (APIServiceBase), DTO models, local sqflite
lib/core/	Shared models, usecases helpers, utils
lib/l10n/	Generated / ARB-driven localizations
assets/<variant>/	Per-brand images and launcher icon source
android/, ios/	Platform projects
scripts/	Release APK / AAB build scripts per variant
android_launcher_icons_*.yaml	Launcher-icon generation per variant
pubspec.yaml	Dependencies and assets

Source layout

lib/
├── presentation/   UI — screens, GetX controllers, DI bindings
├── domain/         Use cases and pure domain models
├── data/           Datasources, JSON models (*.g.dart), local DB
├── core/           Cross-cutting helpers
└── l10n/           Localization output

Screens depend on controllers; controllers depend on use cases / service interfaces — not on datasource implementations. Wire new services in lib/presentation/bindings/initial_bindings.dart.

Android variants

One codebase, two branded apps:

Aspect	geosenesm	urbeat
APP_TYPE	geosenesm	urbeat
Assets	assets/geosenesm/	assets/urbeat/
Launcher icons YAML	android_launcher_icons_geosenesm.yaml	android_launcher_icons_urbeat.yaml
Signing keys	geosenesm.* in android/key.properties	urbeat.* in android/key.properties

Use the scripts under scripts/ for release builds — do not run bare flutter build apk for store artifacts (wrong icon / label / signing).

---

Local development

Prerequisites

• Flutter SDK 3.16+ on PATH
• Android SDK and/or Xcode
• Running survey-api reachable from the device / emulator
• Optional mobile-app/.env if the project loads dotenv assets (add a placeholder file if required by pubspec.yaml)

Install and run

flutter pub get
flutter run
flutter run --dart-define=APP_TYPE=geosenesm
flutter run --dart-define=APP_TYPE=urbeat

Point at the backend

On first login, enter the API base URL. It is persisted in GetStorage under apiUrl and applied to Dio in initial_bindings.dart.

Target	Typical URL
Android emulator	http://10.0.2.2:8080
iOS simulator	http://localhost:8080
Physical device	http://<host-lan-ip>:8080

Code generation

After changing @JsonSerializable models:

flutter pub run build_runner build --delete-conflicting-outputs

Localizations:

flutter gen-l10n

Analyzer should be clean before finishing work:

flutter analyze

---

Android release builds

Windows

.\scripts\build-android-geosenesm.ps1 apk

.\scripts\build-android-geosenesm.ps1 appbundle

Linux / macOS

./scripts/build-android-geosenesm.sh apk

./scripts/build-android-geosenesm.sh appbundle

Output artifacts

Artifact	Path
GeoSenEsm APK	build/app/outputs/flutter-apk/app-geosenesm-release.apk
GeoSenEsm AAB	build/app/outputs/bundle/release/app-geosenesm-release.aab

Signing

Keys are read from android/key.properties :

geosenesm.storePassword=...
geosenesm.keyPassword=...
geosenesm.keyAlias=...
geosenesm.storeFile=...

Do not commit real signing secrets.