Void UI 🌌

Void UI is a premium, minimal, terminal-style home launcher for Android built with Flutter. Inspired by terminal CLI layouts and the popular Night Owl theme, Void UI replaces the standard Android home screen with a clean, text-based dashboard that keeps you productive and distraction-free.

---

📱 UI Showcase

🌑 Dark Mode	☀️ Light Mode
⚡ Select Quick Apps	📂 Open Apps

---

🎨 Premium Design & Theme

• Dual Themes: Dynamic dark/light mode toggle via a slider in the top right ($ init theme).
  • AMOLED Night Mode: Pitch-black background with neon green/gold terminal outputs to save battery.
  • Day Theme: A soft, high-contrast light cream background with deep charcoal text.
• Transparent Status & Nav Bars: Full-screen edge-to-edge layout that draws seamlessly under and around your device's camera cutout, with adaptive status bar icons (dark in light theme, light in dark theme).

---

🚀 Key Features

1. Dynamic Widgets (CLI Themed)

• $ date: Shows system date and real-time continuous ticking time (sub-second synced). Tapping this widget opens your phone's default Clock app.
• $ battery: Displays precise battery level, charging status, temperature, and health indicators. Tapping opens battery settings.
• $ screen: Computes and displays your screen time (today and weekly averages) alongside a limit bar indicator. Tapping this widget opens your system's Digital Wellbeing app.
• $ ls ~/apps: A list of your custom home screen shortcut apps. Tapping [edit] allows you to configure which apps are visible.

2. Full-Screen Swipe Gestures

You can swipe anywhere on the screen (including on top of widgets and lists) to trigger actions:

• Swipe Left 👈: Opens the app drawer bottom sheet ($ find /system/apps -type f) with instant search/grep filtering.
• Swipe Right 👉: Instantly launches the device Camera app (with robust intent package fallbacks).

3. High-Accuracy Screen Time Tracker

Unlike rolling calculations, Void UI implements custom UsageEvents log parsing at the OS layer via Android MethodChannel. It calculates the exact elapsed time between application foreground (ACTIVITY_RESUMED) and background (ACTIVITY_PAUSED) transitions since midnight to match system wellbeing settings.

4. Interactive Default Launcher Setup Dialogs

On first launch, Void UI shows a clean terminal-styled prompt offering two modes:

• Inspect App: Dismisses the prompt so you can explore the launcher workspace.
• Set as Default: Displays a step-by-step guidance dialog ($ steps --set_default) and redirects you directly to the Android Default Home App Settings selection menu when you tap Proceed.

---

🛠️ Technical Stack

• Framework: Flutter (Dart 3.x)
• Native Android Host: Kotlin (minSdk 24, compileSdk 34)
• Dependencies: google_fonts, shared_preferences, intl
• Architecture: Clean declarative UI with Flutter Widgets + Android Platform MethodChannel for OS-level capabilities (UsageStats, Device Policy Manager, Package Manager, Intents).
• Kotlin Project Backup: The original native Kotlin implementation is safely preserved in voidui_kotlin/.

---

📱 How to Run / Build

1. Ensure the Flutter SDK is on your PATH (installed at C:\src\flutter\bin).
2. Run the app on a connected device or emulator:

   flutter run

3. To build a release APK:

   flutter build apk --release