Iteration Launcher

iOS-inspired interactions, Android-native elegance, Material 3 (API 37) refined.

---

Iteration is a high-performance, minimalist Android launcher built from the ground up using Jetpack Compose. It bridges the gap between fluid, intuitive UI patterns and the robust flexibility of the Android ecosystem. Minimum Android 6 (API 23) supported. Optimized for the latest Android 12 (API 31) through Android 17 (API 37).

---

✨ Key Features

🎨 Design & Interaction

• Immersive Edge-to-Edge: Full transparency support that treats your wallpaper as the primary canvas.
• Bouncy Paging (Fluid Navigation): Custom spring physics engine (DampingRatioLowBouncy) applied to horizontal paging for an organic, responsive feel.
• Edit Mode (Jiggle Mode): iOS-style desktop organization with iconic jiggle animations.
  • Unified Quick Removal: One-tap removal badges that intelligently distinguish between home screen removal and system uninstallation based on context.
• Liquid Glass Engine (Enhanced): High-performance real-time glassmorphism using the Backdrop library.
  • Applied Everywhere: Dock, Home Folders, App Library Categories, Search Bars, and Widgets.
  • Customizable Effects: Adjustable blur radius (0-50), physical refraction height, refraction amount, and chromatic aberration.
• Desktop Customization:
  • Page Visibility Control: Fully toggleable Minus One (Widget) Page and App Library via settings. Users can choose to hide these specialized pages for a cleaner desktop.
  • Flexible Layouts: Choose between 4x5, 4x6, or "Auto (Adaptive)" based on screen aspect ratio.
  • Dock Styles: Switch between Modern (Floating) round dock, Classic (Full Width) iOS-style dock, and the nostalgic Platform (3D Glass) style.
  • 3D Platform Dock (iOS 6 Inspired): A high-fidelity reconstruction of the classic 3D glass platform.
    • Trapezoidal Perspective: Custom geometric shape providing a deep sense of desktop depth.
    • Dynamic Icon Reflections: Real-time rendering of app icon reflections that perfectly match the user's selected icon shape (Round, Squircle, etc.).
    • Glass Highlight: Subtle top-edge highlighting to simulate the thickness of a physical glass pane.
  • Gesture-Responsive Dock: The Dock and Search Pill feature linear follow-through animations. They dynamically slide and fade based on the precise scroll progress.

🔍 Global Search & Intelligence (Powerhouse)

• Universal Discovery: Search for installed Apps and Local Contacts in a single unified interface.
  • Direct Interaction: Tap a contact to view details or use the quick-dial icon to call instantly.
• Advanced Scientific Calculator: A built-in, lightning-fast recursive descent parser.
  • Rich Operations: Supports +, -, *, /, ^ (Power), % (Modulo/Percentage).
  • Scientific Functions: sqrt, abs, sin, cos, tan, cot, sec, csc, log, ln.
  • Constants & Symbols: Full support for pi, e, and the π symbol.
  • Implicit Multiplication: Intuitively handles 2π, 2(3+4), and sin(30)cos(30).
  • Degree-Based Trig: Optimized for daily practical use (e.g., sin(30) = 0.5).
• Offline-Ready Unit Converter: Instant conversion for Length, Weight, and Temperature—works with or without internet.
• Smart Equation Solver: Detects equations (e.g., x^2 - 4 = 0) and provides a direct link to WolframAlpha for detailed steps and graphs.
• Smart Clipboard Integration: Automatically detects recent clipboard content when the search bar is empty for one-tap filling.
• Real-time Language Translator:
  • Natural Command Support: Use [text] to [lang] (e.g., Hello to ja) for precise translations.
  • Smart System Default: Type tr [text] to instantly translate into your device's current system language.
  • Lightning Fast: Powered by high-performance asynchronous requests with intelligent debouncing.
• Customizable Search Engines: Switch between Google, Bing, DuckDuckGo, Baidu, WolframAlpha, Perplexity, and more.
• System Commands: Trigger actions directly from the search bar. Use wifi, bt, alarm [time], timer [sec], battery, or settings for instant system control.
• Deep Content Integration: Beyond apps, it now searches your Calendar Events (displaying upcoming schedules) and Local Files/Folders across your device.
• Clean List Management: Intelligent "View All" mechanism for file search results to maintain a minimalist aesthetic while allowing deep browsing.

🌤️ Weather & Widgets (Advanced Customization)

• Widget Workshop (Internal KWGT): A powerful, built-in visual editor for creating custom widgets.
  • Layer-Based Design: Add text, icons, and shapes with full control over positioning and dynamic content.
• Premium Built-in Widgets:
  • Info Hub & Info Hub 2: Real-time system monitoring including RAM, CPU usage, Network speed, and Storage status.
  • RSS Feed Reader: Integrated news aggregator for your favorite sources.
  • Productivity Tools: Native Notes, ToDo lists, and Calendar event viewers.
  • Utility: Battery monitor, Music player control, Analog/Digital Clocks, and Photo stacks.
