Skip to content

README.md

Latest commit

 

History

History
369 lines (308 loc) · 14.1 KB

README.md

File metadata and controls

369 lines (308 loc) · 14.1 KB
Raw
Mind Mint Logo

Mind Mint

Reclaim Your Focus. Master Your Time.

Get it on Google Play Get it on GitHub

📱 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
YouTube Shorts 		Instagram
Instagram Reels 		Facebook
Facebook Reels 		Snapchat
Snapchat Spotlights
TikTok
TikTok 		Reddit
Reddit Watch 		LinkedIn
LinkedIn 		X
X (Twitter) Reels

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

📸 Screenshots

🛠 Tech Stack

Category Technologies
Languages Java Kotlin XML
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
Commits Size
Top Language Code Size
Language Code Size

Star History

Star History Chart
📚 Documentation Index

📥 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