O passo a passo e o prompt para criar o seu app de finanças
Existem milhões de apps de finanças. Eu criei o meu por causa de uma situação que acontece toda
semana em casa. Aqui está o caminho que eu sigo, em 6 passos, e o prompt pronto para você montar o seu com o
Claude Code e o Supabase.
6 passos, na ordem1 prompt pronto para copiar5 prompts de ajuste
“Paguei no meu cartão. Como cobro a parte da outra pessoa depois?”
A ideia
App pronto resolve o problema da média. Sistema próprio resolve o seu.
O FinançasPro começou com um pedido da minha namorada: ela pagava no cartão dela e depois precisava cobrar a
parte da outra pessoa. Isso acontece toda semana, e eu queria que o app resolvesse exatamente isso.
Então eu construí. Hoje ele tem visão geral do mês, dividir uma compra com
alguém, acerto do mês por pessoa, parcelas que aparecem sozinhas nos meses certos e
um diagnóstico de saúde financeira.
Mas ele não nasceu com tudo isso. Nasceu com o problema de casa e cresceu com o uso. É isso que o passo a
passo abaixo ensina: começar pelo seu problema, não pela lista de funções.
Primeiro o problema, depois a tecnologia. O prompt é o ponto de partida; quem decide o que o
app faz é você.
O passo a passo
Do problema de casa ao sistema no ar
São 6 passos. Os 2 primeiros são antes de abrir qualquer ferramenta.
01
Passo 1 de 6 · Antes de tudo
Escreva o seu problema em uma frase
Por que importa: se você pede "um app de finanças", recebe o app da média. Se
você descreve a sua situação, recebe o seu.
Responda antes de começar
Qual situação se repete e hoje dá trabalho?
O que você quer saber em 3 segundos ao abrir o app?
O que você vai lançar todo dia (e de onde, celular ou computador)?
Tem mais alguém envolvido: casal, família, amigos, sócio?
No FinançasPro: "pago no meu cartão e preciso cobrar a parte da outra pessoa
depois" e "quero saber como está meu mês em 3 segundos". Tudo o que veio depois saiu dessas duas
frases.
02
Passo 2 de 6 · Ferramentas
Separe as 4 ferramentas
Por que importa: cada uma faz uma parte. O Claude escreve o código, o
Supabase guarda os dados e o login, o GitHub guarda o projeto e a Vercel coloca no ar.
O que você precisa
Conta no Claude com acesso ao Claude Code
Conta no Supabase (dá para começar no plano grátis)
Conta no GitHub e na Vercel (o plano grátis da Vercel serve para uso pessoal)
Node.js instalado no computador
Claude CodeEscreve e ajusta o código
SupabaseBanco de dados e login
GitHubGuarda o projeto
VercelColoca no ar
03
Passo 3 de 6 · Primeira versão
Cole o prompt e deixe montar só o núcleo
Por que importa: pedir tudo de uma vez gera um app cheio de tela que não
funciona. O prompt já pede para construir em fases e parar no fim de cada uma.
Como fazer
Crie uma pasta vazia e abra o Claude Code nela
Troque os trechos entre [colchetes] do prompt pelo seu problema
Cole o prompt e aprove a fase 1: login, lançar e ver o mês
Só passe para a fase seguinte quando a anterior funcionar
Dica: peça para ele explicar o plano antes de escrever código. Se o plano não
bate com o seu problema, corrija ali. Corrigir o plano é muito mais barato do que corrigir o app.
04
Passo 4 de 6 · Banco de dados
Crie o banco e tranque cada usuário nos próprios dados
Por que importa: é dinheiro. Ninguém além de você pode ver os seus
lançamentos, nem por engano.
Como fazer
Crie um projeto no Supabase
Rode o SQL que o Claude gerar no SQL Editor do Supabase
Confira se o RLS está ligado em todas as tabelas
Cole a URL e a chave pública do projeto no arquivo .env.local
RLS é a regra do banco que faz cada usuário enxergar só as próprias linhas. O
prompt já pede isso. Mesmo assim, peça ao Claude para conferir: "todas as tabelas têm RLS ligado e
política por usuário?".
05
Passo 5 de 6 · Uso real
Use por uma semana e ajuste uma coisa de cada vez
Por que importa: se lançar dá trabalho, ninguém lança. E app de finanças sem
lançamento não serve para nada. Os melhores ajustes aparecem no uso, não no planejamento.
Ajustes que vieram do uso no FinançasPro
O campo de valor que faz a conta: digitar 750/5 vira 150
Atalhos de Hoje e Ontem na data
Parcelas que aparecem sozinhas nos meses certos
Um botão para esconder os valores na tela
Deslizar para o lado para excluir um lançamento
Regra: um pedido por vez, testado antes do próximo. Os prompts de ajuste mais
abaixo são exatamente esses pedidos, prontos para copiar.
06
Passo 6 de 6 · No ar
Publique e instale no celular
Por que importa: você lança na hora em que gasta, e isso acontece longe do
computador.
Como fazer
Peça ao Claude para subir o projeto no GitHub
Importe o repositório na Vercel e cole as mesmas variáveis do .env.local
Abra o endereço no celular e use "Adicionar à tela inicial"
Fica como app: o prompt pede uma versão instalável (PWA). Ela abre em tela
cheia, com ícone próprio, sem precisar de loja de aplicativos.
O prompt
O prompt para criar o seu
Escrito a partir do que o FinançasPro faz hoje. Troque o que está entre [colchetes] pela sua situação e
apague o que você não precisa.
Prompt principal · Claude Code
Quero construir um app de finanças pessoais só para mim. Antes de escrever qualquer código, leia tudo, me explique o plano em tópicos e espere eu aprovar.
O MEU PROBLEMA
[Escreva aqui a sua situação. Exemplo: "Eu pago compras no meu cartão e depois preciso cobrar a parte da outra pessoa. Quero saber, em 3 segundos, como está o meu mês."]
QUEM USA
Uso pessoal. Eu lanço pelo celular na hora em que gasto e consulto no computador. Tudo em português do Brasil, valores em reais (R$).
TECNOLOGIA
- React + Vite + Tailwind CSS, com ícones do lucide-react e gráficos com recharts.
- Supabase para login (e-mail e senha) e banco de dados.
- RLS ligado em todas as tabelas: cada usuário só lê e escreve as próprias linhas.
- Me entregue o SQL completo para eu rodar no SQL Editor do Supabase.
- As chaves ficam no .env.local (VITE_SUPABASE_URL e VITE_SUPABASE_ANON_KEY). Nunca coloque chave no código.
- Versão instalável no celular (PWA).
O QUE O APP FAZ
1. Lançamentos
- Tipo: despesa ou receita. Campos: valor, data, categoria, subcategoria (opcional), descrição (opcional), cartão (opcional) e status pago/pendente.
- O campo de valor aceita conta: "750/5" vira 150, "120+35" vira 155.
- Atalhos de data: Hoje e Ontem.
- Repetição: única, fixa (semanal, mensal ou anual, sem fim ou com quantidade) ou parcelada (2 ou mais parcelas). As parcelas aparecem sozinhas nos meses certos, com "3/10" na descrição.
- Um botão + sempre visível para lançar rápido.
2. Visão geral do mês
- Seletor de mês.
- Cartões com receitas, despesas, saldo e economia do mês.
- Gráfico de despesas por categoria e evolução dos últimos 6 meses.
- Lançamentos recentes.
- Um botão para esconder os valores da tela.
3. Pessoas e divisão [apague se não dividir gastos com ninguém]
- Cadastro de contatos (pessoas com quem divido gastos).
- "Dividir com alguém" no lançamento: escolho a pessoa e a parte dela em % ou em reais. O app grava a minha despesa e um valor a receber dessa pessoa, de uma vez só.
- Também posso marcar um lançamento como "eu devo" ou "me deve" para alguém.
- Uma tela por pessoa com o saldo: quanto ela me deve e quanto eu devo.
- Acerto do mês: seleciono os itens pendentes (ou todos), confirmo o valor e o app registra o acerto e marca os itens como pagos.
4. Cartões e categorias
- Cadastro de cartões com nome, bandeira, cor e limite, e quanto do limite cada cartão já comprometeu.
- Categorias e subcategorias editáveis, com ícone e cor.
5. Saúde financeira
- Taxa de poupança, comprometimento da renda com gastos fixos e meses de reserva de emergência.
- Reserva de emergência com meta e saldo atual.
- Metas (ex.: viagem) com valor e quanto já foi guardado.
DESIGN
- Mobile first, tema escuro e claro.
- O mais importante do mês aparece primeiro; o resto fica para quem quiser se aprofundar.
- Lançar precisa levar poucos toques.
COMO CONSTRUIR
Construa em fases e pare no fim de cada uma para eu testar:
- Fase 1: login, lançamentos (única, fixa e parcelada) e a visão geral do mês.
- Fase 2: pessoas, dividir com alguém e acerto do mês.
- Fase 3: cartões, categorias e saúde financeira.
- Fase 4: versão instalável (PWA) e preparação para publicar na Vercel.
Se alguma regra estiver ambígua, me pergunte em vez de supor.
Ficou grande demais para você? Apague os módulos 3, 4 e 5 e comece só com
lançamentos e visão do mês. Dá para pedir o resto depois, um de cada vez.
Prompts de ajuste
Para usar depois da primeira semana
Um por vez, testando antes do próximo. Cada um resolve algo que apareceu no uso do FinançasPro.
Lançar mais rápido
Lançar está dando trabalho. Deixe o formulário de novo lançamento abrir com o cursor no valor, aceitar conta no campo (750/5, 120+35) e ter atalhos de Hoje e Ontem na data. Quero lançar uma compra em menos de 10 segundos.
Privacidade na tela
Adicione um botão de olho para esconder todos os valores do app (aparecem como ••••). A escolha fica salva e vale para todas as telas, para eu poder abrir o app perto de outras pessoas.
Excluir no celular
Na lista de lançamentos, quero deslizar o item para a esquerda para excluir, com uma confirmação antes. Se o lançamento for parcelado ou fixo, pergunte se é só este, este e os próximos, ou todos.
Exportar
Adicione um botão para exportar os lançamentos do período filtrado em CSV, com data, descrição, categoria, valor, status e pessoa vinculada, para eu abrir no Excel ou no Google Planilhas.
Revisão de segurança
Revise a segurança do app antes de eu usar com dados reais: todas as tabelas têm RLS ligado com política por usuário? Alguma chave secreta está no código ou no GitHub? Liste o que encontrar e corrija.
Sob medida
Prefere que eu construa o seu?
O guia mostra o caminho. Se você quer um sistema para o seu negócio ou para a sua casa e prefere que eu
construa, me conta qual situação se repete e dá trabalho hoje.
Você me conta o problemaPreenche o formulário e a gente continua no WhatsApp.
Eu desenho o sistemaO que ele faz, em que ordem e quanto custa.
Vai para o arFuncionando no computador e no celular, com os seus dados.