📱 Frontend Setup Guide
Run and verify the Flutter app from the checked-in toolchain.
Prerequisites
- Flutter
3.41.9(mise.toml) - Dart SDK compatible with
^3.10.3(pubspec.yaml) - Firebase CLI for emulator/deploy work
- Chrome for the fastest local smoke test
- Android Studio or Xcode only when working on those native targets
Install and run
git clone git@github.com:Acesense/acesense-frontend.git
cd acesense-frontend
flutter pub get
flutter doctor
flutter run -d chrome
Firebase configuration is generated in lib/firebase_options.dart. Native
builds also use android/app/google-services.json and
ios/Runner/GoogleService-Info.plist; do not commit replacement credentials
from another project.
Source layout
lib/
├── config/ # build and runtime flags
├── ds/ # design tokens and reusable widgets
├── features/ # feature-sliced screens
├── l10n/ # six-language localization
├── models/ # Firestore and analysis models
├── routing/ # go_router and auth redirect
├── services/ # Firebase, upload, analysis, coach, notifications
└── state/ # Riverpod providers
Verify
flutter analyze --no-fatal-infos
flutter test --coverage
dart run tool/check_coverage.dart 100 lib/models/job.dart lib/services/ai_consent_service.dart
Run a focused test with its real path, for example:
flutter test test/unit/services/storage_service_test.dart
Build and deploy web
flutter build web --release
firebase deploy --only hosting:app,firestore:rules,storage --project acesense-prod
The checked-in ./deploy.sh performs those two commands. Firebase Hosting
serves build/web and rewrites unknown paths to index.html for go_router.
Common setup failures
| Symptom | Check |
|---|---|
| Package resolution fails | flutter --version, then flutter clean && flutter pub get |
| Firebase calls fail | Project ID is acesense-prod; Functions use europe-west1 |
| Upload is rejected | User has an active entitlement/trial and durable AI consent |
| Route opens sign-in | The route is protected and no Firebase user is signed in |
Related
Was this page helpful?