Mind Mint

Reclaim Your Focus. Master Your Time.

Features | Screenshots | Tech Stack | Installation | Contributing

---

📱 About Mind Mint

Mind Mint is a comprehensive productivity ecosystem designed to help you break free from the doomscrolling cycle. It combines a robust app blocker, an immersive focus timer, a habit tracker, and a task manager, all tied together with gamification and deep analytics to make staying focused genuinely rewarding.

Tip

"Productivity is not about doing more. It's about doing what matters."

---

🚀 Core Ecosystem Features

🧘 Immersive Focus Mode Transform work sessions into a rewarding gamified journey. Crystal Evolution: Watch focus crystals grow from Ruby to Amethyst. Nebula Ambience: Calming starfield animations trigger flow states. Linked Tasks: Link focus sessions to explicit priorities. Configurable Pomodoro: Smooth intervals with automatic transitions.	🔒 Lock-In Mode Hardened committing mechanisms for maximum discipline. Accessibility Shield: Intercepts and redirects distracting launchers. Universal Web Blocker: Stop doomscrolling inside mobile browsers. Adult Content Filter: Keyword-aware hosts-level blocking. Uninstall Protection: Device Admin guard blocks unauthorized app deletion.
📅 Habit & Task Center Build routines and keep your to-dos highly visual. Activity Heatmaps: GitHub-style calendars track consistency. Streak Systems: Visual badges and cues keep momentum high. Quick Capture: Add tasks instantly right from the home dashboard. Widgets Support: Control tasks and habits from the launcher.	📊 Deep Analytics & Rewards Actionable data paired with tangible motivation. Focus Charts: Visualise sessions by category, time, and length. Mint Crystals: Earn custom in-app currency for every focused minute. Themes Shop: Unlock custom visual styling and crystal shapes. Weekly Summaries: Discover biggest distractions and peak hours.

---

🔒 Security & Commitment Center

Important

Protect your focus configurations with multi-tiered security options, custom blocker intensities, and sensory-based bypass challenges.

🔑 Settings Lock Profiles

Lock Type	Description
Fingerprint / Biometric	Uses system Face Unlock or Fingerprint scanner to verify identity.
Custom 6-Digit PIN	A custom PIN secured via SHA-256 with progressive lockout brute-force cooldowns.
1-Day Lockout	Locks all settings, app updates, and configuration parameters for a full 24 hours.

⚡ Blocker Intensity Levels

Level	Name	Behavior
Level 0	NONE	The blocker and scroll trackers are inactive.
Level 1	FRICTION	Complete a mindfulness challenge to get a temporary bypass.
Level 2	REMINDER	Non-blocking warnings pop up periodically during app usage.
Level 3	TEMP LOCK	Hard lock blocks the app once scroll limits or daily time limits are reached.
Level 4	PERMANENT	Absolute lock. Settings adjustments and bypass challenges are locked out.

📳 Bypass Challenges (Frictions)

To unlock a temporary bypass window, choose one of the following sensory challenges:

• 🧮 Math: Solve randomly generated equations to reset focus.
• 📳 Shake: Vigorously shake the phone to stimulate physical activity.
• 🗣️ Scream: Vocalize out loud to trigger auditory feedback and release dopamine.
• 💨 Breath: Take a guided 10-second deep breathing pause to restore mindfulness.

---

📵 Supported Apps to Block

Mind Mint supports precise blocking and scroll tracking for the following 8 major platforms:

YouTube Shorts	Instagram Reels	Facebook Reels	Snapchat Spotlights
TikTok	Reddit Watch	LinkedIn	X (Twitter) Reels

...with support for more apps coming soon! 🚀

---

📸 Screenshots

---

🛠 Tech Stack

Category	Technologies
Languages
Architecture	MVVM (Model-View-ViewModel)
Database	Room (SQLite ORM)
Networking	OkHttp, Glide (Image Loading)
UI Components	Material Design 3, MPAndroidChart, Lottie
System APIs	AccessibilityService, DevicePolicyManager, WorkManager
Backend / Services	Firebase (Crashlytics, FCM)
Tools	Gradle, Android Studio

📦 Full dependency list

• androidx.core:core-ktx
• androidx.appcompat:appcompat
• com.google.android.material:material
• com.github.PhilJay:MPAndroidChart
• com.airbnb.android:lottie
• com.github.skydoves:balloon
• com.github.bumptech.glide:glide
• androidx.room:room-runtime
• me.tankery.lib:circularSeekBar
• And more, see build.gradle

📈 Repository Stats & Star History

Commit Activity	Repo Size

Top Language	Code Size

Star History

---

📚 Documentation Index

• ⚡ Quick Start - Get the app running in 5 minutes.
• 🔧 Build & Run - Detailed setup instructions.
• 🏛️ Architecture - High-level overview of the code structure.
• 🔑 Key Components - Deep dive into critical files and services.
• 📂 Documentation Index - Full list of available docs.

---

📥 Installation

Mind Mint is currently in active development. Build it from source:

1. Clone the repository

   git clone https://github.com/gtxprime/mind-mint.git

2. Open in Android Studio
3. Copy the example properties file and fill in your keys

   cp gradle.properties.example gradle.properties

4. Sync Gradle and hit Run

Note

A release APK will be available in the Releases section soon.

---

🤝 How to Contribute

Contributions are welcome, whether it's a bug fix, a new feature, or a documentation improvement.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Current focus areas: UI animations (Lottie), widget improvements, and the upcoming Lock Types system.

---

⚖️ License

Distributed under a Modified MIT License. Visible credit to Mind Mint is required.

See LICENSE for full details.

---

Built with ❤️ by the Mind Mint Team
GitHub • Contact