ᅠ
ᅠ
Authors: Emil Khabibulin, Tasneem Toolba
- Requirements
- API
- Getting Started
- Services folder
- Deployment
- You can test the app from here
- Want to contribute?
This is the frontend part of InnoTutor, it's done by Flutter.
Check the main README for glossary, stakeholder roles, and diagrams used here: https://github.com/InnoTutor/README
Technical Stack:
- Flutter (FrontEnd): UI cross-platform applications for Android, IOS, and WEB
- Visual Studio Code and Android Studio are used as an IDE
For this open-source project, we used the simplest registration way via Google Firebase
- as a website user, you need to have a Google account
- as a developer, who is going to host this project version, you need to get your own Google credentials.
In case of using this project in Innopolis University we'll change authentication to innopolis email login page.
- Backend Development Team
- Developer 1 – Frontend developer. Integrate backend with frontend and implement the logic of UI elements.
- Developer 2 – Frontend developer. Create and implement a user-friendly design using Flutter, containing all the features made on the backend where all developers will test their parts before integrating parts.
Stake: Development process
There is documentation with all requests which backend supports. So frontend must communicate with it via API. You can read about API documentation here
- Android Studio: https://flutter.dev/docs/get-started/editor
- Visual Studio Code: https://flutter.dev/docs/get-started/editor
You can git clone using the repository link git clone https://github.com/InnoTutor/Frontend.git
flutter pub get
flutter pub run build_runner build --delete-conflicting-outputs
all .g.dart files are generated using this command, so in order to change them, you need to change the model then run the command above, considering the synchronisation of the models and file names. for more info, check: https://flutter.dev/docs/development/data-and-backend/json
flutter run -d chrome --web-hostname localhost --web-port 7357 --web-renderer=html
The used method in logging in is google API, by adding the localhost link in OAuth2.0 here https://console.cloud.google.com/apis/credentials , mentioning the used port (7357 in this case).
It's for getting data from the backend(you can check the backend repo for more information). it follows the backend documentation, https://documenter.getpostman.com/view/16213957/UUy65PgU , consider the order of classes and functions as in the backend documentation to avoid any confusion.
To generate the release files of the web version that you need to deploy, you need to apply,
flutter build web --release
Github Pages is used to deploy the website version of the Flutter app, you need to cd build/web, then init a new repo and push files there to a new branch, that you would mention/choose in GitHub pages. It's worth mentioning that you need to add the generated link by GitHub pages to the Authorised JavaScript origins in the credentials to be able to use Google login API as mentioned in AuthServices above.
https://innotutor.github.io/Frontend/
You can contribute to this project. Just fork the repository from the develop
branch, implement changes you want to propose and make a pull request.
Also, there are issues, so feel free to submit a new one or participate in existing.