Skip to content

PRINCEISAH/workout-app-gemini

Repository files navigation

Workout App - AI-Powered Fitness Companion

A Flutter fitness app powered by Google Gemini API that generates personalized workout plans with an interactive execution interface.

🎯 Features

Home Screen | Modern dark theme with stats overview, progress tracker, and quick action buttons.

AI Workout Generation | Gemini API creates personalized plans based on fitness goal, experience level (Beginner/Intermediate/Advanced), and duration (20-60 min). Includes Warm Up, Main Workout, Cool Down, and Nutrition Tips.

Interactive Execution | Three-stage system: Preview modal → 3-sec countdown → Section-by-section navigation. Color-coded sections (Warm Up 🟠, Main 🔴, Cool Down 🔵, Nutrition 🟢) with progress bar, "ACTIVE" badges, and Next/Previous controls.

Quick Start Templates | Pre-built routines: Full Body HIIT (30min), Core Crusher (20min), Upper Body Strength (30min).

Smooth Animations | Fade/slide transitions, animated countdown display, expansion animations.

Color Palette | Dark: #1A1A2E | Orange: #FF6B35 | Blue: #004E89 | Green: #1EBE73

📱 Screens

Screen Purpose
home_screen.dart Dashboard with stats & feature access
generate_workout_screen.dart Custom workout creation & execution modal
start_workout.dart Quick-start template selection (bottom sheet)
workout_details_screen.dart Detailed workout info with hero image & exercises

🔧 Tech Stack

  • Flutter + Dart
  • Google Gemini API (flutter_gemini)
  • Firebase Core, AnimationController, Material Design
  • Architecture: StatefulWidget with TickerProviderStateMixin, async/await pattern, typed models

📸 Screenshots

Home Screen
Home Screen
Generate Workout
Generate Workout
Workout Preview
Workout Preview
Active Workout
Active Workout

🚀 Quick Start

git clone https://github.com/PRINCEISAH/flutter-gemini-workout-app.git
cd workoutapp
flutter pub get
# Add Gemini API key to config/api_config.dart
flutter run

🎮 Usage

  1. Generate: Select goal → Choose level → Pick duration → Tap "GENERATE"
  2. Execute: Preview workout → Start countdown → Navigate sections → Complete
  3. Quick Start: Select template → Start or view details

🚧 Planned Features

  • Workout history & personal records
  • Voice guidance during workouts
  • Fitness tracker integration
  • Offline mode
  • Music playlists
  • Social sharing

📄 License

MIT License - Open source for fitness enthusiasts


Note: Requires active internet connection for Gemini API during workout generation.

About

Flutter Gemini Fitness App is a cross-platform mobile app built with Flutter and integrated with Google Gemini AI. It generates customized workout plans tailored to each user’s fitness level and goals, helping them train smarter and stay motivated.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors