Skip to content

Repository files navigation

RepForge 🏋️

Your ultimate companion to forge strength, track progress, and shatter your fitness goals.

Flutter BadgeDart BadgeStars BadgeForks BadgeIssues BadgeLicense Badge


📖 About RepForge

RepForge (formerly Workout-logger) is an open-source, beautifully designed workout logging mobile application built with Flutter. Whether you're a powerlifter, a casual gym-goer, or someone just starting their fitness journey, RepForge empowers you to track your workouts seamlessly, visualize your progress with detailed analytics, and stay motivated.

Tired of subscription-heavy fitness apps? RepForge is built by lifters, for lifters. It keeps your data local, offline, and completely under your control.

✨ Key Features

  • 📊 Advanced Analytics: Volume trends, per-exercise progression with estimated 1RM, muscle-group focus and recovery balance, and a full personal-records log — powered by fl_chart.
  • ⚡ Super-Fast Logging: An intuitive active-workout flow with AI-suggested weight/reps for your next set, dropsets, and rest timers that gets out of your way so you can focus on the pump.
  • 🗓️ Routines & Programs: Build reusable routines, queue up your next session, and follow structured multi-week training programs.
  • 🫀 Health Connect Integration: Syncs workouts to Android Health Connect and reads sleep/heart-rate data back in to score daily training readiness.
  • 🤖 AI Coach: A conversational, tool-calling coach (powered by Gemini) that can query your own workout history, chart correlations, and explain your progress — see Anti-Features below.
  • 📱 Offline-First: Your data is stored locally for fast, secure access anywhere, even without internet.
  • 🔄 Export/Import: Never lose your data. Back up and restore your workout history at your convenience.
  • 🎨 Custom Theming: A modern, soft-futurist interface with a consistent design system.

📸 Screenshots

Home dashboardRoutinesActive workout loggingWorkout historyAnalytics overview

Exercise progressionHealth Connect settingsAI Coach analysisAI Coach muscle recovery

🚫 Anti-Features

RepForge's core workout logging, routines, and analytics work fully offline. The AI Coach is optional and relies on Google's Gemini API over the network — it's the only feature that isn't free/local, and it's disclosed as such in the app's F-Droid listing.


🚀 Getting Started

Want to take RepForge for a spin or contribute? Follow these steps to build the application on your local machine.

Prerequisites

  • Flutter SDK
  • Android Studio / VS Code
  • An Android device or emulator

Installation

  1. Clone the repository:

    git clone https://github.com/Devasy/RepForge.git
    cd RepForge/workout-logger
  2. Install dependencies:

    flutter pub get
  3. Run the app:

    flutter run

Building for Production

To build a release APK for Android:

flutter build apk --release --split-per-abi

The APKs will be available under build/app/outputs/flutter-apk/.

Getting the App


🤝 Contributing to RepForge

We believe in the power of open-source! Whether you want to fix a bug, add a feature, or improve documentation, your contributions are highly welcome and appreciated.

How to Contribute

  1. Fork the repository and clone it to your local machine.
  2. Create a new branch: git checkout -b feature/your-awesome-feature.
  3. Make your changes and commit them: git commit -m 'Add some feature'.
  4. Push to the branch: git push origin feature/your-awesome-feature.
  5. Open a Pull Request and describe your changes.

What to work on?

Check out the Issues tab! If you have a new idea, feel free to open a new issue for a feature request or bug report before starting your work. Whether it's a UI tweak, performance upgrade, or a brand new workout mode, we'd love to see it!

Development Guidelines

  • Follow standard Flutter and Dart formatting (flutter format .).
  • Keep state management clean and modular (we use Provider).
  • Ensure your PR doesn't break existing behaviors and try to add tests for new logic (flutter test).

🛡️ License

RepForge is licensed under the Apache License 2.0.

👨‍💻 Developer

Devasy Patel


Forge your strength, track your progress, achieve your goals! 💪

About

🏋️ RepForge: A beautifully designed, offline-first Flutter workout logger with advanced analytics. Built by lifters, for lifters

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages