Skip to content

Repository files navigation

IWT - Interval Walking Training πŸšΆβ€β™‚οΈπŸƒ

A modern Android fitness app that guides users through Interval Walking Training (IWT) with an intuitive interface, smart features, and motivational elements.

πŸ“± App Overview

IWT (Interval Walking Training) alternates between periods of fast and slow walking to improve cardiovascular health and overall fitness. The app provides guided workouts with haptic feedback, progress tracking, and a beautiful modern UI.

✨ Current Features

πŸƒβ€β™‚οΈ Core Workout Features

  • Guided Interval Training: Alternating 3-minute slow/fast walk intervals
  • Customizable Duration: 15-60 minute workout sessions
  • Warm-up & Cool-down: Optional 3-minute warm-up and cool-down phases
  • Haptic Feedback: Vibration cues for workout start/end and phase transitions
  • Audio Feedback: Beep sounds for workout start and phase changes
  • Real-time Timer: Live countdown with monospaced font for accuracy
  • Progress Tracking: Visual timeline showing current phase and progress
  • Pause/Resume: Full workout control with state preservation

🎯 Achievements & Motivation

  • Daily Streaks: Track consecutive days of workouts
  • Weekly Streaks: Monitor weekly consistency
  • Achievement System: Unlock badges for milestones
    • First workout, 3/7/14/30-day streaks
    • Weekly consistency badges
    • Total workout milestones (10, 50, 100)
  • Motivational Messages: Dynamic quotes and encouragement
  • Progress Visualization: Beautiful cards showing current stats

πŸ“± Home Screen Widget

  • Quick Start: Start workouts directly from home screen
  • Live Progress: Real-time timer and current activity display
  • Smart Controls: Resume/pause/end buttons based on workout state
  • Streak Display: Shows current daily streak
  • Last Workout Info: Quick access to recent activity
  • Modern Design: Blue gradient background matching app theme

🎨 Modern UI/UX

  • Material Design 3: Latest Android design language
  • Dark/Light Theme: System theme support with manual override
  • Animated Elements: Pulsing timer, glowing effects, shimmer animations
  • Responsive Layout: Adapts to different screen sizes
  • System Navigation Support: Proper handling of gesture navigation
  • Top App Bar: Clean navigation with app branding
  • Bottom Controls: Always-accessible workout controls

πŸš€ Onboarding & Tutorial

  • Two-Page Onboarding: Interactive introduction to IWT
  • Feature Highlights: Showcase key app capabilities
  • First Launch Only: Smart detection prevents repetition
  • Modern Pager: Smooth horizontal navigation with indicators

πŸ“ž In-App Feedback

  • Feedback Dialog: Built-in feedback form
  • Direct Email: Sends feedback directly to developer
  • Contact Information: Easy access to support email
  • Collapsible Info Cards: Organized help and information

βš™οΈ Settings & Customization

  • Workout Duration: 15-60 minute range with slider
  • Theme Preferences: Light, dark, or system default
  • Warm-up/Cool-down: Toggle optional phases
  • Full-Screen Settings: Dedicated settings screen with cards

πŸ”’ Privacy & Security

  • Local Data Storage: All data stays on device
  • No Tracking: No personal information collection
  • Play Integrity API: Optional device integrity verification
  • Permission Minimal: Only essential permissions requested

🎯 Phase 1 Features (βœ… Completed)

βœ… Achievements & Streaks

  • Daily and weekly streak tracking
  • Achievement system with badges
  • Motivational messages
  • Progress display in main screen and widget

βœ… Widget Enhancements

  • Live workout progress display
  • Quick start functionality
  • Streak and achievement showcase
  • Smart button states (resume/pause/end)

βœ… Onboarding/Tutorial

  • Two-page interactive onboarding
  • Feature introduction
  • First-launch detection
  • Modern pager navigation

βœ… In-App Feedback

  • Feedback dialog with email integration
  • Direct contact information
  • Collapsible info cards for better organization

πŸš€ Phase 2 Features (Coming Soon)

πŸ“Š Workout History & Analytics

  • Workout Log: Complete history of all sessions
  • Progress Charts: Visual progress over time
  • Statistics Dashboard: Detailed analytics and insights
  • Export Data: Share progress with health apps

πŸŽ›οΈ Custom Intervals

  • Flexible Timing: Customize interval durations
  • Multiple Patterns: Create different workout types
  • Preset Workouts: Quick access to common patterns
  • Personalized Plans: Save custom workout configurations

πŸ—£οΈ Voice Guidance

  • Audio Cues: Voice announcements for phase changes
  • Motivational Messages: Encouraging voice prompts
  • Accessibility: Support for screen readers
  • Customizable Voice: Multiple voice options

☁️ Cloud Sync & Backup

  • Data Backup: Secure cloud storage of progress
  • Multi-Device Sync: Access data across devices
  • Account System: User profiles and preferences
  • Offline Support: Works without internet

πŸ”” Smart Reminders

  • Scheduled Workouts: Set recurring workout times
  • Smart Notifications: Context-aware reminders
  • Weather Integration: Adjust based on conditions
  • Goal Tracking: Reminders based on fitness goals

🎨 Enhanced Customization

  • Custom Themes: More color scheme options
  • Widget Customization: Multiple widget sizes and styles
  • Animation Preferences: Adjust animation intensity
  • Accessibility Options: Enhanced accessibility features

πŸ“€ Social Features

  • Progress Sharing: Share achievements on social media
  • Friend Challenges: Compete with friends
  • Community Features: Connect with other users
  • Leaderboards: Global and friend-based rankings

πŸ”§ Advanced Settings

  • Workout Presets: Save favorite configurations
  • Advanced Analytics: Detailed performance metrics
  • Integration Options: Connect with fitness apps
  • Developer Options: Advanced debugging features

πŸ› οΈ Technical Features

πŸ”§ Core Technologies

  • Kotlin: Modern Android development
  • Jetpack Compose: Declarative UI framework
  • Material Design 3: Latest design system
  • Coroutines: Asynchronous programming
  • DataStore: Modern data persistence
  • Navigation Compose: Type-safe navigation

πŸ“± Platform Features

  • Foreground Service: Persistent workout tracking
  • Home Screen Widget: App widget implementation
  • Notification System: Rich notification support
  • Haptic Feedback: Vibration and audio cues
  • Play Integrity API: Device integrity verification
  • Permission Handling: Modern permission management

🎨 UI/UX Features

  • Responsive Design: Adapts to all screen sizes
  • Animation System: Smooth transitions and effects
  • Theme Support: Dynamic color theming
  • Accessibility: Screen reader and navigation support
  • Gesture Support: Modern Android navigation

πŸ“‹ Installation & Setup

Prerequisites

  • Android Studio Arctic Fox or later
  • Android SDK 34+
  • Kotlin 1.9+
  • Minimum Android API 24 (Android 7.0)

Building the App

# Clone the repository
git clone [repository-url]

# Open in Android Studio
# Or build from command line
./gradlew build

Required Permissions

  • POST_NOTIFICATIONS: For workout progress notifications
  • VIBRATE: For haptic feedback during workouts
  • INTERNET: For Play Integrity API (optional)

🀝 Contributing

This is a personal project, but feedback and suggestions are welcome through the in-app feedback system.

πŸ“„ License

This project is for personal use and educational purposes.

πŸ“ž Contact


IWT - Making interval walking training accessible, enjoyable, and effective! πŸšΆβ€β™‚οΈπŸƒβ€β™‚οΈ

About

IWT - Interval Walking Training

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages