🍅 Perseverance PVC - Advanced Pomodoro Timer App

A feature-rich, minimalist Pomodoro timer app with intelligent auto-save, beautiful onboarding, and comprehensive customization options.

Built with modern Android development practices using Jetpack Compose, this app provides a distraction-free focus environment with advanced productivity features.

✨ Core Features

🎯 Pomodoro Timer System

25-minute work sessions with 5-minute short breaks and 15-minute long breaks
Smart session tracking with visual indicators (4 circles) for completed sessions
Intuitive play/pause controls with smooth animations
Session completion rewards and progress visualization
Customizable timer durations (5, 10, 50, 60 minutes or custom)
Subject-based study tracking with custom subject creation

🎨 Interactive Visual Experience

Dynamic illustrations - Changes based on timer state (study/home images)
Smooth animations with visual feedback during timer states
Material 3 Design system implementation
Responsive UI that adapts to different screen sizes

💾 Intelligent Auto-Save System

Periodic auto-save every 5 seconds while timer is running
Crash recovery - Never lose your study time, even if app crashes
Force-close protection - Study time preserved when app is force-closed
Battery death recovery - Maximum 5 seconds of data loss
Background persistence - Timer state saved across app restarts

🚀 Advanced Features

🎓 Modern Onboarding Experience

5-page interactive tutorial for first-time users
Beautiful gradient design with animated page indicators
Feature highlights with color-coded icons
Skip option for experienced users
One-time experience - Never shows again after completion

⚙️ Comprehensive Settings System

Dark Mode Selection (Light/Dark/System) with persistent storage
Timer Background Control - Continue timer when switching apps
Session Reset Scheduling - Automatic daily resets
UI Customization - Hide navigation/status bars during focus
System Integration - Follow system font settings
Time Management - Customizable day start time (48 time options)
Multi-language Support - 9 languages (English, Spanish, French, German, Chinese, Japanese, Korean, Hindi, Arabic)
Focus Mode - Do Not Disturb integration during sessions
Permission Management - Direct access to system settings

📊 Progress Tracking & Analytics

Study time statistics with detailed insights
Session history and progress visualization
Dashboard analytics for productivity insights
Subject-based tracking with breakdown charts
Weekly and daily summaries
Developer mode for testing and manual time entry

👥 Study Groups (Coming Soon)

Collaborative focus sessions - Join or create study groups
Group statistics and shared progress tracking
Social learning features for enhanced motivation

🛠️ Technical Excellence

Modern Architecture

MVVM Pattern with ViewModel and StateFlow
Repository Pattern for clean data management
Jetpack Compose for modern UI development
Material 3 Design system implementation

Performance & Reliability

DataStore Preferences for efficient data persistence
Coroutine-based async operations
Lifecycle-aware components
Memory-efficient operations

Dependencies & Libraries

androidx.lifecycle:lifecycle-viewmodel-compose:2.7.0 - ViewModel integration
androidx.datastore:datastore-preferences:1.0.0 - Data persistence
com.google.code.gson:gson:2.10.1 - JSON serialization
com.google.accompanist:accompanist-pager:0.32.0 - Swipe navigation
androidx.compose.material:material-icons-extended - Extended icon set

👨‍💻 Developer Information

Mkshaon — Lead Developer

🌐 Connect with me:

🐙 GitHub: @mkshaonexe
🎥 YouTube: @mkshaon7
📘 Facebook: @mkshaon777
📸 Instagram: @mkshan7
📧 Email: mkshaon2024@gmail.com

🎯 SEO & App Store Optimization

Keywords & Tags

Pomodoro Timer, Focus App, Productivity, Study Timer, Time Management
Jetpack Compose, Android Development, Material Design
Auto-save, Crash Recovery, Background Timer, Study Analytics
Minimalist Design, Distraction-free, Focus Environment

Target Audience

Students and professionals seeking improved focus
Productivity enthusiasts using Pomodoro technique
Android users wanting modern, feature-rich timer apps
Users who need reliable study time tracking

Unique Selling Points

Never lose study time with intelligent auto-save
Beautiful onboarding for seamless first-time experience
Comprehensive customization for personal preferences
Modern Android development with latest technologies
Crash-proof design with maximum 5-second data loss

📱 User Experience

Getting Started

First Launch: Beautiful onboarding experience guides you through all features
Start Timer: Tap the play button (▶) to begin your focus session
Auto-Save: Your study time is automatically saved every 5 seconds
Complete Sessions: Visual indicators show your progress (4 circles)
Take Breaks: Automatic 5-minute short breaks and 15-minute long breaks

Settings & Customization

Access comprehensive settings via the settings icon (⚙️) in the top header:

🎨 Appearance & Theme

Dark Mode: Light/Dark/System theme selection
Navigation Control: Hide/show bottom navigation bar
Status Bar: Auto-hide during focus sessions
System Integration: Follow device font settings

⏱️ Timer Behavior

Background Timer: Continue when switching apps
Daily Reset: Automatic session counter reset
Day Start Time: Customize when your day begins (48 time options)
Focus Mode: Do Not Disturb integration

🌍 Localization

Multi-language: 9 supported languages
Time Zones: Customizable day start times
System Integration: Follow device settings

🏗️ Project Architecture

File Structure

