O Fim do "Cemitério de git init": Como 4 Anos Construindo em Público Me Levaram a Esta Arquitetura de SaaS · felipebarcelospro

Fala, devs do TabNews! Felipe Barcelos aqui.

Se você é como eu, provavelmente tem uma pasta no seu computador cheia de ideias de SaaS. Projetos que morreram alguns dias (ou horas) depois de um git init. Eu chamo isso de "Cemitério de git init".

A gente não desiste por preguiça. A gente desiste porque esbarramos sempre na mesma muralha:

"Droga, configurar autenticação de novo..."
"Beleza, agora configurar o Stripe..."
"Preciso de uma landing page, um dashboard, um sistema de times..."
"...e um servidor de email pra testar o 'Esqueci minha senha'."

Esse trabalho repetitivo mata o momentum de qualquer um.

A Origem: A Promessa de Reuso

Desde o meu primeiro Micro-SaaS, há mais de 4 anos, minha meta era clara: criar uma arquitetura que pudesse ser 100% reaproveitada nos próximos projetos. Eu não queria mais perder tempo.

A cada projeto, a cada SaaS que eu construía, essa arquitetura evoluía.

Muitos de vocês aqui no TabNews acompanharam essa jornada. Vocês viram quando eu estava lançando 12 Micro-SaaS em um ano (usando a primeira versão dessa arquitetura).

Viram também quando essa necessidade me levou a criar meu próprio framework, o Igniter.js, para ter APIs 100% type-safe.

E mais recentemente, viram essa jornada evoluir para resolver o problema real do "Vibe Coding" com MCP Servers.

No ano passado, decidi compartilhar essa "fábrica" de forma mais aberta no meu canal do YouTube (que hoje tem quase 13 mil inscritos). A resposta foi absurda. Hoje, +90 desenvolvedores já estão usando essa mesma base para lançar seus próprios projetos.

O que começou como um "boilerplate" pessoal, virou um ecossistema maduro e validado em produção.

E o que eu quero compartilhar hoje é o resultado final de todos esses anos. Um deep dive na arquitetura que eu uso para ir da ideia ao SaaS completo (com Auth, Pagamento, Dashboard e IA) em minutos.

1. A Dor: O Setup Mínimo Viável

O primeiro problema a resolver era o setup. Um git init não é suficiente. Eu precisava que um único comando me entregasse um projeto com Front e Back prontos, incluindo:

✅ Autenticação (Google, GitHub, Magic Link)
✅ Onboarding de usuário
✅ Servidor de Email Falso (para localhost:8025)
✅ Landing Page, Blog, Docs e Central de Ajuda
✅ Dashboard (com ShadCN/UI)
✅ Sistema de Pagamentos (Stripe, planos, trial - como detalhei aqui)
✅ Sistema de Times e Permissões

(Sugestão: Use um print do seu vídeo, @ 16:52, mostrando o npx saas-boilerplate...)

Eu simplesmente executo:

npx saas-boilerplate@latest create my-project

E já tenho:
Imagem da Dashboard

2. A Arquitetura: Feito para ser Extensível (O Padrão "Adapter")

Um boilerplate não pode ser uma "prisão". Ele precisa ser uma "base".

Para isso, estruturei o back-end (em Next.js + Igniter.js) em torno de "Providers" e "Adapters".

O exemplo clássico é o de pagamentos. O core do app entende o conceito de provider.pagamento.criarAssinatura(). Ele não sabe se é Stripe, Asaas ou Abmex.

Na pasta de providers, eu tenho os adapters:

/providers
  /payment
    - stripe.adapter.ts
    - asaas.adapter.ts (você pode criar)
    - index.ts

Quer trocar o Stripe pelo Asaas? Você só precisa criar um asaas.adapter.ts que satisfaça a interface e mudar uma linha no .env. Isso vale para Storage (S3, GCS...), Email (Resend, SMTP...), etc.

(Sugestão: Use um print do seu vídeo, @ 36:49, mostrando as pastas features, hooks, providers)

3. O "Fator UAU": Construído para IA (Igniter.js + "Lia")

Aqui foi onde eu mais gastei tempo no último ano. A produtividade não era só o boilerplate, mas fazer a IA entender o boilerplate.

O Igniter.js foi criado para isso: ser um framework 100% type-safe que um Code Agent (Cursor, Claude) consegue "ler" e "entender" a arquitetura.

Dentro do boilerplate, existe a "Lia", um conjunto de treinamentos que ensina a IA a trabalhar com o projeto. O resultado é que eu o Claude Code, Cursor ou qualquer outro Code Agent sabe EXATAMENTE como usar o Igniter.js e o SaaS Boilerplate.

Aqui eu tenho um link da minha docs que mostra mais sobre ela:
https://demo.saas-boilerplate.vibedev.com.br/docs/code-agents/lia-overview

O Deep Dive Completo (52 Minutos)

Falar é fácil, mostrar é melhor.

Gravei um overview completo de 52 minutos. Não é um vídeo de venda, é um deep dive técnico onde eu mostro cada pasta, cada funcionalidade, e rodo a instalação do zero.

Se você, como eu, também sofre com o "Cemitério de git init", talvez essa abordagem te dê algumas ideias.

https://www.youtube.com/watch?v=FdXk97CwQds

Conclusão

Essa jornada de 4 anos me ensinou que a ferramenta mais importante de um dev é o momentum. O que eu construí foi, para mim, a melhor ferramenta para manter esse momentum vivo.

Hoje, esse projeto é o SaaS Boilerplate e é como eu ganho a vida. Mas ele só existe porque resolveu uma dor que, arrisco dizer, todos nós aqui já sentimos.

O que vocês acham dessa abordagem? Como vocês lidam com a "síndeome do git init"?

Qualquer feedback sobre a arquitetura ou a ideia é super bem-vindo! Tamo junto.