A Flutter mobile application that provides a gentle wake-up experience through sunrise simulation. Wake up naturally with gradually increasing screen brightness that mimics a beautiful sunrise.
- Sunrise Simulation: Gradual brightness increase before alarm time
- Multiple Alarms: Schedule as many alarms as you need
- Repeat Patterns: Set alarms for specific days of the week
- Customizable Sunrise: Adjust sunrise duration (5-60 minutes)
- Modern UI: Beautiful dark theme with sunrise-inspired colors
- Smart Scheduling: Automatic calculation of next alarm time
- Snooze Support: Default 5-minute snooze
- Vibration: Haptic feedback on alarm
- Background Launch: Wakes screen automatically even when locked
- Reliable Execution: Uses Android Intents to force app to foreground on alarm
Built with Clean Architecture and MVVM pattern for:
- ✅ Separation of concerns
- ✅ Testability
- ✅ Maintainability
- ✅ Scalability
- Flutter 3.38.3 - Cross-platform UI framework
- Riverpod - State management
- Hive - Local database
- Clean Architecture - Project structure
- Isolates - Background execution
- Flutter SDK 3.38.3 or higher
- Xcode (for iOS)
- Android Studio (for Android)
# Clone the repository
git clone https://github.com/alvarog2491/wakeup-city.git
# Enter the directory
cd wakeup-city
# Get dependencies
flutter pub get
# Generate code
flutter pub run build_runner build --delete-conflicting-outputs
# Run the app
flutter runComing soon
# Run all tests
flutter test
# Run with coverage
flutter test --coverageSee DEVELOPMENT_GUIDE.md for detailed development instructions, architecture overview, and contribution guidelines.
WakeUp City follows modern mobile design principles:
- Minimalist: Clean, uncluttered interface
- Intuitive: Easy to use, no learning curve
- Beautiful: Sunrise-inspired color palette
- Accessible: High contrast, readable fonts
Private project - All rights reserved
Developed with ❤️ using Flutter
Version: 1.0.1