SaaS Boilerplate 2.0: O Que Aprendi Reconstruindo Nosso Projeto do Zero e Criando o Igniter.js

Se você acompanha minha jornada como indie hacker, provavelmente já ouviu falar do SaaS Boilerplate que lancei há alguns meses. O que começou como uma ferramenta pessoal para acelerar meus próprios projetos acabou ajudando centenas de desenvolvedores a lançarem seus produtos mais rapidamente.

Mas a verdade é que a primeira versão, embora funcional, tinha suas limitações. E depois de receber feedback valioso da comunidade (incluindo algumas críticas bem diretas), decidi que era hora de uma reconstrução completa.

Neste artigo, quero compartilhar com transparência o processo de desenvolvimento da versão 2.0, as decisões técnicas que tomamos e, principalmente, o que aprendi durante essa jornada. Sem marketing, apenas a realidade crua de um desenvolvedor tentando criar algo útil para outros desenvolvedores.

Por Que Reconstruir do Zero?

A decisão de reconstruir completamente um produto que já estava funcionando não foi fácil. Afinal, a versão 1.0 já tinha:

• Mais de 300 desenvolvedores utilizando
• Dezenas de SaaS construídos e lançados com ela
• Uma base de código estável e testada

Mas três problemas principais me incomodavam:

1. Arquitetura monolítica: A v1 foi construída como um monolito, o que dificultava a manutenção e a personalização por parte dos usuários.

2. Acoplamento excessivo: Muitos componentes estavam fortemente acoplados, tornando difícil substituir partes específicas (como trocar o Stripe por outro processador de pagamentos).

3. Experiência do desenvolvedor: O feedback mais consistente que recebi foi sobre a curva de aprendizado íngreme para quem não estava familiarizado com todas as tecnologias utilizadas.

Em vez de aplicar patches e correções incrementais, percebi que precisávamos de uma base completamente nova. Foi uma decisão arriscada, mas acredito que valeu a pena.

As Principais Mudanças na Versão 2.0

1. Arquitetura Baseada em Recursos

A mudança mais significativa na v2 é a nova arquitetura baseada em recursos. Cada funcionalidade principal agora é um módulo independente:

src/
  ├── saas-boilerplate/    # Recursos principais do SaaS
  │   ├── auth/            # Autenticação e autorização
  │   ├── payment/         # Processamento de pagamentos
  │   └── organizations/   # Gerenciamento de organizações
  ├── app/                 # Páginas do Next.js
  │   ├── (dashboard)/     # Área logada
  │   ├── (site)/          # Site de marketing
  │   └── (auth)/          # Páginas de autenticação
  ├── content/             # Blog, docs e outros conteúdos
  ├── core/                # Componentes e utilitários
  └── features/            # Seus recursos específicos

Essa estrutura torna muito mais fácil entender onde cada coisa está e, mais importante, permite que você substitua ou personalize módulos específicos sem afetar o resto do sistema.

2. Nova UI e Experiência do Usuário

Uma das maiores melhorias na v2 é a interface de usuário completamente reconstruída. O dashboard agora oferece uma experiência muito mais intuitiva e moderna, com:

• Design responsivo e otimizado para todos os dispositivos
• Navegação simplificada e mais intuitiva
• Componentes reutilizáveis e personalizáveis
• Temas claro e escuro nativos
• Acessibilidade melhorada

Além disso, a dashboard agora inclui novas funcionalidades como autenticação de dois fatores (2FA), gestão de sessões, chaves de API e muito mais. Tudo isso mantendo a tipagem forte do TypeScript do banco de dados até o frontend, garantindo uma experiência de desenvolvimento segura e produtiva.

3. Sistema de Autenticação Aprimorado e Segurança

Uma das áreas que recebeu mais atenção na v2 foi o sistema de autenticação e segurança. Reconstruir essa parte nos permitiu implementar:

• Autenticação de dois fatores (2FA) para maior segurança
• Gestão completa de sessões, permitindo aos usuários visualizar e encerrar sessões ativas
• Sistema de chaves de API para integrações seguras
• Integração com webhooks para conectar com serviços externos
• Controle de acesso baseado em funções (RBAC) mais robusto

