Clean Architecture Folder Structure (Android)

android-folder-structure.md

🇺🇸 English

app/
└── src/
    └── main/
        └── java/com/exemplo/app/
            ├── presentation/          👈 Presentation layer (UI)
            │    ├── components/      -> Reusable Composables
            │    ├── screens/         -> Screens (each with its ViewModel)
            │    │    ├── home/
            │    │    ├── login/
            │    │    └── settings/
            │    └── navigation/      -> Routes, NavHost
            │
            ├── domain/              👈 Domain layer (Business rules)
            │    ├── model/          -> Domain entities
            │    ├── repository/     -> Interfaces (repository contracts)
            │    └── usecase/        -> Use cases (business logic)
            │
            ├── persistence/         👈 Data layer (Actual implementations)
            │    ├── entity/         -> Database entities (Room)
            │    ├── repository/     -> Concrete repository implementations
            │    ├── remote/         -> APIs, DTOs, Retrofit
            │    └── local/          -> DAOs, DataStore, SharedPrefs
            │
            ├── di/                  👈 Dependency Injection (Hilt/Koin)
            │
            ├── util/                👈 Helper functions, extensions, constants
            │    ├── Constants.kt    -> Global constants
            │    └── Extensions.kt
            │
            └── core/ (optional)     👈 Common layer, if multi-module

🇧🇷 Português

app/
 └── src/
      └── main/
           └── java/com/exemplo/app/
                ├── presentation/        👈 Camada de apresentação (UI)
                │    ├── components/     -> Composables reutilizáveis
                │    ├── screens/        -> Telas (cada uma com seu ViewModel)
                │    │    ├── home/
                │    │    ├── login/
                │    │    └── settings/
                │    └── navigation/     -> Rotas, NavHost
                │
                ├── domain/              👈 Camada de domínio (regras de negócio)
                │    ├── model/          -> Entidades de domínio
                │    ├── repository/     -> Interfaces (contratos dos repositórios)
                │    └── usecase/        -> Casos de uso (lógica de negócio)
                │
                ├── persistence/         👈 Camada de dados (implementações reais)
                │    ├── entity/         -> Entidades do banco de dados (Room)
                │    ├── repository/     -> Implementações concretas dos repositórios
                │    ├── remote/         -> APIs, DTOs, Retrofit
                │    └── local/          -> DAOs, DataStore, SharedPrefs
                │
                ├── di/                  👈 Injeção de dependência (Hilt/Koin)
                │
                ├── util/                👈 Funções de ajuda, extensões, constants
                │    ├── Constants.kt    -> Constantes globais
                │    └── Extensions.kt
                │
                └── core/ (opcional)     👈 Camada comum, se for multi-módulo