mobile

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.

Start app

:caution: Android Studio must be installed!

Run in order to get added/updated/deleted dependencies:

flutter pub get

To start the application launch emulator:

flutter emulators --launch <emulator_ID>

for example:

flutter emulators --launch Pixel_7

...and then start the application in emulator

flutter run

Translations

In assets/lang are stored languages in json format. If you have new label then manually add translation in en/pl.json file:

{
  "welcome": "Witamy ponownie"
}

and the equivalent in other languages ie pl:

{
  "welcome": "Welcome back"
}

where the key will be used to retrieve the translation. After that you must restart the app via flutter run command.

In order to use translation provide:

  Text(AppLocalizations.of(context).translate('welcome'))

where welcome is the key from the json translation file.

⚠️ AppLocalizations.of(context).translate('welcome') will only work inside Text widget

Recommended key naming convention:

{
  "<component|widget|page|view>_<in_snake_case_name_whatever_you_want>"
}

After adding new translations the application must be restarted.

Authorization

Authorization is based on JWT token which is held in SharedPreferences under the name jwt_token

Handling of the token and session is controlled by the methods implemented in lib/tools/token_handler.dart.

When handling the requests it needs to be controlled when the API responds with status code 401. Whet this status code is present following method should be used:

logout(BuildContext context)

This method takes context as a parameter to completely logout the user and redirects him to login page.