TimeMachine v3.0.0 - Screen Time Tracking & Tutorial System

This release introduces comprehensive screen time tracking powered by Android's
UsageStatsManager API, a beautiful onboarding tutorial for new users, and
significant architectural improvements. Track your daily phone usage, pickups,
and screen time patterns with detailed analytics and hourly breakdowns - all
while maintaining privacy with local-only data storage.

KEY FEATURES:
• 📱 Screen Time Tracking - Monitor daily usage with accurate system-level data
• 📊 Analytics Dashboard - Visualize 7-day trends and hourly usage patterns
• 🎓 Interactive Tutorial - Smooth onboarding experience for new users
• 🔋 Battery Efficient - WorkManager-based background sync (15-min intervals)
• 🔒 Privacy First - All data stored locally, no internet required
• ⚙️ Settings Enhancements - Currency selector, data backup/restore
• 🎨 UI Improvements - Material 3 design, better permission handling

COMPATIBILITY:
• Android 12+ (API 31+)
• 58 MB download size
• Storage: ~100 MB recommended

UPGRADE NOTES:
Existing users will see the new Screen Time section on the home screen. Grant
"Usage Access" permission in Settings to enable screen time tracking features.

🎉 TimeMachine v2.0.0 - Focus Tracker Rewrite + Major Updates

Major release with complete Focus Tracker rewrite, new features, and 10 critical bug fixes

📥 Download

APK: TimeMachineV2.0.0.apk (23 MB)
MD5: 624619775c92b2466774015748e20a82
Requires: Android 12+ (API 31)

✨ What's New

🔥 Focus Tracker - Complete Rewrite

• Category-based tracking for different activities
• Immersive fullscreen mode with landscape lock
• Real-time feedback: 30s countdown → green checkmark
• Universal session saving (all exit methods work)
• Advanced analytics with calendar goal view
• Customizable daily goals per category

📅 Year Calculator

• Calculate dates from years ago or future
• Full leap year support (no crashes!)
• Save calculation history

⚖️ BMI Calculator

• WHO/DGE classifications
• Visual graphs & ideal weight ranges
• Health tips & history tracking

🐛 Critical Fixes

1. ✅ Universal session saving (back gesture, EXIT button now save)
2. ✅ Leap year crash resolution (Feb 29 handling)
3. ✅ Timezone fixes (habit dates now accurate)
4. ✅ Midnight rollover fix (date caching)
5. ✅ UI refresh improvements (lifecycle observers)
6. ✅ Progress bar always visible in fullscreen
7. ✅ Back gesture in habit detail view
8. ✅ Notification banner dismiss button
9. ✅ Session save feedback (30s minimum clear)
10. ✅ Real-time UI updates

🎨 UI/UX Improvements

• Zero elevation design (no shadows)
• Vibrant color palette
• Gradient icon backgrounds
• Live countdown & confirmation indicators
• Smooth animations & transitions

🔧 Technical

• Room Database v6 (auto-migrates)
• ProGuard + R8 optimization
• Resource shrinking
• Improved performance & stability

📦 Installation

Method 1: Download APK → Enable Unknown Sources → Install

Method 2 (ADB):

adb install TimeMachineV2.0.0.apk

🔄 Upgrading from v1.x

✅ Install directly over v1.x - data migrates automatically
✅ All habits, calculations preserved
✅ Settings carry over

📚 Documentation

• Full Release Notes
• Installation Guide

🎯 What's Next (v2.1.0)

• Export/Import data
• Cloud sync (optional)
• More themes
• Home screen widgets

---

Full Changelog: v1.3.0...v2.0.0

Enjoy TimeMachine v2.0.0! ⏰✨

---

## 🏷️ Release Tags (for GitHub)

Add these tags to the release:

- `major-release`
- `android`
- `productivity`
- `time-tracking`
- `habit-tracker`
- `focus-timer`
- `bmi-calculator`

---

## 📎 Assets to Upload

Upload these files as release assets:

1. **TimeMachineV2.0.0.apk** (Required - Main download)
2. **RELEASE_NOTES_V2.0.0.md** (Optional - Detailed notes)
3. **INSTALL_GUIDE.md** (Optional - Installation instructions)

---

## 🎨 Additional Notes for Release