├── app/
│   ├── src/main/java/com/perseverance/pvc/
│   │   ├── MainActivity.kt                    # Main app entry point
│   │   ├── data/                             # Data layer
│   │   │   ├── StudyRepository.kt            # Study data management
│   │   │   └── SettingsRepository.kt        # Settings persistence
│   │   └── ui/                              # UI layer
│   │       ├── screens/                     # Screen composables
│   │       │   ├── PomodoroScreen.kt        # Main timer screen
│   │       │   ├── SettingsScreen.kt        # Settings interface
│   │       │   ├── OnboardingScreen.kt      # First-time user guide
│   │       │   ├── Page1Screen.kt          # Insights dashboard
│   │       │   ├── Page2Screen.kt          # Analytics dashboard
│   │       │   ├── GroupScreen.kt           # Study groups
│   │       │   ├── MenuScreen.kt            # Main menu
│   │       │   └── DeveloperModeScreen.kt    # Developer tools
│   │       ├── components/                    # Reusable UI components
│   │       │   ├── TopHeader.kt             # App header
│   │       │   ├── BottomNavigationBar.kt   # Navigation component
│   │       │   ├── RadarChart.kt            # Analytics charts
│   │       │   └── WeeklyStudyChart.kt      # Study time charts
│   │       ├── viewmodel/                    # Business logic layer
│   │       │   ├── PomodoroViewModel.kt     # Timer logic
│   │       │   ├── SettingsViewModel.kt     # Settings management
│   │       │   ├── StudyViewModel.kt        # Study data logic
│   │       │   └── InsightsViewModel.kt     # Analytics logic
│   │       └── theme/                       # Design system
│   │           ├── Color.kt                 # Color palette
│   │           ├── Theme.kt                 # Theme definitions
│   │           └── Type.kt                 # Typography
│   └── src/main/assets/
│       └── focus_1_400.mp4                  # Focus video background (planned)

Architecture Patterns

MVVM (Model-View-ViewModel): Clean separation of concerns
Repository Pattern: Centralized data access
StateFlow: Reactive state management
Compose Navigation: Modern navigation system

🚀 Getting Started

Prerequisites

Android Studio Arctic Fox or later
Android SDK 24+ (Android 7.0+)
Kotlin 1.8.0+
Gradle 7.0+

Installation

Clone the repository

git clone https://github.com/mkshaonexe/Perseverance_pvc.git
cd Perseverance_pvc

Open in Android Studio
- Open Android Studio
- Select "Open an existing project"
- Navigate to the project folder
Sync and Build
```
./gradlew assembleDebug
```
Install on Device
- Connect Android device or start emulator
- Run the app from Android Studio

Development Setup

# Install dependencies
./gradlew build

# Run tests
./gradlew test

# Generate APK
./gradlew assembleRelease

🧪 Testing & Quality Assurance

Auto-Save Testing

✅ Force-close protection - Study time preserved
✅ Crash recovery - Maximum 5-second data loss
✅ Background persistence - Timer state maintained
✅ Battery death recovery - Data integrity maintained

Feature Testing

✅ Onboarding flow - First-time user experience
✅ Settings persistence - All preferences saved
✅ Timer functionality - Play/pause/resume cycles
✅ Subject tracking - Custom subject creation and management
✅ Analytics dashboard - Study time visualization

Performance Testing

✅ Memory efficiency - Optimized operations
✅ Battery optimization - Efficient background operations
✅ Smooth animations - 60fps UI interactions
✅ Fast startup - Quick app launch times

📈 Future Roadmap

Planned Features

🎬 Video Background - Focus video playback during sessions
🎨 Theme Customization - Advanced color schemes
📊 Advanced Analytics - Detailed productivity insights
👥 Study Groups - Collaborative focus sessions
🔔 Smart Notifications - Intelligent reminder system
🌐 Cloud Sync - Cross-device data synchronization
🎵 Focus Sounds - Ambient audio options

Technical Improvements

🔧 Performance Optimization - Enhanced battery life
🛡️ Security Enhancements - Data encryption
🌍 Internationalization - Full multi-language support
♿ Accessibility - Enhanced screen reader support

📄 License

This project is developed by Mkshaon and is available for educational and personal use.

🤝 Contributing

We welcome contributions! Please feel free to:

🐛 Report bugs and issues
💡 Suggest new features
🔧 Submit pull requests
📖 Improve documentation

Contact: mkshaon2024@gmail.com

📞 Support & Contact

Need help or have questions?

📧 Email: mkshaon2024@gmail.com
🐙 GitHub Issues: Create an issue
📘 Facebook: @mkshaon777
📸 Instagram: @mkshan7

Built with ❤️ by Mkshaon using modern Android development practices.

Name		Name	Last commit message	Last commit date
Latest commit History 318 Commits
.idea		.idea
.kotlin/errors		.kotlin/errors
app		app
gradle		gradle
info		info
web		web
.env		.env
.env.example		.env.example
.gitignore		.gitignore
GITHUB_STATUS_EXPLANATION.md		GITHUB_STATUS_EXPLANATION.md
GIT_SETUP_GUIDE.md		GIT_SETUP_GUIDE.md
README.md		README.md
app_overview.md		app_overview.md
backup_system.md		backup_system.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
index.html		index.html
make.md		make.md
master_database.sql		master_database.sql
mastersqlalinhere.txt		mastersqlalinhere.txt
settings.gradle.kts		settings.gradle.kts

mkshaonexe/PVC-Perseverance

Folders and files

Latest commit

History

Repository files navigation