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 Favoritos Híbrido: Marque hinos favoritos com sincronização automática entre dispositivos
- 🎨 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 Inteligente: Dados locais para usuários não logados, sincronização na nuvem para usuários logados
- 🎬 Splash Screen Cinematográfica: Animação de abertura profissional
- 🧭 Navegação Completa: 8+ telas com barra de navegação inferior e navegação hierárquica
- 📊 Analytics Integrado: Firebase Analytics para insights de uso
- 🔄 Sincronização Avançada: Migração automática de dados, resolução de conflitos, monitoramento de conectividade
- 🎨 Sistema de Temas Completo: Múltiplos temas com sincronização local e remota
- ⭐ Sistema de Favoritos Avançado: Sincronização híbrida (local + Google Cloud)
- 🧭 Barra de Navegação Inferior: Interface moderna com navegação intuitiva
- 👆 Controle Gestual de Fonte: Movimento de pinça para ajustar tamanho da fonte
- 💾 Persistência de Preferências: Tamanho da fonte salvo durante navegação
- 🎨 TopAppBar Especializada: Barras superiores contextuais por tela
- ⚡ Splash Screen Otimizada: 40% redução no tempo de carregamento
- 🎯 Feedback Háptico: Efeitos táteis nos ícones da navegação
- 🔧 Performance Otimizada: Melhorias gerais de velocidade e responsividade
📋 Versionamento: Seguimos Semantic Versioning (SemVer). A versão atual é v1.1.0 - uma versão MINOR com múltiplas funcionalidades adicionadas de forma compatível.
- Clean Architecture (Presentation, Domain, Data)
- MVVM + UDF (StateFlow, 9 ViewModels reativos)
- Jetpack Compose (Material 3)
- Coroutines + Flow
- Hilt para DI (100% dos componentes)
- 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 cinematográfica e transição automática para Home
- 📚 Listagem e Busca de Hinos: Busca avançada com debounce, UI reativa
- 📖 Detalhe do Hino: Ajuste de fonte, compartilhamento, sistema de favoritos
- ⭐ Favoritos: Lista dedicada, sincronização automática, migração de dados
- 🎨 Temas Dinâmicos: Escolha e persistência de tema com preview visual
- 🔐 Autenticação Google: Login/logout, perfil na nuvem, migração automática
- 🧭 Navegação Completa: Entre 8+ telas com barra inferior e navegação hierárquica
- 📱 Perfil e Configurações: Gerenciamento de conta, preferências, suporte
- 🔄 Sincronização: Migração automática, resolução de conflitos, modo offline
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/ # 9 implementações de repositórios, fontes de dados
├── domain/ # 7 interfaces e modelos de negócio (Kotlin puro)
├── ui/ # 8+ telas, navegação, temas, componentes
├── di/ # Injeção de dependências (Hilt)
└── MainActivity.kt, MainViewModel.kt
- 🎬 SplashScreen: Animação cinematográfica com silhuetas e efeitos
- 🏠 HomeScreen: Lista de hinos com busca em tempo real
- ⭐ FavoritesScreen: Lista de hinos favoritos com estado vazio
- 🔍 DiscoverScreen: Preview de funcionalidades futuras
- ⚙️ MoreScreen: Ações rápidas e informações do usuário
- 📖 HymnDetailScreen: Visualização completa com controles de fonte
- 👤 ProfileScreen: Perfil do usuário com estatísticas
- ⚙️ SettingsScreen: Configurações e seleção de temas
- ℹ️ AboutScreen: Informações do app e filosofia
- 🆘 SupportScreen: Formulário de suporte completo
- 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
- Sistema de Navegação
- Sistema de Autenticação
- Sistema de Migração
- Funcionalidades Implementadas
- Mapa de Fluxos e Testes
- Changelog Completo - Histórico detalhado seguindo Semantic Versioning (SemVer)
- 🎵 Ecossistema do Hino: contexto histórico, player de áudio, referências bíblicas
- 🔄 Remote Config: feature flags para rollout seguro
- 📊 Observabilidade: monitoramento avançado e métricas
- 🌐 Multiplataforma: evolução para KMP mantendo domínio compartilhado
- 🤖 IA Integrada: Harpa com linguagem moderna e atualizada
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.