Pular para o conteúdo
Começar um projetoComeçar

SETUP.md

De um clone novo a um app rodando, serviço por serviço. O seu agente marca cada caixa ao terminar o passo.

Duas etapas

  1. Configuração mínima, cerca de 10 minutos. Um banco de dados e um segredo. Tudo funciona: o site, o cadastro, a área logada, a API REST e o servidor MCP. Os e-mails vão para uma caixa de desenvolvimento em vez de uma caixa de entrada.
  2. Serviços. Adicione as chaves de cada serviço que você quiser. Cada um é independente: sem as chaves dele, a funcionalidade fica desligada e nada quebra.

Caixas que o seu agente marca

Cada passo é uma caixa de seleção. O arquivo pede que os agentes marquem a caixa ao terminar o passo dela, e que escrevam uma linha embaixo quando precisaram fazer algo diferente. A próxima pessoa, ou o próximo agente, vê o que já foi feito.

- [x] Install, and create the local environment file
- [x] Start the database, create the tables, start the app
- [ ] Google and GitHub sign-in

Os serviços que ele cobre

  • E-mail, com Resend ou Email SDK, e a caixa de desenvolvimento até lá.
  • Login com Google e GitHub.
  • Upload de arquivos, docs da API, analytics, o banner de consentimento e pagamentos, para os módulos que o projeto tem.
  • O cron diário de limpeza.
  • O deploy na Vercel, ou em qualquer hospedagem Node.js.

Um módulo que você deixou de fora não tem seção: a CLI também remove esse módulo do SETUP.md.

Rode um comando. A CLI pergunta o resto, e o seu agente continua daí.

pnpm create turbinekit my-app
Ver o prompt

Cole em um agente que possa rodar comandos, como Claude Code, Codex ou Cursor. O prompt está em inglês.

Create a new TurbineKit project with me.
Talk to me in Brazilian Portuguese.

TurbineKit (https://turbinekit.dev) is an open-source Turborepo and Next.js starter. Its CLI, create-turbinekit, needs Node.js 24 and pnpm 10 (run `corepack enable` once).

1. Run `pnpm dlx create-turbinekit --help` to see its options.
2. Ask me its questions one at a time, with their defaults: the folder, the product name, one sentence about the product, the company or legal name, the contact email, the languages and the modules. Skip what I have already told you.
3. The CLI only asks questions in an interactive terminal, so run it with my answers as options and `--yes`. Show me the command before you run it.
4. In the new folder, read AGENTS.md. Then do "1. Minimal setup" in SETUP.md, and tick each box you finish.
5. Tell me the URL of the running app, and which services SETUP.md lists next.

Sem cadastro, sem chaves de API. Precisa de Node.js 24 e pnpm 10.