Essas melhorias garantem que aplicações construídas com o SaaS Boilerplate v2 sejam não apenas mais fáceis de usar, mas também significativamente mais seguras.

Lições Aprendidas Durante o Processo

1. Ouvir a Comunidade é Essencial

A maior parte das melhorias na v2 veio diretamente do feedback dos usuários. Aprendi que, por mais que eu ache que entendo as necessidades dos desenvolvedores, nada substitui ouvir diretamente deles.

Por exemplo, muitos usuários relataram dificuldades com o sistema de autenticação na v1. Em vez de apenas documentar melhor, redesenhamos completamente a experiência, tornando-a mais simples e flexível.

2. Documentação é Tão Importante Quanto Código

Um dos maiores focos na v2 foi melhorar significativamente a documentação. Agora temos um site de documentação completo com:

• Exemplos de código para cada funcionalidade
• Guias passo a passo para tarefas comuns
• Explicações detalhadas da estrutura do projeto
• Seções específicas para integrações como Stripe e e-mails transacionais

Além disso, o blog agora contém artigos detalhados sobre como utilizar diferentes aspectos do boilerplate, compartilhando conhecimento e experiências reais de desenvolvimento.

3. Integrações e Flexibilidade

Na v2, investimos muito em tornar o boilerplate mais flexível e fácil de integrar com outros serviços:

• Integração aprimorada com Stripe para processamento de pagamentos
• Sistema de e-mails transacionais mais robusto
• Otimização de SEO em todas as páginas
• Suporte a múltiplos provedores para diferentes funcionalidades

Essas melhorias permitem que os desenvolvedores personalizem suas aplicações de acordo com suas necessidades específicas, sem precisar reescrever grandes partes do código.

O Que Não Mudou: Nosso Compromisso com a Velocidade

Apesar de todas essas mudanças, o objetivo principal do SaaS Boilerplate continua o mesmo: permitir que desenvolvedores lancem produtos SaaS em tempo recorde.

A v2 mantém a promessa de permitir que você construa um SaaS funcional em um final de semana, mas agora com uma base mais sólida, flexível e fácil de personalizar.

Próximos Passos e Convite à Comunidade

O lançamento da v2 não é o fim da jornada, mas apenas o começo de uma nova fase. Continuaremos melhorando o boilerplate com base no feedback da comunidade e nas necessidades reais dos desenvolvedores que o utilizam.

Se você está usando o SaaS Boilerplate, convido você a compartilhar suas experiências, sugerir melhorias ou até mesmo contribuir com código. Acredito firmemente que as melhores ferramentas são aquelas construídas por uma comunidade ativa e engajada.

Conclusão: Construindo em Público

Decidi compartilhar todo esse processo de reconstrução porque acredito no conceito de "building in public" (construir em público). Mostrar não apenas os sucessos, mas também os desafios e aprendizados, é uma forma de contribuir para a comunidade de desenvolvedores.

A v2 do SaaS Boilerplate representa um grande avanço em relação à v1, com uma nova UI, sistema de autenticação aprimorado, melhor documentação e mais integrações. Mas o mais importante é que ela continua fiel ao propósito original: permitir que desenvolvedores lancem produtos SaaS em tempo recorde, sem precisar reinventar a roda.

Se você quiser experimentar a nova versão, toda a documentação está disponível no nosso site. E lembre-se: o objetivo não é apenas construir rápido, mas construir algo que realmente resolva problemas para seus usuários.

Sobre o Autor: Felipe Barcelos é desenvolvedor full-stack, indie hacker e fundador da Vibe Dev. Apaixonado por ajudar outros desenvolvedores a transformarem suas ideias em negócios reais.

Vamos construir juntos

Criei o SaaS Boilerplate porque acredito que desenvolvedores devem se concentrar no que torna seu produto único, não reinventando sistemas de autenticação ou pagamento pela milésima vez.

Confira a documentação para começar e faça parte dessa comunidade de construtores.

Construindo em público, Felipe