Loading repository data…

android-compose-clean-architecture-sample GitHub Details, Stars and Alternatives | OpenRepoFinder

eslamfaisal / repository

android-compose-clean-architecture-sample

🍰 Production-ready Android app demonstrating Clean Architecture with multi-module setup. Built with Jetpack Compose, Material 3, MVI pattern, Hilt DI, Retrofit, Room, and Kotlin Coroutines. Perfect for learning enterprise Android development best practices.

View Repository on GitHub ↗

REPOSITORY OVERVIEW

Live repository statistics

★ 82Stars

⑂ 20Forks

◯ 3Open issues

◉ 82Watchers

75/100

OPENREPOHUB HEALTH SIGNAL

Healthy signals

A transparent discovery signal based on current public GitHub metadata.

Recent activity35% weight

100

Community adoption25% weight

Maintenance state20% weight

License clarity10% weight

100

Project information10% weight

This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.

README preview

🍰 BakingApp

Enterprise Android Clean Architecture Sample

A production-ready, scalable Android application showcasing modern development practices, clean architecture, and best-in-class libraries.

Features • Architecture • Tech Stack • Getting Started • Documentation

✨ Highlights

🏗️ Clean Architecture	📱 Modern UI	🧪 Testable	🔒 Secure
Multi-module setup with clear separation of concerns	Jetpack Compose with Material 3 Design	Comprehensive unit & UI tests	NDK/C++ API keys + Encrypted storage

📸 Screenshots

Login	Home	Recipe Details
🔐 Secure Authentication	🏠 Recipe Discovery	📖 Step-by-Step Guide

🎯 Features

🔐 Authentication

┌────────────────────────────────────────────────────────────────────────────┐
│                           PRESENTATION LAYER                                │
│  ┌────────────────┐    ┌────────────────┐    ┌─────────────────────────┐   │
│  │    Screens     │    │   ViewModels   │    │       UI State          │   │
│  │   (Compose)    │◄───│     (MVI)      │───►│    (Immutable)          │   │
│  │                │    │                │    │                         │   │
│  │  • LoginScreen │    │ • LoginVM      │    │ • LoginUiState          │   │
│  │  • HomeScreen  │    │ • HomeVM       │    │ • HomeUiState           │   │
│  │  • DetailScreen│    │ • DetailVM     │    │ • RecipeDetailUiState   │   │
│  └────────────────┘    └───────┬────────┘    └─────────────────────────┘   │
│                                │                                            │
└────────────────────────────────┼────────────────────────────────────────────┘
                                 │ invoke()
                                 ▼
┌────────────────────────────────────────────────────────────────────────────┐
│                             DOMAIN LAYER                                    │
│  ┌────────────────┐    ┌────────────────┐    ┌─────────────────────────┐   │
│  │   Use Cases    │    │    Entities    │    │  Repository Interfaces  │   │
│  │                │    │                │    │                         │   │
│  │ • LoginUseCase │    │ • Recipe       │    │ • RecipeRepository      │   │
│  │ • GetRecipes   │    │ • Ingredient   │    │ • AuthRepository        │   │
│  │ • ToggleFav    │    │ • Step         │    │                         │   │
│  │ • SearchRecipes│    │ • LoginResult  │    │                         │   │
│  └────────────────┘    └────────────────┘    └────────────┬────────────┘   │
│                                                           │                 │
└───────────────────────────────────────────────────────────┼─────────────────┘
                                                            │ implements
                                                            ▼
┌────────────────────────────────────────────────────────────────────────────┐
│                              DATA LAYER                                     │
│  ┌────────────────┐    ┌────────────────┐    ┌─────────────────────────┐   │
│  │  Repository    │    │  Data Sources  │    │        Mappers          │   │
│  │     Impl       │    │                │    │                         │   │
│  │                │◄───│ • RecipesApi   │    │ • RecipeEntity → Recipe │   │
│  │ • RecipeRepo   │    │ • RecipeDao    │    │ • RecipeDto → Recipe    │   │
│  │ • AuthRepo     │    │ • AuthApi      │    │                         │   │
│  └────────────────┘    └────────────────┘    └─────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

┌──────────┐     ┌──────────────┐     ┌───────────┐     ┌────────────┐     ┌────────────┐
│   User   │────►│   Composable │────►│ ViewModel │────►│  Use Case  │────►│ Repository │
│  Action  │     │    Screen    │     │           │     │            │     │            │
└──────────┘     └──────────────┘     └─────┬─────┘     └────────────┘     └──────┬─────┘
                                            │                                      │
                                            │ StateFlow                            │
                                            │                                      ▼
                                      ┌─────▼─────┐                         ┌──────────────┐
                                      │ UI State  │◄────────────────────────│ Data Source  │
                                      │ (Updated) │       Result<T>         │  (API/Room)  │
                                      └───────────┘                         └──────────────┘