**Highlight:** This is a major version bump from v1.3.0 to v2.0.0 because:
- Complete rewrite of core feature (Focus Timer → Focus Tracker)
- Breaking architectural changes (new database schema)
- Significant UX paradigm shift (category-based system)

**Mark as:** ✅ Latest Release

**Pre-release:** ❌ No (this is stable)

TimeMachine v1.3.0 - Bug Fixes

What's Fixed in v1.3.0

🐛 Bug Fixes

• Fixed progress bar freezing after reopening app
• Removed unwanted notification when swiping away app
• Enhanced timer state persistence

🎨 Improvements

• Better UI state synchronization with service
• Proper progress calculation on app reopen
• Cleaner notification behavior

📦 Download

• File: app-release.apk (22 MB)
• SHA256: 4d9fd1a...5eb115
• Min Android: 12 (API 31)
• Target Android: 16 (API 36)

TimeMachine v1.2.0 - Production Ready

What's New in v1.2.0

🔧 Critical Fixes

• Fixed: Alarm dismiss button now stops alarm immediately
• Fixed: Alarm now rings reliably after force-stop
• Fixed: Alarm survives app swipe-away

⚡ Improvements

• New: Dedicated alarm service for 100% reliability
• Enhanced: Timer state persistence via SharedPreferences
• Enhanced: Fallback AlarmManager for process death recovery
• Cleaned: Removed all temporary development files

📊 Technical

• Zero linting errors
• R8/ProGuard optimized
• 22 MB APK size

v1.1.0 - Preset System & UI Improvements

🎉 TimeMachine v1.1.0 - Major Update

Release Date: October 18, 2025

A major update with preset functionality, UI improvements, and app rebranding!

---

✨ What's New

🔖 Preset System

• Save Timer Presets - Save your favorite durations with custom names
• SQLite Database - All presets stored locally and persist forever
• Horizontal Scroll - Beautiful card-based horizontal scrolling for presets
• One-Tap Start - Tap any preset to instantly start the timer
• Quick Access - No need to manually set time anymore!
• Delete Presets - Remove unwanted presets with X button

🎨 UI/UX Improvements

• Fixed Picker Alignment - Highlight box now perfectly aligns with selected number
• Haptic Feedback - Feel subtle vibrations when scrolling time picker
• Better Button Text - Fixed text cutoff issues on Start/Stop buttons
• Improved Touch Targets - Larger, easier to tap buttons
• Cleaner Header - Simplified top bar design

📱 App Rebranding

• New Name: TimeMachine ⏰ (formerly Pomodoro Timer)
• Modern Identity - Better reflects versatile timer functionality
• Updated Icon - Fresh new app icon

---

🆕 New Features in Detail

Preset Management

Save commonly used timers for instant access:

• "Focus Session" - 25 minutes
• "Short Break" - 5 minutes
• "Long Break" - 15 minutes
• "Deep Work" - 90 minutes
• Any custom duration you need!

Workflow Example

1. Set 25 minutes → Tap save → Name it "Focus"
2. Next time: Just tap "Focus" chip → Timer starts immediately!
3. When done: Tap "Break" preset → 5 min countdown begins

Database Features

• Automatic persistence across app restarts
• Unlimited presets (store as many as you need)
• Fast retrieval with Room database
• Efficient SQLite storage

---

🐛 Bug Fixes

Fixed Selection Highlight Misalignment

• Issue: Highlight box showed one number above/below selected value
• Fix: Complete rewrite using derivedStateOf for accurate center calculation
• Result: Pixel-perfect alignment between highlight and selected number

Fixed Button Text Cutoff

• Issue: "Start" showing as "Star\nt", "Stop" as "Sto\np"
• Fix: Increased button size (90dp), proper content padding
• Result: Full text visible, properly centered

Added Missing Haptic Feedback

• Issue: No vibration when scrolling time picker
• Fix: Implemented vibration on each number change (10ms subtle pulse)
• Result: iOS-like smooth scrolling experience

---

🔧 Technical Improvements

New Dependencies

• Room 2.6.1 - SQLite database wrapper
• KSP 2.0.21 - Kotlin Symbol Processing for Room
• Material Icons Extended - Additional icon set

Architecture

• Repository pattern for data layer
• Flow-based reactive updates
• Proper database schema with migrations support
• Coroutines for async operations

