🚀 ION Workout App

Welcome to the ION Workout App! This project is split across several repositories that handle the app, server, data, and exercise images.

📂 Repositories

📱 "App" (https://github.com/ION-WorkoutApp/app)

The Android front end, built with Kotlin. This is where the main user experience lives.

🌐 "Server" (https://github.com/ION-WorkoutApp/server)

The back end, built with JavaScript.

You can host the server yourself if you want full control over the setup. See the "setup guide" (https://github.com/ION-WorkoutApp/server?tab=readme-ov-file#setup) for instructions on running it locally or on a cloud provider.

A hosted back end is also planned and will be available at "workout.ion606.com" (https://workout.ion606.com) for $2/month.

📊 "Data" (https://github.com/ION-WorkoutApp/data)

Contains the datasets used by the app, including "megaGymDataset.csv".

🖼️ "DB Images" (https://github.com/ION-WorkoutApp/db-images)

Contains images for the exercises in the database.

This repository is based on "free-exercise-db" (https://github.com/yuhonas/free-exercise-db) and is still a work in progress. Contributions and additions are welcome, so feel free to open a pull request.

🚀 Getting Started

Each part of the project has its own setup instructions:

1. App: "Set up the Android app" (https://github.com/ION-WorkoutApp/app)
2. Server: "Set up the server/installers" (https://github.com/ION-WorkoutApp/installers?tab=readme-ov-file#ion-workout-app-installers)
3. Data: "View the datasets" (https://github.com/ION-WorkoutApp/data)
4. Images: "View the exercise images" (https://github.com/ION-WorkoutApp/db-images)

If you're using the hosted back end, you'll need an active subscription through "workout.ion606.com" (https://workout.ion606.com).

📜 License

The db-images repository is licensed under the Unlicense. See its "LICENSE.md" (https://github.com/ION-WorkoutApp/db-images/blob/main/LICENSE.md) for details.

For the other repositories, check the "LICENSE" file in each repository.

🤝 Contributing

Contributions are welcome! If you'd like to help improve the project, check the contribution guidelines in the individual repositories and submit a pull request.

🙏 Acknowledgements

Thanks to:

• Ollie Jennings for the original "exercises.json" dataset.
• Flaticon for the favicon.

You can find all of the project's repositories in the "ION Workout App GitHub Organization" (https://github.com/ION-WorkoutApp)!