Zenith - A Material Design 3 Expressive Digital Wellbeing App

        

Zenith is a smart digital wellbeing assistant for Android, built with Material Design 3 Expressive. It uses proactive interventions and real-time monitoring to help you break addictive scrolling habits through a fluid, motion-rich experience.

Key Features

• Bedtime Mode (New): Automate your digital detox with customizable schedules, Wind Down notifications, and automatic Do Not Disturb.
• Interactive Widgets (New): Keep track of your app streaks and daily focus progress with Material 3 Expressive home screen widgets.
• Mindful Gateway: Proactively interrupt all non-whitelisted apps with a mindful pause to prevent mindless scrolling.
• Backup & Restore: Securely save your settings and schedules with automated periodic backups or manual exports.
• Shield Mode: Protect specific apps with mindful pauses and usage frequency limits.
• Goal Pursuit: Set and achieve target usage times for productive applications.
• Session HUD: A floating, customizable overlay (size & opacity) that shows remaining time for active sessions.
• Early Kick: Optional reminders or early ejection to help you transition out of apps before your limit expires.
• Expressive Design: Fully compliant with Material Design 3 Expressive guidelines, featuring fluid motion, adaptive typography (GSFlex), and floating navigation components.

Installation Guide

1. Clone this repository.
2. Open it in Android Studio Ladybug (2024.2.1) or a newer version.
3. Ensure Android SDK 33+ is installed.
4. Build and run on a physical device (recommended for proper permission handling).

Required Permissions

To help you stay focused and break mindless habits, Zenith needs a few permissions.

Required

Without these, Zenith won't be able to track your usage or help you stay mindful.

1. Usage Stats (PACKAGE_USAGE_STATS): This lets Zenith see how much time you spend in your apps so it can help you stick to your limits.
2. System Overlay (SYSTEM_ALERT_WINDOW): This allows Zenith to show a "Shield" or a timer over other apps when you've reached your limit or need a mindful pause.
3. App List (QUERY_ALL_PACKAGES): Zenith needs this to show you a list of your apps so you can choose which ones you want to track or block.
4. Notifications (POST_NOTIFICATIONS): Used to send you goal reminders and keep you updated on your focus progress throughout the day.
5. Do Not Disturb (ACCESS_NOTIFICATION_POLICY): This allows Bedtime Mode to automatically silence your phone so you can get a better night's sleep.

Optional

These are optional, but they make Zenith much more reliable and powerful.

6. Accessibility Service (BIND_ACCESSIBILITY_SERVICE): An optional service that helps Zenith catch when you open a restricted app instantly, making your "Shields" feel much more responsive.
7. Notification Intercept (BIND_NOTIFICATION_LISTENER_SERVICE): This lets Zenith hide distracting notifications during your scheduled Focus sessions or Bedtime.
8. Battery Optimization: This tells Android not to close Zenith in the background, ensuring your focus time is always tracked accurately.
9. Precise Timing (SCHEDULE_EXACT_ALARM): Makes sure your daily resets, bedtime schedules, and reminders happen exactly when they're supposed to.
10. Storage Access (READ_EXTERNAL_STORAGE): Only used if you want to use the Backup & Restore feature to save or load your settings.
11. Internet Access (INTERNET): Used to check for app updates (depending on where you downloaded the app) and to let you visit our GitHub or community pages from the settings.

Special Thanks

• Tomato - Interface and promotional material inspiration.

License

This project is created for learning and self-development purposes. GNU GPL v3.0