---
title: Início rápido
description: Crie um projeto TurbineKit e rode na sua máquina, com um banco de dados local e nenhum serviço pago.
sidebar:
  order: 2
---

Você precisa de **Node.js 24** e **pnpm 10** (rode `corepack enable` uma vez).

## Criar o projeto

```sh
pnpm create turbinekit my-app
```

A CLI pergunta o nome do produto, uma descrição de uma frase, os idiomas e os
módulos. Ela instala as dependências, escreve o `apps/web/.env.local` com um
segredo novo e faz o primeiro commit.

## Iniciar o banco de dados e o app

```sh
cd my-app
pnpm db:local        # PGlite compatível com Postgres, sem Docker
pnpm db:migrate      # em um segundo terminal
pnpm dev
```

Abra http://localhost:3000 e crie uma conta. Sem um provedor de e-mail, o
e-mail de verificação vai para a caixa de desenvolvimento em
http://localhost:3000/api/dev/mailbox.

## Entregar o projeto ao seu agente

Abra o projeto no Claude Code, no Codex ou no Cursor. O agente lê o `AGENTS.md`
primeiro, e o `SETUP.md` lista os serviços para configurar, uma caixa por
passo.