Clone the repo by running
$ git clone https://github.com/ECE-366-Final-Project/front_end.git
This project primarily uses Flutter! Get it here.
You can host a local instance of our frontend by running (in the root directory):
flutter pub get
$ flutter run
If running the entire system locally, a change will need to be made in generics.dart involving the port & source of the backend.
We recommend changing line 22 to const SRC = "localhost:8080";
Two chrome extensions are also necessary in this situation:
https://chromewebstore.google.com/detail/cors-unblock/lfhmikememgdcahcdlaciloancbhjino https://chromewebstore.google.com/detail/dart-debug-extension/eljbmlghnomdjgdjmbdekegdkbabckhm
The first extension allows the frontend to make localhost calls, whilst the second enables the dart debug environment in the browser. These are not necessary when accessing the production build.
For android, the Android Studio IDE is needed, alongside necessary plugins: See these instructions for more information: https://docs.flutter.dev/get-started/install/windows/mobile?tab=physical
Once you've set up the IDE, run flutter create . in a suitable development environment to create an android manifest: This then allows any android device with USB Debugging to execute the application.
The Front End has 53.9% code coverage through the tests listed in the 'test' folder within the root directory. You can test this by running:
flutter test --coverage
Within the same directory, there is a 'coverage' folder that has a 'Lcov.info' file. Drag it over to this LCOV viewer which outputs the testing breakdown outlined below.
