ghmera_app

A new Flutter project.

Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

• Lab: Write your first Flutter app
• Cookbook: Useful Flutter samples

For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

Firebase Auth Setup

This app uses Firebase email/password authentication. New accounts are created only after the user enters the 6-digit code sent to their email, and forgotten passwords are reset with the same code-based flow.

Before running on devices, complete these setup steps:

1. Create a Firebase project and add Android and iOS apps.
2. Enable Email/Password in Firebase Console -> Authentication -> Sign-in method.
3. Add platform config files:
   • android/app/google-services.json
   • ios/Runner/GoogleService-Info.plist
4. Run flutterfire configure (recommended) to generate firebase_options.dart.
5. Copy functions/.env.example to functions/.env for local development and put SMTP_PASSWORD=... in functions/.secret.local. Both local files are ignored by Git.
6. Store the production SMTP password in Firebase Secret Manager before deploy:

firebase functions:secrets:set SMTP_PASSWORD

The configured mail server is mail.peatechservice.com:465 with SSL, the SMTP username is info@peatechservice.com, and messages are sent as PEATECH SERVICES LLC <mail@peatechservice.com>.

Workflow API Backend

Help-request workflow mutations now go through a Python Firebase Functions HTTPS endpoint named workflow_api.

Deploy the backend with:

firebase deploy --only functions

By default, the Flutter app calls:

https://us-central1-<firebase-project-id>.cloudfunctions.net/workflow_api

The project ID is read from firebase_options.dart.

If you need to point the app at a different deployed endpoint, pass a Dart define when running the app:

flutter run --dart-define=GHMERA_WORKFLOW_API_URL=https://<your-url>/workflow_api

You can also override the function region if needed:

flutter run --dart-define=GHMERA_FUNCTIONS_REGION=<region>