<p align="center"> <img src="assets/images/icon.png" alt="Ledge Logo" width="150"/> </p>

RepForge

<p align="center"> <img src="assets/images/repforge1.png" alt="Ledge Screenshot 1" width="300" style="margin-right:10px;"/> &nbsp;&nbsp; <img src="assets/images/repforge2.png" alt="Ledge Screenshot 2" width="300"/> </p>

Features

• Workout Tracking: Log your workouts with detailed set and rep tracking
• Progress Monitoring: Visualize your training volume trends with charts
• Exercise Database: Comprehensive exercise library with detailed instructions
• Streak Counter: Maintain your workout streak to build consistency
• Rest Timer: Built-in rest timer for optimal workout pacing
• Performance Insights: Get insights on your most frequent exercises and workout patterns
• Data Persistence: All data is stored locally on your device
• Data Management: Export, import, or reset your workout data
• Monochrome UI: Premium grayscale interface with smooth animations

Getting Started

Prerequisites

• Flutter SDK (version 3.9.0 or higher)
• Dart SDK
• Android Studio or VS Code with Flutter extensions

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/repforge.git
   

2. Navigate to the project directory:

   cd repforge
   

3. Install dependencies:

   flutter pub get
   

4. Run the app:

   flutter run
   

Project Structure

lib/
├── database/          # Database helper and models
├── models/            # Data models
├── providers/         # State management providers
├── screens/           # UI screens
├── theme/             # App theme and styling
├── widgets/           # Custom widgets
└── main.dart          # Entry point

Dependencies

• flutter: UI toolkit
• provider: State management
• sqflite: Local database
• path: Path manipulation
• flutter_animate: Smooth animations
• google_fonts: Custom fonts
• fl_chart: Charting library
• intl: Internationalization
• shared_preferences: Persistent settings

Architecture

RepForge follows a clean architecture pattern with:

• Model-View-Provider (MVP) pattern
• SQLite for local data persistence
• Provider for state management
• Custom theming for consistent UI

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a new branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a pull request

Code Style

• Follow the Effective Dart style guide
• Use meaningful variable and function names
• Write clear comments for complex logic
• Keep functions small and focused

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Inspired by modern fitness tracking applications
• Built with Flutter and passion for fitness
• Uses open-source libraries to provide the best user experience

Support

If you encounter any issues or have questions, please open an issue on GitHub.