mirror of
https://github.com/wger-project/flutter.git
synced 2026-02-18 00:17:48 +01:00
86 lines
3.3 KiB
Markdown
86 lines
3.3 KiB
Markdown
# 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!
|
|
|
|
|
|
<p>
|
|
<img src="https://raw.githubusercontent.com/wger-project/flutter/master/fastlane/metadata/android/en-US/images/phoneScreenshots/01%20-%20dashboard.png" width="200" alt="" />
|
|
|
|
<img src="https://raw.githubusercontent.com/wger-project/flutter/master/fastlane/metadata/android/en-US/images/phoneScreenshots/04%20-%20measurements.png" width="200" alt="" />
|
|
|
|
<img src="https://raw.githubusercontent.com/wger-project/flutter/master/fastlane/metadata/android/en-US/images/phoneScreenshots/05%20-%20nutritional%20plan.png" width="200" alt="" />
|
|
</p>
|
|
|
|
## Installation
|
|
|
|
[<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png"
|
|
alt="Get it on Google Play"
|
|
height="80">](https://play.google.com/store/apps/details?id=de.wger.flutter)
|
|
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
|
|
alt="Get it on F-Droid"
|
|
height="80">](https://f-droid.org/packages/de.wger.flutter/)
|
|
|
|
## Development
|
|
|
|
### 1
|
|
|
|
Install the [wger server](https://github.com/wger-project/wger), 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.27
|
|
|
|
### 3
|
|
|
|
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](https://hosted.weblate.org/engage/wger/).
|
|
|
|
[](https://hosted.weblate.org/engage/wger/)
|
|
|
|
## 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.
|
|
|