Code Quality

• ProGuard rules updated for Room
• Database queries optimized
• Memory leak prevention with proper disposal
• Better state management

---

📥 Installation

New Users

1. Download TimeMachine-v1.1.0.apk below
2. Enable "Install from Unknown Sources"
3. Install and enjoy!

Upgrading from v1.0.0

Simply install the new APK over the old one - all your settings will be preserved!

---

📊 Technical Details

• App Name: TimeMachine (formerly Pomodoro Timer)
• Version: 1.1.0 (Version Code: 2)
• APK Size: ~22MB (increased due to Room database)
• Min Android: 12 (API 31)
• Target Android: 15 (API 36)
• Database: Room 2.6.1 with SQLite

---

🎯 Use Cases

Productivity

• Quick work sessions with saved presets
• Pomodoro technique made easy
• Focus time management

Health & Wellness

• Meditation timers
• Workout intervals
• Breathing exercises

Daily Life

• Cooking timers
• Study sessions
• Power naps
• Tea/coffee brewing

---

🔄 Migration from v1.0.0

Good News: Seamless upgrade!

• ✅ No data loss
• ✅ All settings preserved
• ✅ New preset feature automatically available
• ✅ Same package name (no uninstall needed)

What Changes:

• 📱 App name: "Pomodoro Timer" → "TimeMachine"
• 🆕 New preset chips appear at top
• 💾 Database created automatically

---

🌟 Highlights

Feature	v1.0.0	v1.1.0
Presets	❌ None	✅ Unlimited saved presets
One-tap start	❌ No	✅ Yes
Haptic feedback	❌ No	✅ Yes
Picker alignment	⚠️ Buggy	✅ Perfect
Database	❌ None	✅ SQLite with Room
App name	Pomodoro Timer	TimeMachine

---

📝 Known Issues

None! 🎉 This version has been thoroughly tested.

---

🔗 Links

• Repository: https://github.com/aliahadmd/TimeMachine
• Download APK: See attachments below
• Report Issues: https://github.com/aliahadmd/TimeMachine/issues
• Full Changelog: v1.0.0...v1.1.0

---

🙏 Thank You

Thank you for using TimeMachine! This update brings significant improvements based on user feedback.

If you enjoy the app:

• ⭐ Star the repository
• 🐛 Report any bugs you find
• 💡 Suggest new features
• 📢 Share with friends

---

🚀 What's Next?

Planned for future versions:

• Pause/Resume functionality
• Background notifications
• Timer history and statistics
• Custom alarm sounds
• Widget support
• Multiple simultaneous timers
• Cloud backup of presets

---

Built with ❤️ using Jetpack Compose

Enjoy TimeMachine v1.1.0! ⏰✨

v1.0.0 - Initial Release

🎉 Pomodoro Timer v1.0.0 - Initial Release

Release Date: October 18, 2025

Welcome to the first release of Pomodoro Timer! A beautiful, minimal timer app for Android.

---

✨ Features

⏰ Timer Functionality

• Custom Duration Setting - Set any duration from 1 minute to 23 hours 59 minutes
• Apple-Style Time Picker - Smooth, scrollable wheels for easy time selection
• Real-Time Countdown - Watch your timer count down with a beautiful circular progress indicator
• Visual Progress - Circular ring shows how much time remains
• Stop Anytime - Cancel timer whenever you need

🔔 Notifications

• Alarm Sound - System alarm plays when timer completes
• Vibration Feedback - Repeating vibration pattern for physical notification
• Dismiss Screen - Clear notification screen to stop alarm

🎨 User Interface

• Minimal Design - Clean, distraction-free interface focused on the timer
• Material 3 - Modern Android design language
• Smooth Animations - Polished transitions between all states
• Large Buttons - Easy to use, accessible touch targets
• Edge-to-Edge - Immersive full-screen experience

🌓 Theming

• Auto Dark Mode - Automatically switches based on system preference
• Auto Light Mode - Clean light theme for daytime use
• Dynamic Colors - Beautiful blue accent color
• High Contrast - Easy to read in any lighting

🔧 Technical

• No Ads - Completely ad-free experience
• No Internet Required - Works 100% offline
• Lightweight - Only 11MB APK size
• Battery Efficient - Optimized for minimal battery drain
• ProGuard Optimized - Minified for better performance
• No Permissions Abuse - Only uses necessary permissions

