Saltar al contenido
Empezar un proyectoEmpezar

Subida de archivos

Deja que la gente suba archivos. Una sola API para tres almacenamientos: el disco local, cualquier almacenamiento compatible con S3, o Vercel Blob.

Qué agrega

  • packages/storage, basado en Files SDK, con tres drivers: el disco local, los almacenamientos compatibles con S3 (Cloudflare R2, AWS S3, MinIO) y Vercel Blob.
  • Subida de avatar en la página de la cuenta, en /api/uploads/avatar.
  • /api/files/*, que sirve los archivos que guarda la app.

Configurarlo

Por defecto (STORAGE_DRIVER=local), los archivos subidos van a apps/web/.storage/ y la app los sirve. Eso funciona en un servidor con disco, no en Vercel.

  • Almacenamiento compatible con S3: define STORAGE_DRIVER=s3, y luego S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY_ID y S3_SECRET_ACCESS_KEY. Con un bucket público o un CDN, define STORAGE_PUBLIC_URL con su URL base.
  • Vercel Blob: crea un store de Blob en el proyecto de Vercel, y luego define STORAGE_DRIVER=vercel-blob y BLOB_READ_WRITE_TOKEN.

La CLI pregunta adónde van los archivos en producción (--files-driver local, s3 o vercel-blob) y conserva solo las dependencias de ese driver.

Antes del lanzamiento

  • Producción usa s3 o vercel-blob: local pierde los archivos en cada despliegue de un hosting serverless.
  • El acceso público y el CORS del bucket coinciden con STORAGE_PUBLIC_URL.

Dejarlo fuera o agregarlo después

Deja files fuera de --modules para empezar sin subida de archivos. Para agregarla a un proyecto existente, pide a tu agente que use el skill add-module.

Ejecuta un comando. La CLI pregunta lo demás, y tu agente sigue desde ahí.

pnpm create turbinekit my-app
Ver el prompt

Pégalo en un agente que pueda ejecutar comandos, como Claude Code, Codex o Cursor. El prompt está en inglés.

Create a new TurbineKit project with me.
Talk to me in Spanish.

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.

Sin registro, sin claves de API. Necesita Node.js 24 y pnpm 10.