BakingApp/
│
├── 📱 app/                              # Application entry point
│   ├── BakingApplication.kt             # Hilt Application class
│   ├── MainActivity.kt                  # Single Activity
│   └── navigation/
│       └── BakingNavHost.kt             # Navigation graph
│
├── 🧱 core/                             # Shared core modules
│   ├── common/                          # Base classes & utilities
│   │   ├── base/
│   │   │   └── BaseUseCase.kt           # UseCase, FlowUseCase, NoParamUseCase
│   │   ├── result/
│   │   │   └── Result.kt                # Result<T> sealed class
│   │   ├── dispatcher/
│   │   │   └── DispatcherModule.kt      # Coroutine dispatchers
│   │   └── extensions/
│   │       └── FlowExtensions.kt        # Flow utility extensions
│   │
│   ├── network/                         # Networking layer
│   │   ├── api/
│   │   │   ├── AuthApi.kt               # Authentication endpoints
│   │   │   └── RecipesApi.kt            # Recipe endpoints
│   │   ├── interceptor/
│   │   │   ├── AuthInterceptor.kt       # Token injection
│   │   │   └── NetworkDelayInterceptor.kt
│   │   ├── model/
│   │   │   ├── RecipeDto.kt             # Data Transfer Objects
│   │   │   └── NetworkResponse.kt       # API response wrapper
│   │   └── di/
│   │       └── NetworkModule.kt         # Hilt network providers
│   │
│   ├── database/                        # Local persistence
│   │   ├── BakingDatabase.kt            # Room database
│   │   ├── dao/
│   │   │   └── RecipeDao.kt             # Recipe data access
│   │   ├── entity/
│   │   │   └── RecipeEntity.kt          # Room entities
│   │   └── di/
│   │       └── DatabaseModule.kt        # Hilt database providers
│   │
│   ├── security/                        # Security utilities
│   │   ├── cpp/                         # Native code (NDK)
│   │   │   ├── CMakeLists.txt           # CMake build config
│   │   │   └── native-keys.cpp          # XOR-obfuscated keys
│   │   ├── ApiKeyProvider.kt            # Key provider interface
│   │   ├── NativeKeyProvider.kt         # JNI bridge to native
│   │   ├── EncryptedPreferencesManager.kt
│   │   ├── SecureTokenManager.kt        # Token management
│   │   └── di/
│   │       └── SecurityModule.kt
│   │
│   └── ui/                              # Shared UI components
│       ├── components/
│       │   ├── BakingButton.kt
│       │   ├── BakingTextField.kt
│       │   ├── ErrorView.kt
│       │   ├── LoadingIndicator.kt
│       │   └── RecipeCard.kt
│       └── theme/
│           ├── Color.kt
│           ├── Theme.kt
│           └── Type.kt
│
├── 🎨 features/                         # Feature modules
│   ├── login/                           # Authentication feature
│   │   ├── data/
│   │   │   └── repository/
│   │   │       └── AuthRepositoryImpl.kt
│   │   ├── domain/
│   │   │   ├── model/
│   │   │   │   └── LoginResult.kt
│   │   │   ├── repository/
│   │   │   │   └── AuthRepository.kt
│   │   │   └── usecase/
│   │   │       ├── LoginUseCase.kt
│   │   │       ├── ValidateEmailUseCase.kt
│   │   │       └── ValidatePasswordUseCase.kt
│   │   ├── presentation/
│   │   │   ├── LoginScreen.kt
│   │   │   ├── LoginViewModel.kt
│   │   │   └── LoginUiState.kt
│   │   └── di/
│   │       └── LoginModule.kt
│   │
│   ├── home/                            # Recipe list feature
│   │   ├── data/
│   │   │   ├── datasource/
│   │   │   │   └── FakeRecipeDataSource.kt
│   │   │   ├── mapper/
│   │   │   │   └── RecipeMapper.kt
│   │   │   └── repository/
│   │   │       └── RecipeRepositoryImpl.kt
│   │   ├── domain/
│   │   │   ├── model/
│   │   │   │   └── Recipe.kt
│   │   │   ├── repository/
│   │   │   │   └── RecipeRepository.kt
│   │   │   └── usecase/
│   │   │       ├── GetRecipesUseCase.kt
│   │   │       ├── SearchRecipesUseCase.kt
│   │   │       └── ToggleFavoriteUseCase.kt
│   │   ├── presentation/
│   │   │   ├── HomeScreen.kt
│   │   │   ├── HomeViewModel.kt
│   │   │   └── HomeUiState.kt
│   │   └── di/
│   │       └── HomeModule.kt
│   │
│   └── recipe-details/                  # Recipe detail feature
│       └── presentation/
│           ├── RecipeDetailScreen.kt
│           ├── RecipeDetailViewModel.kt
│           └── RecipeDetailUiState.kt
│
└── 📚 docs/                             # Documentation
    ├── architecture.md
    ├── modules.md
    ├── networking.md
    ├── security.md
    ├── testing.md
    ├── performance.md
    └── compose_guidelines.md

                    ┌─────────┐
                    │   app   │
                    └────┬────┘
                         │
          ┌──────────────┼──────────────┐
          │              │              │
          ▼              ▼              ▼
    ┌───────────┐  ┌───────────┐  ┌───────────────┐
    │   login   │  │   home    │  │ recipe-details │
    └─────┬─────┘  └─────┬─────┘  └───────┬───────┘
          │              │                │
          └──────────────┴────────────────┘
                         │
          ┌──────────────┼──────────────┐
          │              │              │
          ▼              ▼              ▼
    ┌──────────┐  ┌───────────┐  ┌──────────┐
    │ core:ui  │  │core:common│  │core:network│
    └──────────┘  └───────────┘  └──────────┘
                         │
                         ▼

android-compose-clean-architecture-sample

Live repository statistics

Healthy signals

README preview

🍰 BakingApp

✨ Highlights

📸 Screenshots

🎯 Features

🔐 Authentication

🏠 Recipe Discovery

📖 Recipe Details

🏗️ Architecture

Architecture Diagram

Data Flow

📦 Module Structure

Module Dependencies