π± CleanPhoneLauncher
A minimalist Android launcher for a calmer digital life
β¨ Features
- π― Minimalist design - Clean interface without distracting elements
- β° Customizable clock - Analog or digital, with or without seconds
- β Favorite apps - Quick access, with drag-and-drop reordering
- π Searchable app drawer - Instant search with alphabet fast-scroll
- ποΈ App options - Long-press for App info or to uninstall
- π¨ Theming - System/Light/Dark + dynamic (Material You) or accent colors
- π± Quick shortcuts - Phone and camera always within reach
- π Battery display - Battery status overview right on the home screen
- π Private by design - No ads, no tracking; optional opt-in crash reporting
- π Fast and smooth - Optimized for the best performance
πΈ Screenshots
| Home Screen |
App List |
Clock Settings |
Remove |
| Main screen with clock and favorites |
Complete list of installed apps |
Clock type selection |
Manage favorite apps |
ποΈ Architecture
The project uses Clean Architecture with MVI (Model-View-Intent) pattern:
app/src/main/java/dev/rikoapp/cleanphonelauncher/
β
βββ π data/ # Data layer
β βββ π database/ # Room database
β β βββ π dao/
β β β βββ FavoriteAppDao.kt # Data Access Object
β β βββ π di/
β β β βββ DatabaseModule.kt # Koin DI module for database
β β βββ π entities/
β β β βββ FavoriteAppEntity.kt # Database entity
β β βββ π mappers/
β β β βββ FavoriteAppMapper.kt # Entity to domain mapper
β β βββ CleanPhoneLauncherDatabase.kt # Room database
β βββ π di/
β β βββ DataModule.kt # Koin DI module for data
β βββ ClockRepositoryImpl.kt # Clock repository implementation
β βββ InstalledAppsRepositoryImpl.kt # Installed apps repository implementation
β βββ RecentAppsRepositoryImpl.kt # Recent apps repository implementation
β βββ RoomLocalFavoriteAppDataSource.kt # Favorite apps data source implementation
β
βββ π di/ # Dependency Injection
β βββ AppModule.kt # Main Koin module
β
βββ π domain/ # Domain layer
β βββ π model/ # Domain models
β β βββ AppData.kt # Application data model
β β βββ FavoriteApp.kt # Favorite app model
β βββ ClockRepository.kt # Clock repository interface
β βββ InstalledAppsRepository.kt # Installed apps repository interface
β βββ LocalFavoriteAppDataSource.kt # Favorite apps data source interface
β βββ RecentAppsRepository.kt # Recent apps repository interface
β
βββ π presentation/ # Presentation layer (MVI)
β βββ π applist/ # App list feature (MVI)
β β βββ AppListScreen.kt # UI (View)
β β βββ AppListScreenAction.kt # User actions (Intent)
β β βββ AppListScreenState.kt # UI state (Model)
β β βββ AppListViewModel.kt # State management
β βββ π home/ # Home feature (MVI)
β β βββ HomeScreen.kt # UI (View)
β β βββ HomeScreenAction.kt # User actions (Intent)
β β βββ HomeScreenState.kt # UI state (Model)
β β βββ HomeViewModel.kt # State management
β βββ π components/ # Reusable UI components
β β βββ AnalogClock.kt # Analog clock
β β βββ AppListItem.kt # App list item
β β βββ ClockTypeDialog.kt # Clock selection dialog
β β βββ DigitalClock.kt # Digital clock
β β βββ FavoriteDialog.kt # Favorites dialog
β βββ π model/ # Presentation models
β β βββ ClockType.kt # Clock type enum
β βββ π di/
β β βββ PresentationModule.kt # Koin DI module for presentation
β βββ π ui/
β β βββ π theme/ # Material 3 theme
β β βββ Icon.kt # Icons
β β βββ Theme.kt # Colors and themes
β β βββ Type.kt # Typography
β βββ LauncherPager.kt # ViewPager for navigation
β
βββ MainActivity.kt # Main activity
βββ MainApplication.kt # Application class with Koin
Architecture Layers (MVI)
+---------------------------------------------------------------+
| PRESENTATION (MVI) |
| |
| +----------+ +------------+ +-------------+ |
| | Screen | | ViewModel | | State | |
| | (View) | | | | Action | |
| +----+-----+ +------+-----+ +------+------+ |
| | | | |
| | User Action | | |
| |------------------>| Process Action | |
| | |------------------>| |
| | | | |
| | |<------------------| |
| |<------------------| New State | |
| | Render UI | | |
| |
+-------------------------------+-------------------------------+
|
+-------------------------------v-------------------------------+
| DOMAIN |
| +-------------------+ +-------------------------+ |
| | Models (AppData) | | Interfaces (Repository) | |
| +-------------------+ +-------------------------+ |
+------------------------------+--------------------------------+
|
+------------------------------v--------------------------------+
| DATA |
| +-------------+ +-------------+ +-------------+ |
| | Room | | DAOs | | Entities | |
| +-------------+ +-------------+ +-------------+ |
| +---------------------+ |
| | RepositoryImpl(s) | |
| +---------------------+ |
+---------------------------------------------------------------+
π οΈ Tech Stack
| Technology |
Usage |
| Kotlin 2.4 |
Main programming language |
| Jetpack Compose |
Modern declarative UI |
| Material 3 |
Design system (dynamic color) |
| Room |
Local SQLite database |
| Koin |
Dependency Injection |
| Coroutines & Flow |
Asynchronous operations |
| ViewModel |
UI state management |
| Firebase Crashlytics |
Optional, opt-in crash reporting |
π Requirements
- Android 8 (API 26) or higher
- Android Studio Ladybug or newer
π Installation
From GitHub Releases
- Go to Releases
- Download the latest
CleanPhoneLauncher-vX.X.X.apk
- Install the APK on your device
Build from Source
# Clone the repository
git clone https://github.com/RikoAppDev/CleanPhoneLauncher.git
# Navigate to the folder
cd CleanPhoneLauncher
# Build debug version
./gradlew assembleDebug
# Find APK at: app/build/outputs/apk/debug/
π§ Development
Running the Project
- Open the project in Android Studio
- Sync Gradle
- Run on emulator or physical device
Branch Structure
main - Protected production branch; pushes build, release and deploy automatically. Force-pushes and deletions are blocked, and CI (lint, tests, build) is required.
Commit Conventions
The project uses Conventional Commits:
feat: add new feature # β Minor version (1.0.0 β 1.1.0)
fix: fix a bug # β Patch version (1.0.0 β 1.0.1)
feat!: breaking change # β Major version (1.0.0 β 2.0.0)
π CI/CD
The project has a fully automated CI/CD pipeline:
- β
Automatic builds on every push to main
- β
Automatic versioning based on commit messages
- β
Automatic GitHub Releases with APK and AAB
- β
Lint checks and tests on every PR
- β
Play Store deployment to the internal testing track
More information in CI_CD_SETUP.md.
π Project File Structure
CleanPhoneLauncher/
βββ π .github/
β βββ π workflows/
β β βββ ci.yml # Continuous Integration
β β βββ release.yml # Build & Release
β βββ CI_CD_SETUP.md # CI/CD documentation
βββ π app/
β βββ π src/
β β βββ π main/
β β β βββ π java/ # Kotlin source files
β β β βββ π res/ # Resources (layouts, strings, ...)
β β βββ π test/ # Unit tests
β β βββ π androidTest/ # Instrumentation tests
β βββ build.gradle.kts
βββ π docs/
β βββ π screenshots/ # App screenshots
βββ π gradle/
β βββ libs.versions.toml # Version catalog
βββ build.gradle.kts
βββ LICENSE
βββ README.md
π€ Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'feat: add amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
π License
This project is licensed under the MIT License.
π¨βπ» Author
RikoAppDev - GitHub
Made with β€οΈ and Kotlin