https://github.com/extrawest/ew_flutter_water_tracker_app
https://github.com/extrawest/ew_flutter_water_tracker_app
cloud-messaging crashlytics dart demo extrawest firebase firebase-auth firebase-firestore firebase-hosting firestore flutter flutter-web remote-config water-tracker web
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/extrawest/ew_flutter_water_tracker_app
- Owner: extrawest
- Created: 2023-02-13T13:38:34.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-02-14T07:26:53.000Z (over 3 years ago)
- Last Synced: 2025-10-25T07:41:35.825Z (8 months ago)
- Topics: cloud-messaging, crashlytics, dart, demo, extrawest, firebase, firebase-auth, firebase-firestore, firebase-hosting, firestore, flutter, flutter-web, remote-config, water-tracker, web
- Language: Dart
- Size: 1.17 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Water Tracker Flutter App
[]()
[](mailto:roman.ovsepian@extrawest.com)
[]()
Project Info
* Water Tracker works with Flutter latest version
* Water Tracker is integrated with firebase services(authentication, firestore, storage, analytics, crashlytics, dynamic links, remote config, cloud messaging)
* App is built with BloC state managment
* Codemagic is used to make production builds
#### DEMO
https://user-images.githubusercontent.com/117409513/218480278-65053377-f4ff-41a3-b658-12db384ff1a7.mp4
#### PRODUCTION
In main_prod.dart set AppConfig() with
such parameters:
dart
final configuredApp = AppConfig(
appName: ,
flavorName: 'prod',
apiUrl: ,
child: Application(),
);
#### DEVELOPMENT
Follow the same process, but fill the empty fields with the development values
dart
final configuredApp = AppConfig(
appName: 'DEV ',
flavorName: 'dev',
apiUrl: ,
child: Application(),
);
## Releasing a production build
In order to create a new production release on Android, you have to push to master branch or merge development branch with master.
Push to master branch.
shell
git push origin master
or make pull request to master branch on your remote repository.
GitLab repository and Codemagic have triggers on this events, so the build will start.
### Installing:
**1. Clone this repo to your folder:**
```
git clone https://github.com/extrawest/ew_flutter_water_tracker_app.git
```
**2. Change current directory to the cloned folder:**
```
cd ew_flutter_water_tracker_app
```
**3. Get packages**
```
flutter pub get
```
## Firebase Distribution
1. In order to get proper Firebase Access Token for Firebase Distribution uploading you need to
perform the following command:
shell
firebase login:ci
2. Login with the needed account (which is added to the Firebase Console of the project)
3. Get back to the terminal where you performed the command above and copy the Firebase Access Token
4. Set the Access Token as a value of the FIREBASE_TOKEN env var in the Codemagic workflow
Additional info:
https://firebase.google.com/docs/cli#cli-ci-systems
## Firebase Services Integration
In order to ENCODE Firebase configs (GoogleService-Info.plist, google-services.json) in
Codemagic with environment variables follow this link:
https://blog.codemagic.io/how-to-load-firebase-config-in-codemagic-with-environment-variables/
shell
openssl base64 -in GoogleService-Info.plist
shell
openssl base64 -in google-services.json
Copy the output encoded text and put it as env var GOOGLE_SERVICE_IOS and GOOGLE_SERVICE_ANDROID
respectively
In order to DECODE Firebase configs (GoogleService-Info.plist, google-services.json) from
Codemagic environment variables perform these scripts under the Pre-build script section:
shell
echo $GOOGLE_SERVICE_IOS | base64 --decode \
> $FCI_BUILD_DIR/android/app/google-services.json
echo $GOOGLE_SERVICE_ANDROID | base64 --decode \
> $FCI_BUILD_DIR/ios/Runner/GoogleService-Info.plist
### Firebase Authentication
Water tracker supports this types of firebase authentication
* Email/password
* Google Authentication
* Facebook Authentication
To add another types of authentication check https://firebase.google.com/docs/auth
### Firebase Firestore
Firestore database is used to store all needed information for each user.
* User Data(email, name, daily limit)
* Tracked water (separate document for each day)
* Fcm token
All data is secured using security rules
1. Unauthorized access to firebase services are not permitted
2. Each user has access only to it's own data based on user UUID provided
### Firebase Storage
Firestore storage is used to store user profile photo
All data is secured using security rules such as in firestore
### Firebase Analytics
Firestore storage is used to track such events
1. drink_water - event is tracked when user add water
2. photo_updated - event is tracked when user update the profile photo
3. name_updated - event is tracked when user changes the name
### Firebase Crashlytics
Firestore storage is used to track all fatal and non-fatal crashes.
### Firebase Cloud Messaging
Water tracker supports receiving notifications in background and terminated states.
Each user is automatically subscribeb on the topic
"reminders" in cloud_messaging.
### Firebase Remote Config
Remote config is used for changing the progress indicator of drunk water during the day. There are two options: 'linear' and 'circular', so it can be changed in firebase console/remote config and users will see the update without new build
### Firebase Dynamic Links
Dynamic links gives each user ability to share his daily progress with others. User can just copy the link or share it to other social media with the share_plus package(https://pub.dev/packages/share_plus)
Created by Roman Ovsepian
[Extrawest.com](https://www.extrawest.com), 2022
---