• Privacy-Friendly Weather:
  • IP-Based Discovery: Automatically determines your location via IP address—No GPS permissions required.
  • Manual Search: Integrated Geocoding API allows you to search and set any city worldwide.
• Dual Data Sources: Choose between MET Norway and Open-Meteo.
• Intelligent Caching: Automatically saves the last known weather data for offline viewing.

📚 Knowledge & Support

• In-App User Manual: A dedicated documentation hub built directly into the settings.
  • Discoverable Power: Step-by-step guides for Global Search, hidden gestures, and advanced tools.
  • Modular Design: Expanding library of "manual books" to help you master every corner of the launcher.

🌍 Globalization & Localization (V4.8 Major Update)

• Complete Resource Migration: 100% of UI strings, Toasts, menus, and descriptions have been migrated from hardcoded code to strings.xml.
• Multi-Language Support:
  • English: Default global language.
  • Traditional Chinese (繁體中文): Fully translated and native-ready.
  • Simplified Chinese (简体中文): Optimized for mainland users.
  • Special Persona (進化版中文): A unique, personified interface language with a "loyal assistant/AI" personality.
• Dynamic Locale Switching: Real-time interface updates using AppCompatDelegate and LocaleListCompat without requiring a full device restart.

🎭 Industrial-Grade App & Profile Management

• Full Multi-User & Work Profile Support: Native compatibility with Work Profiles, Parallel Spaces (Xiaomi Dual Apps, Samsung Secure Folder), and multiple guest profiles.
• Special App Icon Clones (Multi-Entry): Advanced support for apps with multiple entry points (activity-alias). Handles independent icons and labels for sub-apps within a single package (e.g., vUtils, vCalc, vPulse).
• Zero-Loss App Updates: Smart persistent ID mechanism ensures app updates don't trigger "New App" desktop placement logic or lose custom label/visibility metadata.
• Auto-Sorted Folders: Desktop folders are automatically maintained in alphabetical order (A-Z) for consistent organization.
• Icon Customization (The Ultimate System):
  • Real-time Updates: Changes to styles, shapes, and colors are applied instantly to the home screen without manual restarts.
  • Built-in Icon Picker: Select high-quality designed icons for Phone, Messages, Browser, etc., directly within the app.
  • Iteration Presets: Instant application of Standard, Black, White, and Glass styles.
  • Ultimate Custom Style: High-precision control using a full HSV + Alpha color picker.
  • Smart Original Hybrid: Toggle between custom colors and original app icons/backgrounds independently.
  • IPS (Icon Pack Studio) Advanced Parsing: Custom XML & binary stream parser for full compatibility with modern dynamic icon packs.
• Automated Release Tracking: Integrated background update checker. Users can configure the frequency (0 to 36 hours) to receive Material 3 notifications when new versions are available on GitHub.

📂 Advanced Folder & Library

• Context-Aware Menus: Full shortcut and management support inside folders even in non-edit mode.
• Intelligent "Manage Apps": Folder management pre-checks contained apps for intuitive batch addition/removal with automatic duplicate prevention.
• Optimized App Library:
  • 2x2 Suggestions: Intelligent recommendation grid (max 4 icons) for a cleaner, unified look.
  • Fast Categorization: Zero-lag filtering and background-processed group management.
• Privacy & Security:
  • Hide Apps: Secure app hiding with a password gate.
  • Android 15 Private Space (Native): Full adaptation for Android 15's native Private Space. Automatically detects and hides sensitive apps based on the profile's accessible state.
• Built-in App Freezer (Hail Engine):
  • Deep Hibernation: Freeze/Unfreeze applications using Shizuku or Root (SU) directly from the context menu to eliminate background battery drain.

🌐 PWA Ecosystem (Integrated Web Apps)

• PWA Maker: Transform any URL into a high-performance, standalone desktop application with a single tap.
• PWA Manage: A dedicated management suite to customize your web apps. Edit labels, update URLs, choose custom background colors, or apply unique icons using the built-in cropper.

🖖 Gesture System & Permissions

• Intelligent Priority: Smart gesture handling that prioritizes widget scrolling over home screen gestures.
• Search Lock: Horizontal paging is automatically disabled when the App Library search is focused.
• Centralized Permission Center: A dedicated "Permissions" page for Contacts, Notifications, and Accessibility.
• Local Privacy Control: Fully configurable network access; your personal data processing remains on-device by default.
• Advanced Storage Permission: Seamless integration with Android 11's "Manage All Files" API to enable comprehensive file and folder discovery.

---

🛠️ Technical Showcase

🏗️ Modern Decoupled Architecture

• Component-Based UI: UI logic is strictly separated into atomic files (Dock.kt, AppGrid.kt, FolderOverlay.kt, etc.).
• State-Driven Overlays: All overlays are managed via robust StateFlow orchestration for smooth transitions and crash-free state handovers.
• Action Proxy Pattern: System-level interactions are encapsulated in LauncherActions.kt, separating user intent from execution logic.
• Milestone 3.0 Stability: Major bug fixes including folder creation logic, delete confirmation reliability, and Settings navigation state management.

