🌌 DeepFocus

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.

---

✨ Features

• ⚡ 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.

---

🛠️ Technology Stack

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).

---

🏛️ Directory Architecture

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

---

🚀 Setup & Installation

Prerequisites

• 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)

Building the Project

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.

---

📄 License

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