MOTOKO BASEDocumentação
Introdução
O que é o Motoko Base, o que ele inclui e como usar esta documentação.
Motoko Base é um starter SaaS full-stack pronto para produção com Next.js. Não é um produto final para o usuário final — é uma base que você clona, configura e estende mantendo os mesmos padrões de autenticação, dados, cobrança e integrações.
Use esta documentação para entender como o starter está estruturado, o que vem pronto de fábrica e como personalizá-lo para o seu próprio produto.
O que é o Motoko Base?
O Motoko Base entrega um esqueleto completo de aplicação: dashboard autenticado, rotas protegidas, camada de banco de dados, abstração de cobrança, e-mail transacional, demos opcionais de armazenamento e IA, infraestrutura de analytics e monitoramento, páginas de marketing e ferramentas para desenvolvedores.
O objetivo é simples — construa seu SaaS, não a infraestrutura. Você foca nas funcionalidades do produto; o starter cuida da fiação repetitiva que todo SaaS precisa.
O que está incluído no starter?
Fundação principal
- Autenticação — Better Auth com e-mail/senha, verificação, redefinição de senha e OAuth opcional do Google e GitHub
- Banco de dados — PostgreSQL com Drizzle ORM, schemas tipados e migrations
- Cobrança — Integração com Polar: checkout, assinaturas, webhooks e entitlements (falha de forma suave quando não configurado)
- E-mail — Resend para e-mail transacional (verificação, redefinição de senha, templates)
- Shell do dashboard — Navegação lateral, configurações, tema e layout protegido
- Site de marketing — Landing page, seção de preços, docs e changelog
- Analytics e monitoramento — Integrações com PostHog e Sentry (opcionais, não bloqueantes)
- Infraestrutura pronta para IA — Vercel AI SDK com um provedor compatível com OpenAI
Funcionalidades demo
As demos ficam no grupo de navegação Demos. Elas mostram arquitetura real que você pode copiar para o seu produto ou remover por completo:
- Link Manager — CRUD de links com rotas públicas de redirecionamento (
/r/[slug]) - File Storage — Uploads no Cloudflare R2 com verificação de propriedade
- AI Email — Endpoint de IA com streaming integrado ao dashboard
As demos são intencionalmente removíveis. Consulte o README para uma checklist segura de exclusão.
Para quem é?
O Motoko Base foi feito para desenvolvedores e times pequenos que querem lançar um produto SaaS mais rápido sem montar o mesmo stack do zero toda vez.
É uma boa escolha se você:
- Quer uma aplicação real e funcional — não um template mínimo com rotas placeholder
- Prefere padrões opinativos em vez de uma tela em branco (server actions, pastas por feature, validação com Zod)
- Precisa de integrações de produção já conectadas, mas que falhem de forma suave quando as variáveis de ambiente não estão definidas
- Planeja possuir e modificar o código — adicionar features, remover demos, trocar provedores
Não é voltado a não desenvolvedores nem a times que buscam um construtor no-code.
Como esta documentação está organizada
Os docs são arquivos MDX versionados em content/docs/, renderizados em /docs com Fumadocs.
- Barra lateral — baseada em arquivos
meta.jsonem cada pasta; adicione páginas criando um MDX e listando-o nometa.jsonda pasta - Primeiros passos — instalação e configuração inicial (comece aqui)
- Guias — aprofundamentos em features e integrações (incluídos conforme a documentação cresce)
- Changelog — atualizações do produto em
/changelog, também em MDX sobcontent/changelog/
Cada página aceita frontmatter (title, description) e Markdown padrão. Blocos de código, títulos e links cruzados funcionam de imediato.
Para regras de arquitetura orientadas a agentes, veja AGENTS.md na raiz do repositório.
Experimente a demo ao vivo
Antes de instalar localmente, explore a aplicação em execução:
A demo permite entrar, navegar pelo dashboard e testar as demos incluídas — autenticação, UI de cobrança, configurações, Link Manager, Storage e AI Email — para ver como o starter se comporta na prática.
Próximos passos
Pronto para configurar a sua própria cópia?
Instalação — Clone, configure as variáveis de ambiente, rode as migrations e inicie o servidor de desenvolvimento.
Estrutura do projeto — Onde o código fica e como as pastas estão organizadas.