🚀 High-Performance Rendering

• Linear Animation Engine: Real-time interpolation of UI elements based on Pager scroll fractions, replacing binary visibility states with fluid transitions.
• Collision-Free Gestures: Custom-built awaitPointerEventScope logic ensuring widgets and the Pager coexist perfectly.
• Enhanced V13 Icon Engine: High-fidelity caching system (LruCache + Disk) utilizing a packageName/activity@userId composite key. Features advanced "timestamp-stripping" to synchronize icons across the App Library and Desktop.
• Intelligent Self-Healing Cache: Automatically detects app updates and configuration changes to regenerate outdated cache files using latest rendering algorithms.
• Full Configuration Backup (100% Coverage): JSON-based serialization covering Desktop Layout, Liquid Glass parameters, Gesture mappings, Icon scaling, Dock corner radius, and even maintenance settings.
• Automated Process Management: One-tap "Clear Icon Cache" that automatically restarts the launcher and returns to the home screen for a seamless maintenance experience.

---

📦 Project Structure (Modular)

app/src/main/java/com/liferlighdow/iteration/
│
├── data/                 # Data & Configuration Layer
│   ├── AppModel.kt       # Unified Multi-User Model
│   ├── AppRepository.kt  # Multi-Entry Activity Resolver
│   ├── ConfigSerializer.kt # Version-Agnostic Coder
│   ├── ContactModel.kt
│   ├── CurrencyRepository.kt
│   ├── LauncherConfig.kt # Data Classes for Backup
│   ├── WeatherRepository.kt
│   └── WidgetModel.kt
│
├── ui/                   # UI Components & Screens
│   ├── settings/         # Modular Settings Pages
│   │   ├── SettingsAppScreens.kt      # Hide, Rename, Library Settings
│   │   ├── SettingsCommon.kt          # Shared UI Components (Item, Group)
│   │   ├── SettingsInteractionScreens.kt # Desktop & Gestures
│   │   ├── SettingsLiquidGlassScreen.kt # Real-time Glass Workshop
│   │   ├── SettingsMainScreen.kt      # Unified Search & Navigation
│   │   ├── SettingsOtherScreens.kt    # Permissions, Language, Search
│   │   └── SettingsStyleScreens.kt    # Icon Theme, Pack, & Styles
│   ├── widgets/          # Individual Widget Components
│   │   ├── BatteryWidget.kt
│   │   ├── CalendarWidget.kt
│   │   ├── ClockWidget.kt
│   │   ├── MusicWidget.kt
│   │   ├── NoteWidget.kt
│   │   ├── PhotoWidget.kt
│   │   ├── StackWidget.kt
│   │   └── WeatherWidget.kt
│   ├── dialogs/          # Specialized Dialogs
│   │   └── WidgetDialogs.kt  # Stack Picker, Photo Crop, Location Search, etc.
│   ├── AppGrid.kt        # Optimized Slot-Based Layout
│   ├── AppItem.kt
│   ├── AppLibraryPage.kt
│   ├── Dock.kt           # Linear Animation Container
│   ├── FolderOverlay.kt
│   ├── GlobalSearchOverlay.kt
│   ├── LauncherBottomBar.kt
│   ├── LauncherDialogs.kt
│   ├── LauncherScreen.kt # Core Pager Engine
│   ├── LiquidGlass.kt    # Real-time Refraction
│   ├── ManualScreens.kt  # Documentation System
│   └── MinusOnePage.kt
│
├── viewmodel/            # Architecture & State Management
│   ├── MainViewModel.kt          # Core State & Initialization
│   ├── MainViewModelApps.kt      # Icon & App Logic Extension
│   ├── MainViewModelConfig.kt    # Backup/Import Extension
│   ├── MainViewModelExternal.kt  # Weather/Currency/Contacts Extension
│   ├── MainViewModelLayout.kt    # Desktop & Folder Logic Extension
│   ├── MainViewModelSettings.kt  # User Preferences Setter Extension
│   ├── MainViewModelWallpaper.kt # Blur & Wallpaper Logic Extension
│   └── MainViewModelWidgets.kt   # Stacker & Widget Logic Extension
│
├── service/              # System Services & Receivers
│   ├── IterationAccessibilityService.kt
│   └── NotificationService.kt
│
├── utils/                # Utility Classes (Icons, Wallpaper, Actions)
│   ├── ActionMode.kt
│   ├── GestureAction.kt
│   ├── IconPackManager.kt # Advanced XML & IPS Parser
│   ├── IconProcessor.kt   # PorterDuff-Masked Renderer
│   ├── IconShape.kt
│   ├── IconStyle.kt
│   ├── LauncherActions.kt
│   └── WallpaperProcessor.kt
│
├── MainActivity.kt      
└── SettingsActivity.kt

---

📜 License

Licensed under the MIT License. Keep it light, keep it fast. Stay in control.

---

Developed with ❤️ by Lifer_Lighdow