Repolode
igorwojda

igorwojda/android-showcase

App Android de referência em Kotlin que demonstra Clean Architecture, design modular de funcionalidades, Jetpack Compose e plugins de convenção do Gradle.

Estrelas
6,810
Forks
902
Issues abertas
7
Último commit
há 4 dias

O que é?

Android Showcase é um aplicativo Android de exemplo, feito com Jetpack Compose, que exibe informações de álbuns da API do Last.fm, com busca, detalhes dos álbuns e cache local usando Room. Seu principal objetivo é demonstrar como estruturar uma base de código Android no estilo de um produto de produção, e não servir como um produto de consumo pronto. As telas de favoritos e perfil ainda estão em desenvolvimento.

O projeto divide o app em módulos de funcionalidades (album, profile, favourite), além de módulos compartilhados de base e bibliotecas. Cada funcionalidade segue uma divisão de Clean Architecture em três camadas: presentation, domain e data, combinando MVVM com um estado único de UI no estilo MVI, propagado por Kotlin Flow. A lógica de build fica nos plugins de convenção, e as versões das dependências são gerenciadas em um catálogo de versões do Gradle.

A configuração também inclui ferramentas de qualidade: testes de arquitetura com Konsist, Detekt, Ktlint, Spotless, Android Lint e um pipeline de CI no GitHub Actions. Koin cuida da injeção de dependências, Retrofit e Coil cuidam da comunicação de rede e das imagens, e os testes usam JUnit, Mockk e Kluent.

Recursos principais

  • 01Lista de álbuns com busca e telas de detalhes, usando a API do Last.fm
  • 02Módulos de funcionalidades com Clean Architecture em três camadas e estado no estilo MVVM mais MVI
  • 03Plugins de convenção do Gradle e catálogo de versões centralizado
  • 04Verificações com Konsist, Detekt, Ktlint, Spotless e Android Lint integradas à CI
  • 05Cache local com Room, injeção de dependências com Koin e UI baseada em Compose

Casos de uso

  • Estudar como estruturar um app Android com vários módulos e Clean Architecture
  • Usar plugins de convenção do Gradle e catálogos de versões como modelo para um novo projeto
  • Ver exemplos de testes de arquitetura com Konsist e de configuração de análise estática
  • Aprender a combinar Jetpack Compose, Flow e Koin em um app no estilo de um produto real

Antes de usar

  • Os recursos Favorites e Profile ainda estão em desenvolvimento.
  • Os testes de interface do usuário com Espresso ainda estão em desenvolvimento.

Em coleções

Tópicos

Perguntas frequentes

O que é android-showcase?
App Android de referência em Kotlin que demonstra Clean Architecture, design modular de funcionalidades, Jetpack Compose e plugins de convenção do Gradle. Android Showcase é um aplicativo Android de exemplo, feito com Jetpack Compose, que exibe informações de álbuns da API do Last.fm, com busca, detalhes dos álbuns e cache local usando Room. Seu principal objetivo é demonstrar como estruturar uma base de código Android no estilo de um produto de produção, e não servir como um produto de consumo pronto. As telas de favoritos e perfil ainda estão em desenvolvimento.
android-showcase é gratuito? Qual é a licença?
android-showcase é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
android-showcase ainda é mantido?
Manutenção ativa. O último commit de android-showcase foi em 3 de nov. de 2026.
Para que posso usar android-showcase?
Estudar como estruturar um app Android com vários módulos e Clean Architecture Usar plugins de convenção do Gradle e catálogos de versões como modelo para um novo projeto Ver exemplos de testes de arquitetura com Konsist e de configuração de análise estática Aprender a combinar Jetpack Compose, Flow e Koin em um app no estilo de um produto real
Onde consigo android-showcase?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/igorwojda/android-showcase

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados