pwargulak / mycarehub-frontend-daktari

The operating system for healthcare

UoNAfyaApp360 Daktari

Project prerequisites

1. The UoNAfyaApp360 Daktari app runs on Flutter version 3.3.8 stable channel. To check the flutter version and channel installed in your machine run flutter --version.

2. To switch from another channel of Flutter to the stable channel run flutter channel stable.

3. To install Flutter version 3.3.8 run flutter version v3.3.8.

Looks like we are done with the prerequisites :-)

How to setup and run UoNAfyaApp360 Daktari

1. Clone the project by running git clone [email protected]:savannahghi/pro_health_360_daktari.git or download the code
2. cd pro_health_360_daktari
3. Run flutter pub get
4. You can now run the app on an attached device or emulator

How to setup and run unit, widget and integration tests locally

Unit Tests

To run unit and widget tests, you will require to install lcov by running sudo apt-get install lcov in the terminal. Finally, run the following commands in the terminal:

1. From the root folder, run flutter test --coverage test/

2. Run genhtml -o coverage coverage/lcov.info

3. To view the coverage, open the html file generated at coverage/index.html with your preferred browser.

Integration tests

To run integration tests, ensure that you have an emulator running. See instructions on how to run an emulator.

1. Then run flutter drive --target=test_driver/app.dart

Dart & Flutter Version

• Dart 2: >= 2.12
• Flutter: >=2.2.3

Developing & Contributing

First off, thanks for taking the time to contribute!

Be sure to check out detailed instructions on how to contribute to this project here and go through out Code of Conduct.

GPG Signing: As a contributor, you need to sign your commits. For more details check here

License

This library is distributed under the MIT license found in the LICENSE file.

Environment variables

In order for you to run the application locally on your machine, you will need the following environment variables

1. PROD_SENTRY_DNS and DEV_SENTRY_DNS that will be used to send error messages to your Sentry error reporting server
2. DEV_STREAM_API_KEY, DEMO_STREAM_API_KEY and PROD_STREAM_API_KEY that will be used to enable you to connect to the GetStream API

If you want to add an environment variable to CI, you will need to run the following command to encode the ENV file into a string format. The --b 0 will prevent the new lines from being encoded

base64 --b 0 --i .env

In the CI configuration, you can decode the string into the ENV variable using this command which will decode the string into the ENV file

echo $ENCODED_APP_ENV | base64 --decode > .env