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

Upload de arquivos

Deixe as pessoas enviarem arquivos. Uma API para três armazenamentos: o disco local, qualquer armazenamento compatível com S3 ou o Vercel Blob.

O que ele adiciona

  • packages/storage, construído com o Files SDK, com três drivers: o disco local, armazenamentos compatíveis com S3 (Cloudflare R2, AWS S3, MinIO) e o Vercel Blob.
  • Upload de avatar na página da conta, em /api/uploads/avatar.
  • /api/files/*, que serve os arquivos que o app guarda.

Como configurar

Por padrão (STORAGE_DRIVER=local), os uploads vão para apps/web/.storage/ e o app serve esses arquivos. Isso funciona em um servidor com disco, não na Vercel.

  • Armazenamento compatível com S3: defina STORAGE_DRIVER=s3, depois S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY_ID e S3_SECRET_ACCESS_KEY. Com um bucket público ou uma CDN, defina STORAGE_PUBLIC_URL com a URL base deles.
  • Vercel Blob: crie um Blob store no projeto da Vercel, depois defina STORAGE_DRIVER=vercel-blob e BLOB_READ_WRITE_TOKEN.

A CLI pergunta para onde os arquivos vão em produção (--files-driver local, s3 ou vercel-blob) e só mantém as dependências desse driver.

Antes de entrar no ar

  • A produção usa s3 ou vercel-blob: o local perde os arquivos a cada deploy em uma hospedagem serverless.
  • O acesso público e o CORS do bucket correspondem ao STORAGE_PUBLIC_URL.

Deixar de fora ou adicionar depois

Deixe files fora de --modules para começar sem uploads. Para adicionar os uploads a um projeto existente, peça ao seu agente para usar o skill add-module.

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.