https://github.com/josephdourden/settimer
A minimalist workout timer app designed specifically for set-based workouts like ab/core training, HIIT, and interval training. Focus on your workout while Workout Set Timer handles the timing automatically.
https://github.com/josephdourden/settimer
fitness flutter ios-app mobile-app timer workout
Last synced: 3 months ago
JSON representation
A minimalist workout timer app designed specifically for set-based workouts like ab/core training, HIIT, and interval training. Focus on your workout while Workout Set Timer handles the timing automatically.
- Host: GitHub
- URL: https://github.com/josephdourden/settimer
- Owner: JosephDoUrden
- License: mit
- Created: 2025-06-09T19:34:57.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-19T09:37:29.000Z (4 months ago)
- Last Synced: 2025-06-19T10:38:56.236Z (4 months ago)
- Topics: fitness, flutter, ios-app, mobile-app, timer, workout
- Language: Dart
- Homepage: https://apps.apple.com/tr/app/workout-set-timer/id6747051697
- Size: 10.4 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Workout Set Timer 🏋️♂️
A minimalist workout timer app designed specifically for set-based workouts like ab/core training, HIIT, and interval training. Focus on your workout while Workout Set Timer handles the timing automatically.
**Created by [Yusufhan Saçak](https://yusufhan.dev/)** as an open source project demonstrating modern Flutter development practices while providing real value to the fitness community.
## ✨ Features
- **Custom Set Configuration**: Set any number of sets (1-20)
- **Flexible Duration**: Configure set duration from 10 seconds to 5 minutes
- **Smart Rest Intervals**: Automatic rest periods after every N sets
- **Auto-Progression**: Automatically moves between sets and rest periods
- **Background Support**: Continue workouts with screen locked or app in background
- **Audio Alerts**: Clear sound notifications for set start/end and rest periods
- **Modern UI**: Dark theme with beautiful gradients and intuitive controls
- **One-Tap Start**: Simple interface focused on workout flow
- **Progress Tracking**: Visual progress bar and set counter
## 📱 Screenshots
*Beautiful dark theme with modern gradients and intuitive controls*
## 🚀 Getting Started
### Prerequisites
- Flutter 3.5.3 or higher
- Dart SDK 3.5.3 or higher
- Android Studio / Xcode for device testing
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/JosephDoUrden/settimer.git
cd settimer
```
2. **Install dependencies**
```bash
flutter pub get
```
3. **Run the app**
```bash
flutter run
```
### Building for Release
#### Android
```bash
# Debug APK
flutter build apk --debug
# Release APK
flutter build apk --release
# App Bundle for Play Store
flutter build appbundle --release
```
#### iOS
```bash
# Open in Xcode
open ios/Runner.xcworkspace
# Build from command line
flutter build ios --release
```
## 🎯 How to Use
1. **Configure Settings**: Tap the settings button to customize:
- Total number of sets
- Duration per set
- Rest duration
- Rest interval (after how many sets)
2. **Start Workout**: Tap the play button to begin
3. **Hands-Free Operation**: The app automatically handles:
- Set countdown
- Rest periods
- Moving to next set
- Workout completion
4. **Control Options**:
- **Pause**: Pause the current timer
- **Reset**: Reset to beginning
- **Settings**: Modify configuration (only when stopped)
## 🏗️ Architecture
Workout Set Timer follows clean architecture principles with MVC pattern:
```
lib/
├── controllers/ # Business logic and state management
│ └── timer_controller.dart
├── models/ # Data models
│ └── timer_model.dart
├── services/ # External services
│ ├── audio_service.dart
│ └── background_service.dart
├── views/ # UI components
│ └── timer_view.dart
└── main.dart # App entry point
```
### Key Technologies
- **State Management**: Provider pattern with ChangeNotifier
- **Audio**: flutter_ringtone_player for system sounds and notifications
- **Background Processing**: App lifecycle management with timer synchronization
- **UI**: Material Design 3 with custom dark theme and animations
- **Platform Integration**: Native iOS audio session and Android wake lock support
## 🎨 Design Philosophy
Workout Set Timer embraces minimalism with a focus on:
- **Zero Distraction**: Clean interface without unnecessary elements
- **Workflow**: Automatic progression eliminates manual intervention
- **Visual Clarity**: High contrast dark theme with accent colors
- **Accessibility**: Large touch targets and clear visual hierarchy
### Color Palette
- **Primary (Work)**: `#00D4AA` - Energizing teal
- **Secondary (Rest)**: `#FF6B35` - Calming orange
- **Background**: `#0A0A0A` to `#2A2A2A` gradient
- **Text**: White with varying opacity for hierarchy
## 🔧 Configuration
### Default Settings
- **Sets**: 3
- **Set Duration**: 30 seconds
- **Rest Duration**: 10 seconds
- **Rest Interval**: Every 1 set
### Customization Ranges
- **Total Sets**: 1-20
- **Set Duration**: 10-300 seconds
- **Rest Duration**: 5-120 seconds
- **Rest Interval**: 1-5 sets
## 📱 Platform Support
### Android
- **Minimum SDK**: API 21 (Android 5.0)
- **Target SDK**: API 34 (Android 14)
- **Permissions**: WAKE_LOCK, VIBRATE
- **Features**: Background processing, system sounds
### iOS
- **Deployment Target**: iOS 12.0+
- **Orientation**: Portrait only
- **Background Modes**: background-processing, background-fetch
- **Audio**: Background audio session support
## 🧪 Testing
### Manual Testing Checklist
- [ ] Timer counts down correctly
- [ ] Set transitions work automatically
- [ ] Rest periods trigger at correct intervals
- [ ] Background mode maintains timer
- [ ] Sound alerts play at appropriate times
- [ ] Settings persist between sessions
- [ ] App handles orientation locks
- [ ] No crashes during extended use
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/amazing-feature`
3. Commit changes: `git commit -m 'Add amazing feature'`
4. Push to branch: `git push origin feature/amazing-feature`
5. Open a Pull Request
### Development Guidelines
- Follow Flutter best practices
- Maintain clean architecture separation
- Add tests for new features
- Update documentation for API changes
- Use conventional commit messages
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Flutter team for the amazing framework
- Material Design for UI inspiration
- flutter_ringtone_player package for audio functionality
- Provider package for state management
## 📞 Support & Contact
- **Issues**: [GitHub Issues](https://github.com/JosephDoUrden/settimer/issues)
- **Discussions**: [GitHub Discussions](https://github.com/JosephDoUrden/settimer/discussions)
- **Website**: [yusufhan.dev](https://yusufhan.dev/)
## 👨💻 Author
**Yusufhan Saçak**
- **LinkedIn:** [Yusufhan Saçak](https://www.linkedin.com/in/yusufhansacak/)
- **Twitter:** [@0xSCK](https://twitter.com/0xSCK)
- **Medium:** [My Medium Profile](https://medium.com/@yusufhansacak)
- **Website:** [yusufhan.dev](https://yusufhan.dev/)
For business inquiries, please use LinkedIn or the contact form on my website.
---
**Workout Set Timer** - Focus on your workout, let us handle the timing. 💪
Built with ❤️ using Flutter