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.