Android Kotlin Jetpack Compose License: MIT

DeepFocus is a high-fidelity, premium Pomodoro and Stopwatch focus timer app designed specifically for Android. With a gorgeous, modern glassmorphic interface and deep ambient audio integration, DeepFocus elevates your productivity session by keeping you focused, calm, and distraction-free.

• ⚡ Dual Session Modes: Seamlessly switch between a classic Pomodoro Timer and a precise Stopwatch depending on your workflow.
• ⏱️ Adjustable Intervals: Instantly select custom durations (15m, 25m, 45m, 60m) with high-fidelity sweeping circular indicators.
• 🏷️ Dynamic Session Tagging: Categorize your focus sessions with built-in tags (Work, Study, Exercise, Other) or easily add your own.
• 🎵 Immersive Soundscapes: Enhance focus with integrated ambient soundscapes (white noise, rain, and customized focus audio) that run smoothly in the background.
• 📊 Real-time Analytics & Stats: Gain direct insights into your productivity habits with a rich statistics dashboard displaying session history and tag breakdowns.
• 🌙 Breath-taking Glassmorphic UI: Experience a sleek, dark-themed, glassmorphic layout adorned with glowing breathing animations and smooth gradient sweeps.

DeepFocus is built using modern Android development practices:

• UI Framework: Jetpack Compose & Material 3 for fluid, declarative animations and components.
• State & ViewModel: Kotlin Coroutines & Flow coupled with ViewModel to ensure robust, reactive architectural state.
• Background Operations & Playback:
  • Media3 ExoPlayer: High-performance audio streaming/looping for ambient soundtracks.
  • Foreground Service: Ensures focus state and audio playback persist when the screen is off or in the background.
  • WorkManager: Background task handling and deferred session reporting.
• Local Persistence: Room Database for tracking user session logs, tags, and sound selector history.
• Target SDK: Built and optimized for Android API 36 (Android 15 / 16 Preview).

deepfocus/
├── app/
│ ├── src/main/
│ │ ├── java/com/sans/deepfocus/
│ │ │ ├── analytics/ # Simple screen & custom session analytics
│ │ │ ├── data/ # Room DB local entities, DAOs, & AppDatabase
│ │ │ ├── domain/ # Core TimerManager & FocusAudioManager business logic
│ │ │ ├── service/ # Foreground FocusService for background operations
│ │ │ ├── ui/ # Composable Screens (TimerScreen, StatsScreen) & Theme
│ │ │ └── MainActivity.kt # Root Single-Activity Entrypoint
│ │ └── AndroidManifest.xml # App configuration, services, and permissions
│ └── build.gradle.kts # App-level dependencies and SDK configuration
└── build.gradle.kts # Top-level Gradle configuration

• Android Studio Koala / Ladybug (or newer)
• JDK 17 or higher
• An Android device or Emulator running Android API 36 or newer (compatible down to minSdk 36)

1. Clone the repository:

   git clone https://github.com/nichsedge/deepfocus.git
   cd deepfocus

2. Open in Android Studio:

   • Select File > Open and choose the root deepfocus folder.
   • Let Gradle sync completely.

3. Run on Device:

   • Connect your Android device or start an emulator.
   • Press Run (Shift + F10 / Play button) in Android Studio.

This project is licensed under the MIT License - see the LICENSE file for details.