O Louve App é um aplicativo Android moderno, open source, dedicado à Harpa Cristã, projetado para funcionar 24h em produção com alta estabilidade, performance e experiência de usuário. O projeto adota as melhores práticas de arquitetura, está pronto para evoluir para multiplataforma e é construído para ser referência em qualidade técnica e experiência de produto.
O Louve App não é apenas um leitor de hinos. Ele é um ambiente digital de adoração, estudo e personalização, inspirado pela excelência do BibleProject. O objetivo é transformar a experiência com a Harpa Cristã em uma jornada de descoberta, imersão e conexão.
- Lista Completa de Hinos: 640 hinos da Harpa Cristã, carregados instantaneamente via código Kotlin gerado.
- Busca Inteligente: Pesquisa por título, número e conteúdo, tolerante a acentos e ordem das palavras.
- Detalhe do Hino: Visualização rica, ajuste de fonte, compartilhamento customizado.
- Sistema de Temas Dinâmicos: Escolha entre temas visuais imersivos, com fundos contextuais e experiência edge-to-edge.
- Autenticação Google: Login seguro, perfil persistente na nuvem (Firebase Auth + Firestore).
- Persistência Local: Preferências salvas com DataStore Preferences.
- Splash Screen Cinematográfica: Animação de abertura profissional.
- Arquitetura Clean e Modular: Pronta para KMP e expansão futura.
- Favoritos e Sincronização na Nuvem
- Remote Config para feature flags
- Rollout seguro e monitoramento avançado
- Migração gradual para multiplataforma (KMP)
- Ecossistema do Hino: contexto histórico, player de áudio, referências bíblicas
- Clean Architecture (Presentation, Domain, Data)
- MVVM + UDF (StateFlow, ViewModels reativos)
- Jetpack Compose (Material 3)
- Coroutines + Flow
- Hilt para DI
- Firebase Auth + Firestore
- DataStore Preferences
- Navigation Compose
- Splash Screen API
- Pronto para KMP (Domain em Kotlin puro)
Veja docs/3. Arquitetura de Software.MD para detalhes técnicos e diagramas.
- Splash e Inicialização: Animação e transição automática para Home.
- Listagem e Busca de Hinos: Busca avançada, UI reativa.
- Detalhe do Hino: Ajuste de fonte, compartilhamento, favoritos (em breve).
- Temas Dinâmicos: Escolha e persistência de tema.
- Autenticação Google: Login/logout, perfil na nuvem.
- Navegação: Entre Splash, Home, Detalhe, Configurações.
- Compartilhamento: Bottom sheet customizada, intent nativa.
Veja docs/Mapa_de_Fluxos_e_Testes.md para o mapeamento completo de fluxos e sugestões de testes.
app/
└── src/main/java/com/lucasdelima/louveapp/
├── data/ # Implementação de repositórios, fontes de dados
├── domain/ # Modelos e interfaces de negócio (Kotlin puro)
├── ui/ # Apresentação: screens, navigation, theme
├── di/ # Injeção de dependências (Hilt)
└── MainActivity.kt, MainViewModel.kt
- Leia o docs/6. Guia de Contribuição e Padrões.MD para entender o fluxo de trabalho, padrões de código e convenções de commit.
- Siga o docs/7. Configuração do Ambiente de Desenvolvimento.MD para rodar o projeto localmente.
- Consulte o docs/Mapa_de_Fluxos_e_Testes.md para entender os fluxos e pontos de testes.
- Abra issues ou pull requests sempre que possível. Nenhuma feature crítica é aceita sem revisão.
- Segredos nunca são versionados. Use o
keystore.propertieslocal. - Regras do Firestore versionadas e auditáveis (firestore.rules).
- Veja docs/8. Segurança e Lançamento.MD para detalhes.
- Visão e Filosofia do Produto
- Estado Atual e Roadmap
- Arquitetura de Software
- Guia de UI e Theming
- Camada de Dados e Backend
- Guia de Contribuição e Padrões
- Configuração do Ambiente
- Segurança e Lançamento
- Mapa de Fluxos e Testes
- Prompt Técnico Refinado
- Evoluir para multiplataforma (KMP), mantendo domínio compartilhado
- Sincronização de favoritos e preferências na nuvem
- Ecossistema de hinos enriquecido (áudio, contexto, referências)
- Observabilidade e rollout avançados
Para dúvidas, sugestões ou contribuições, abra uma issue ou entre em contato diretamente com o mantenedor principal:
Lucas de Lima
📧 dev.lucasdelima@gmail.com
🔗 linkedin.com/in/dev-lucasdelima
Louve App — Excelência, Imersão e Estabilidade em Adoração Digital.