Controle financeiro pessoal inteligente para React Native
Gerencie suas finanças com facilidade: despesas, receitas, cartão de crédito e relatórios em tempo real
📱 Demo • ⚡ Instalação • 📈 Recursos • 🚀 Deploy
| 💱 | Controle Total | Gerencie receitas, despesas e cartão de crédito em um só lugar |
| 📈 | Relatórios Visuais | Gráficos interativos e estatísticas detalhadas |
| 🔒 | Segurança | Autenticação via Supabase e dados criptografados |
| 🔄 | Sincronização | Dados sempre atualizados na nuvem |
| ⚡ | Performance | Interface rápida e responsiva |
| 📱 | Multiplataforma | Funciona perfeitamente em iOS e Android |
Nota: Screenshots e demo em vídeo serão adicionados em breve!
Finances é um aplicativo completo de gerenciamento financeiro pessoal desenvolvido com React Native e Expo. Oferece controle total sobre suas finanças com interface moderna, sincronização em nuvem e relatórios detalhados.
- ✓ Login seguro com email/senha
- ✓ Cadastro rápido de novos usuários
- ✓ Recuperação de senha
- ✓ Sessão persistente
- ✓ Visão geral financeira em tempo real
- ✓ Gráficos interativos (pizza, barras, linhas)
- ✓ Relatórios por período
- ✓ Estatísticas de gastos por categoria
- ✓ Balanço mensal e anual
- ✓ Despesas à vista - Controle total de gastos
- ✓ Cartão de crédito - Acompanhe faturas e limites
- ✓ Receitas - Registre todas as entradas
- ✓ Transferências - Movimentação entre contas
- ✓ Categorização - Organize por tipo de gasto
- ✓ Anexos - Fotos de comprovantes
- ✓ Design moderno e intuitivo
- ✓ Modo escuro/claro
- ✓ Animações fluidas
- ✓ Interface responsiva
- ✓ Onboarding interativo
📱 React Native - Framework mobile nativo
⚡ Expo - Plataforma de desenvolvimento
🔷 TypeScript - Tipagem estática
🧭 React Navigation - Navegação entre telas
🎨 React Native Reanimated - Animações de alta performance
📈 React Native SVG - Gráficos e ícones vetoriais
✨ Lottie - Animações complexas
🔋 Supabase - Backend-as-a-Service completo
🔐 Supabase Auth - Autenticação e autorização
💾 PostgreSQL - Banco de dados relacional
📱 AsyncStorage - Cache local no dispositivo
🚀 GitHub Actions - CI/CD automatizado
📦 EAS Build - Builds nativas
🔄 EAS Update - Atualizações OTA
📋 Expo Application Services - Infraestrutura completa
- Onboarding: Introdução ao aplicativo para novos usuários
- Autenticação: Login e cadastro de usuários
- Home/Dashboard: Visão geral das finanças
- Transações:
- Despesas (à vista)
- Despesas de cartão
- Receitas
- Transferências
- Relatórios: Visualização de dados financeiros por período
# Clone o repositório
git clone https://github.com/ademisson-Auto/Finances.git
cd Finances
# Instale as dependências
npm install
# Configure as variáveis de ambiente
cp .env.example .env
# Edite o .env com suas credenciais do Supabase
# Inicie o projeto
npx expo start- Node.js 18+
- npm ou yarn
- Expo CLI global:
npm install -g @expo/cli - Conta no Supabase (gratuita)
- Expo Go app no seu dispositivo (para testes)
# Executar no Android
npx expo run:android
# Executar no iOS
npx expo run:ios
# Executar na Web
npx expo start --web
# Limpar cache
npx expo start --clearEste projeto usa GitHub Actions para automatizar o processo de build e deploy para o Expo.
-
Crie um token de acesso do Expo:
- Acesse expo.dev
- Vá para Configurações > API de acesso
- Crie um novo token com o nome "GitHub Actions"
-
Adicione o token como segredo no GitHub:
- No repositório GitHub, vá para Settings > Secrets > Actions
- Adicione um novo segredo com o nome
EXPO_TOKEN - Cole o token gerado pelo Expo
-
Faça um push para a branch principal (main) para acionar o workflow.
finances/
├── assets/ # Imagens e recursos
├── src/
│ ├── assets/ # Assets específicos para componentes
│ ├── components/ # Componentes reutilizáveis
│ │ ├── auth/ # Componentes de autenticação
│ │ ├── common/ # Componentes comuns (botões, inputs)
│ │ └── onboarding/ # Componentes de onboarding
│ ├── contexts/ # Contextos React (AuthContext)
│ ├── navigation/ # Configuração de navegação
│ ├── screens/ # Telas do aplicativo
│ │ ├── auth/ # Telas de autenticação
│ │ └── transactions/# Telas de transações financeiras
│ ├── services/ # Serviços de API (Supabase)
│ ├── types/ # Definições de tipos TypeScript
│ └── utils/ # Funções utilitárias
└── ...
- 📸 Screenshots & Demo - Adicionar imagens e vídeo demonstrativo
- 📄 Exportação de Relatórios - PDF e Excel
- 📡 Notificações Push - Lembretes de vencimentos
- 📅 Planejamento - Orçamentos e metas financeiras
- 🔄 Backup Automático - Sincronização com Google Drive
- 🌍 Multi-idiomas - Suporte internacional
- 🤖 IA Financeira - Análise inteligente de gastos
- 🏦 Integração Bancária - Open Banking
- 💹 Investimentos - Controle de ações e criptomoedas
- 👥 Colaborativo - Finanças familiares
Contribuições são muito bem-vindas! Aqui está como você pode ajudar:
- Verifique se o bug já foi reportado nas Issues
- Crie uma nova issue com detalhes do problema
- Inclua screenshots e informações do dispositivo
- Abra uma issue com o label
enhancement - Descreva detalhadamente sua ideia
- Explique por que seria útil
- Faça um fork do projeto
- Crie uma branch:
git checkout -b feature/nova-funcionalidade - Commit suas mudanças:
git commit -m 'Adiciona nova funcionalidade' - Push para a branch:
git push origin feature/nova-funcionalidade - Abra um Pull Request
O aplicativo está disponível para download:
- 🤖 Android APK
- 🍎 iOS (em breve na App Store)
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.
💰 Finances - Controle financeiro inteligente
Desenvolvido com ❤️ por Ademisson
Se este projeto te ajudou, deixe uma ⭐!