Você tem ideias. Tem há meses. Elas ficam lá no app de notas, fermentando lentamente em culpa. Toda segunda-feira você pensa "no próximo fim de semana" e todo domingo à noite você de alguma forma reorganizou a mesa inteira em vez de lançar qualquer coisa.
O problema não é talento nem ferramentas. É processo. A maioria dos projetos de fim de semana morre porque os builders gastam o sábado tomando decisões que deveriam ter tomado na sexta, e o domingo polindo coisas que ninguém pediu. 🔍
Seis meses atrás, este guia não seria viável. O Claude Code não conseguia montar uma aplicação full-stack de forma confiável a partir de um único arquivo de spec. O plano gratuito do Supabase não incluía edge functions. O plano hobby do Vercel tinha limites de deploy bem mais apertados. Mas no final de março de 2026, todas as ferramentas deste playbook rodam em planos gratuitos generosos o suficiente para lançar um produto real — não uma demo de brinquedo. O custo de um MVP de fim de semana caiu de "algumas centenas de dólares em hospedagem e APIs" para "literalmente zero reais se você tiver cuidado." Essa é a janela. 💰
Este é o playbook que eu engenheirei reversa observando centenas de lançamentos de fim de semana no último ano — os que realmente produziram uma URL ao vivo com usuários reais até domingo à noite. Não um protótipo. Não um mockup no Figma. Um produto deployado. A arma secreta: Claude Code — o assistente de código por terminal da Anthropic que lê seu projeto, escreve código e executa comandos direto no seu codebase.
Sexta à noite: Uma hora de decisões (não código)
O fim de semana começa sexta às 21h. Não com código — com decisões. Cada minuto que você gasta deliberando no sábado é um minuto que você não está construindo.
Escolha um formato de projeto
Estes são os únicos formatos que realisticamente ficam prontos em um fim de semana:
| Formato | Exemplo | Complexidade |
|---|---|---|
| Ferramenta | Unificador de PDF, compressor de imagem, formatador de texto | Baixa |
| Dashboard | Visualizador de analytics, página de status, painel de métricas | Média |
| Marketplace lite | Diretório, site de listagem, coleção curada | Média |
| SaaS micro | Produto de uma funcionalidade com auth e página de cobrança | Média-Alta |
| API wrapper | Pegar uma API feia — uma forma de programas se comunicarem — e deixar bonita | Baixa-Média |
Escreva a spec de uma página
Abra um arquivo. Escreva exatamente isso. Nada mais:
# MVP de Fim de Semana: [Nome]
## Uma frase
[O que faz, para quem]
## Fluxo principal
1. Usuário chega na página
2. Usuário faz [ação principal]
3. Usuário recebe [resultado]
## Obrigatório (sábado)
- [ ] Landing page
- [ ] Funcionalidade principal
- [ ] Deploy em URL de produção
## Seria bom ter (domingo)
- [ ] Auth
- [ ] Notificações por email
- [ ] Analytics básico
## NÃO vamos construir
- [ ] Painel admin
- [ ] Processamento de pagamento
- [ ] App mobile
- [ ] Perfis de usuário
Aquela seção "NÃO vamos construir"? A parte mais importante do documento inteiro. É o seu escudo contra o scope creep — aquela tendência natural de ficar adicionando "só mais uma coisinha" até o domingo ir embora e você não ter construído nada completo.
Configure o repositório
Um repo (repositório) é basicamente uma pasta de projeto rastreada pelo Git — software de controle de versão que salva cada mudança que você faz, como um Ctrl+Z infinito para o seu código.
mkdir my-mvp && cd my-mvp
git init
# Escolha UMA stack. Não fique deliberando.
# Opção A: Next.js + Supabase (full-stack, mais flexibilidade)
npx create-next-app@latest . --typescript --tailwind --app
# Opção B: Estático + API (mais simples, mais rápido)
# Apenas crie index.html e uma pasta /api
touch SPEC.md # Cole sua spec de uma página aqui
git add -A && git commit -m "init: weekend mvp"
Next.js é um framework baseado em React — pense nele como um kit inicial para construir web apps que já cuida de rotas, renderização server-side e deploy de fábrica. Supabase te dá banco de dados, login de usuário e armazenamento de arquivos com zero configuração de servidor.
Sábado de manhã: Construa o core (4-5 horas)
Acorda. Café. Terminal aberto. Nada de redes sociais, nada de email, nada de "deixa eu só dar uma olhadinha."
Horas 1-2: Scaffold com Claude Code
É aqui que o Claude Code mostra serviço. Abra ele no diretório do seu projeto:
claude
Dê o contexto completo:
Leia SPEC.md. Isso é um MVP de fim de semana — estamos
construindo o mínimo produto possível.
Monte o projeto:
1. Configure a estrutura de páginas baseada no fluxo principal
2. Crie o componente da funcionalidade principal
3. Configure o estilo básico com Tailwind
4. Crie um layout com nav e footer
5. Sem auth ainda, sem banco de dados ainda — só UI e lógica core
O Claude Code gera de 5 a 15 arquivos. Não revise cada linha. Você está checando três coisas: roda (npm run dev)? O fluxo principal está lá? A estrutura do código faz sentido?
Horas 2-4: Implemente a funcionalidade principal
Este é o único código que importa. Todo o resto é scaffolding — a estrutura de suporte que não é o produto em si.
Digamos que você está construindo um calculador de custo de reunião. Você diz pro Claude Code:
A funcionalidade principal é uma calculadora que recebe:
- Número de participantes
- Valor médio da hora
- Duração da reunião
E mostra um contador de custo em tempo real, custo total e
detalhamento de custo por minuto. Um único componente React.
Sem backend necessário. Use useState para o timer,
useEffect para a animação do contador.
O Claude Code escreve. Você testa no navegador. Você itera:
A animação do contador está travando. Use requestAnimationFrame
em vez de setInterval. Faça o número do custo enorme — 72px,
fonte monospace.
Disciplina fundamental: só itere na funcionalidade principal. Se o nav está torto, anota. Cosmético se resolve no domingo.
Horas 4-5: Deploy 🚀
Faça deploy antes do almoço. Ter uma URL ao vivo — um endereço real que qualquer pessoa pode visitar — muda sua psicologia de "brincando com código" para "construindo um produto."
# Vercel (mais rápido para Next.js)
npx vercel
# Ou Cloudflare Pages (mais rápido para sites estáticos)
npx wrangler pages deploy ./out
Vercel faz deploy automaticamente toda vez que você faz push de código. O plano gratuito cobre qualquer MVP. Manda a URL para uma pessoa. A reação de 30 segundos dela te diz mais do que uma semana de desenvolvimento solo.
Almoço: Sai da frente do computador
Sério. Come uma comida que não seja na sua mesa. A sessão da tarde dobra de produtividade quando seu cérebro descansou.
Sábado à tarde: Tecido conectivo (3-4 horas)
Funcionalidade principal funciona. Agora faça parecer um produto.
Horas 6-7: Banco de dados (se necessário)
Nem todo MVP precisa de banco de dados — um lugar estruturado para armazenar e buscar dados. Um calculador não precisa. Um diretório precisa.
Se o seu precisa, diga pro Claude Code:
Configure o Supabase:
1. Projete o schema mínimo — só tabelas para o fluxo principal
2. Configure o client em lib/supabase.ts
3. Adicione CRUD básico para o tipo de dado principal
4. Sem RLS ainda, sem queries complexas — só faça funcionar
CRUD significa Create, Read, Update, Delete — as quatro operações básicas em qualquer dado. RLS (Row Level Security) controla quem pode ver quais linhas. Pula isso por enquanto.
O plano gratuito do Supabase te dá 500 MB de PostgreSQL — um banco de dados open-source poderoso. Para um MVP, você vai usar uns 1 MB. São 500 MVPs de margem. 💰
// lib/supabase.ts — isso é tudo que você precisa
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(
process.env.NEXT_PUBLIC_SUPABASE_URL!,
process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
)
Horas 7-8: Auth (se necessário)
Auth (autenticação) — fazer usuários fazerem login para se identificar. Um calculador de reunião não precisa. Um dashboard pessoal precisa.
Adicione Supabase Auth:
1. Cadastro/login com email + senha
2. Componente simples de formulário de auth
3. Rota protegida para o dashboard
4. Gerenciamento de sessão via middleware
5. Sem login social, sem MFA — só email e senha
MFA (autenticação multifator) é aquele segundo código do seu celular. O Supabase Auth suporta 50.000 usuários ativos mensais de graça. Você nunca vai bater esse limite no fim de semana do MVP.
Horas 8-9: Landing page
Sua landing page precisa de exatamente quatro coisas:
- Título — o que faz (5-8 palavras)
- Subtítulo — para quem é (1 frase)
- Botão CTA — "Experimente grátis" / "Começar agora"
- Um screenshot — mostre o produto funcionando
Crie uma landing page:
- Seção hero com título, subtítulo e CTA
- Uma seção mostrando a funcionalidade principal
- Footer simples com informações de contato
- Sem depoimentos, sem preços, responsivo para mobile
Nada de tabela comparativa de funcionalidades. Nada de logos "usado por". Nada de gradientes animados. Lance a coisa real, não um site de marketing sobre a coisa real.
Domingo: Polimento e lançamento (6-8 horas)
Manhã: Conserte tudo que você ignorou ⚡
Abra suas anotações de sábado. Mande tudo pro Claude Code de uma vez:
Conserte isso em ordem:
1. Nav não destaca a página ativa
2. Menu mobile não fecha depois de clicar num link
3. Estado de loading mostra tela em branco — adicione um skeleton
4. Validação de formulário faltando no campo de email
5. Links do footer não levam a lugar nenhum — adicione páginas ou remova os links
Cada correção é pequena. Juntas, elas transformam "demo" em "produto."
Tarde: Checklist de lançamento
### Funciona
- [ ] Funcionalidade principal funciona no Chrome desktop
- [ ] Funcionalidade principal funciona no Safari mobile
- [ ] Todos os links levam a algum lugar
- [ ] Formulários validam input
- [ ] Erros mostram mensagens amigáveis
### Aparência correta
- [ ] Favicon existe
- [ ] Título da página e meta description definidos
- [ ] Imagem OG para compartilhamento em redes sociais
- [ ] Nenhum texto placeholder ("Lorem ipsum")
- [ ] Espaçamento e tipografia consistentes
### Pronto para produção
- [ ] Variáveis de ambiente configuradas em produção
- [ ] HTTPS funcionando
- [ ] Tempo de carregamento abaixo de 3 segundos
- [ ] Sem erros no console
- [ ] Página 404 existe
Peça pro Claude Code: "Passe por esta checklist comparando com nosso codebase. Me diga o que passa, o que falha, e conserte as falhas." Ele resolve isso em minutos.
Noite: Lança 🚀
Poste no Twitter/X, nos servidores de Discord relevantes, um thread no Reddit, Hacker News "Show HN" se couber. E não esqueça dos grupos de tech no Telegram e nas comunidades brasileiras de indie hackers. O formato de post que funciona:
Eu construí [nome do produto] nesse fim de semana — ele [faz tal coisa] para [público]. [URL] Construído com Next.js + Supabase + Claude Code. Feedback é bem-vindo.
Não escreva um textão de 2000 palavras sobre um projeto de fim de semana. O produto fala por si ou não fala.
Os assassinos de tempo que destroem MVPs de fim de semana 🗑️
| Assassino de tempo | Por que é tentador | Por que é uma armadilha |
|---|---|---|
| Design system customizado | "Precisa parecer profissional" | Os defaults do Tailwind já ficam bons |
| Auth do zero | "Não confio em terceiros" | Supabase Auth leva 10 minutos |
| Otimização de banco | "E se a gente escalar?" | Você tem 0 usuários. Otimize quando tiver 1.000 |
| Pipeline de CI/CD | "Boas práticas" | Dá push na main. Vercel faz deploy automático |
| Suite de testes | "Deveria ter testes" | Teste manual um MVP de fim de semana |
| Integração de pagamento | "Preciso monetizar" | Consiga usuários primeiro. Adicione Stripe na semana 2 |
| Painel admin | "Preciso gerenciar dados" | Use o dashboard do Supabase direto |
CI/CD (Integração Contínua/Deploy Contínuo) significa testes automatizados e deploy a cada push de código. Valioso na hora certa. Esse fim de semana não é a hora certa.
O cronograma realista
Sexta 21h: Escrever spec, configurar repo (1h)
Sábado 9h: Scaffold + funcionalidade principal (4h)
Sábado 13h: Pausa pro almoço (1h)
Sábado 14h: Banco + auth + landing page (4h)
Sábado 20h: Encerrado por hoje
Domingo 10h: Polimento + correção de bugs (3h)
Domingo 14h: Checklist de lançamento + deploy (2h)
Domingo 17h: Postar online + coletar feedback (1h)
Domingo 18h: MVP de fim de semana lançado
Tempo total de código focado: ~14h
14 horas de trabalho focado. Não 48 horas de maratona sem dormir. Durma as duas noites. Faça exercício domingo de manhã. Código descansado ganha de código exausto toda vez.
🦝 Opinião do Schnapps
O MVP de fim de semana testa a sua ideia, não a sua resistência. Se você não consegue explicar o que o produto faz em uma frase, você não consegue construí-lo em um fim de semana. Se você não consegue construir a funcionalidade principal em 4 horas com o Claude Code ajudando, a funcionalidade é complexa demais para um MVP.
Os projetos que saem do papel compartilham um traço: o builder cortou escopo sem dó. Uma seção na landing page. Uma funcionalidade no app. Duas tabelas no banco. E lançou.
Os projetos que não saem do papel compartilham outro traço: o builder gastou sábado à tarde pesquisando qual biblioteca de animação usar para transições de página. Não existem transições de página em um MVP. Existe uma página, e ela funciona. Lança isso. 🚀