---

📱 Perfect For

• 🍅 Pomodoro Technique - 25-minute focus sessions
• 📚 Study Sessions - Timed learning blocks
• 🏋️ Workouts - Exercise intervals and rest periods
• 🧘 Meditation - Timed meditation sessions
• 👨‍🍳 Cooking - Track cooking times
• ☕ Coffee Brewing - Perfect pour-over timing
• 💤 Power Naps - Set quick nap timers
• 🎮 Screen Time Limits - Manage gaming or social media time

---

📥 Installation

1. Download PomodoroTimer-v1.0.0.apk attached below
2. On your Android device, go to Settings → Security
3. Enable Install from Unknown Sources for your file manager/browser
4. Open the downloaded APK file
5. Tap Install
6. Tap Open to launch the app

---

📋 Requirements

• Minimum Android Version: Android 12 (API 31)
• Target Android Version: Android 15 (API 36)
• Supported Architectures: ARM, ARM64, x86, x86_64
• Storage Required: ~15MB

---

🚀 How to Use

First Time Setup

1. Launch the Pomodoro Timer app
2. You'll see the time picker with hours and minutes
3. Default is set to 25 minutes (standard Pomodoro)

Setting a Timer

1. Scroll the time wheels to select your desired duration
   • Left wheel: Hours (0-23)
   • Right wheel: Minutes (0-59)
2. Tap the Start button (big blue circle)
3. Watch the countdown begin!

During Timer

• View Progress: Circular ring shows remaining time
• Stop Early: Tap the red Stop button to cancel

When Timer Completes

• Alarm Sounds: System alarm plays (loops until dismissed)
• Phone Vibrates: Repeating vibration pattern
• Dismiss: Tap the Dismiss button to stop

Tips

• Set 25 minutes for a classic Pomodoro work session
• Set 5 minutes for short breaks
• Set 15-30 minutes for longer breaks
• Works great with screen off - alarm will still ring!

---

🛠️ Built With

• Kotlin 2.0.21
• Jetpack Compose - Modern Android UI
• Material 3 - Latest Material Design
• Kotlin Coroutines - Async operations
• Gradle 8.13.0

---

📊 Technical Details

• Package Name: me.aliahad.timemanager
• Version Code: 1
• Version Name: 1.0.0
• APK Size: 11MB
• Minimum SDK: 31 (Android 12)
• Target SDK: 36 (Android 15)
• Signing: Release keystore

---

🐛 Known Issues

None at launch! 🎉

If you find any bugs, please report them in the Issues section.

---

📝 Permissions Explained

The app requests these permissions:

1. VIBRATE 📳

   • Used to vibrate when timer completes
   • Essential for notification feedback

2. POST_NOTIFICATIONS 🔔

   • Required for Android 13+ devices
   • Shows alarm notification

3. WAKE_LOCK ⏰

   • Keeps timer running accurately
   • Ensures alarm goes off on time

4. FOREGROUND_SERVICE 🔧

   • Allows reliable background timer
   • Timer works even when screen is off

Privacy: No data is collected, no internet connection needed, no tracking whatsoever.

---

💬 Feedback

We'd love to hear from you!

• 🐛 Report Bugs: Open an issue
• 💡 Request Features: Submit an idea
• ⭐ Star the Repo: Show your support on GitHub
• 📢 Share: Tell your friends about Pomodoro Timer

---

🎯 What's Next?

Future updates may include:

• Timer presets (quick 5, 10, 15, 25 min buttons)
• Multiple timers
• Usage statistics
• Custom alarm sounds
• Widgets
• Pause/resume
• Background notifications

---

🙏 Thank You

Thank you for trying Pomodoro Timer v1.0.0! This is just the beginning.

If you find this app useful, please:

• ⭐ Star the repository
• 📢 Share with friends who could benefit
• 💬 Leave feedback to help improve the app

---

🔗 Links

• GitHub Repository: https://github.com/aliahadmd/TimeManager
• Download APK: [See attachments below]
• Documentation: README.md
• Report Issues: Issue Tracker
• Developer: Ali Ahad (aliahad.me)

---

Built with ❤️ using Jetpack Compose

Enjoy your productivity sessions! 🍅⏱️