Mobile app for wger Workout Manager

wger is a free, open-source flutter application that manages and tracks/logs your exercises and personal workouts, weight, and diet plans. This is the mobile app written with Flutter, it talks via REST with the main server.

If you want to contribute, hop on the Discord server and say hi!

Installation

Development

1

Install the wger server, the easiest way is to start the development docker-compose: https://github.com/wger-project/docker

Alternatively, you can use the test server (the db is reset every day):

• URL: https://wger-master.rge.uber.space
• username: user
• password: flutteruser
• API key: 31e2ea0322c07b9df583a9b6d1e794f7139e78d4

2

Install Flutter and all its dependencies, and create a new virtual device: https://flutter.dev/docs/get-started/install.

The app currently uses flutter 3.19

3

The application will complain about an API key not being set. You can just ignore this during development, this is only important if you want to register directly over the app. If you just want to login, you can skip this section.

If you want to register directly over the app, you need to set a user on the backend that is allowed to do this. For this, create/register a new user, generate an api key and run python3 manage.py add-user-rest theusername (you can later list all the registered users with python3 manage.py list-users-api).

Then create a new file wger.properties in fastlane/metadata/envfiles/ and add the key:

WGER_API_KEY=123456

Alternatively, add the key as an environment variables, e.g. by running the source command on the file.

4

Start the application with flutter run or use your IDE (please note that depending on how you run your emulator you will need to change the IP address of the server)

You can run the tests with the flutter test

Translation

Translate the app to your language on Weblate.

Contact

Feel free to get in touch if you found this useful or if something didn't behave as expected. We can't fix what we don't know about, so please report liberally. If you're not sure if something is a bug or not, feel free to file a bug anyway.

• Discord: https://discord.gg/rPWFv6W
• Issue tracker: https://github.com/wger-project/flutter/issues
• Mastodon: https://fosstodon.org/@wger

License

The application is licensed under the GNU Affero General Public License 3 or later (AGPL 3+) with an app store exception.

As additional permission under section 7, you are allowed to distribute the software through an app store, even if that store has restrictive terms and conditions that are incompatible with the AGPL, provided that the source is also available under the AGPL with or without this permission through a channel without those restrictive terms and conditions.

The initial exercise and ingredient data is licensed additionally under one of the Creative Commons licenses, see the individual exercises for more details.