Aller au contenu
Démarrer un projetDémarrer

Envoi de fichiers

Laissez les gens envoyer des fichiers. Une seule API pour trois stockages : le disque local, tout stockage compatible S3, ou Vercel Blob.

Ce qu’il ajoute

  • packages/storage, construit sur Files SDK, avec trois drivers : le disque local, les stockages compatibles S3 (Cloudflare R2, AWS S3, MinIO) et Vercel Blob.
  • L’envoi d’avatar dans la page de compte, sur /api/uploads/avatar.
  • /api/files/*, qui sert les fichiers stockés par l’app.

L’installer

Par défaut (STORAGE_DRIVER=local), les envois vont dans apps/web/.storage/ et l’app les sert. Cela marche sur un serveur avec un disque, pas sur Vercel.

  • Stockage compatible S3 : mettez STORAGE_DRIVER=s3, puis S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY_ID et S3_SECRET_ACCESS_KEY. Avec un bucket public ou un CDN, mettez son URL de base dans STORAGE_PUBLIC_URL.
  • Vercel Blob : créez un store Blob dans le projet Vercel, puis mettez STORAGE_DRIVER=vercel-blob et BLOB_READ_WRITE_TOKEN.

La CLI demande où vont les fichiers en production (--files-driver local, s3 ou vercel-blob) et ne garde que les dépendances de ce driver.

Avant la mise en ligne

  • La production utilise s3 ou vercel-blob : local perd les fichiers à chaque déploiement sur un hébergeur serverless.
  • L’accès public et le CORS du bucket correspondent à STORAGE_PUBLIC_URL.

L’écarter ou l’ajouter plus tard

Retirez files de --modules pour démarrer sans envoi de fichiers. Pour l’ajouter à un projet existant, demandez à votre agent d’utiliser le skill add-module.

Lancez une commande. La CLI pose les autres questions, et votre agent prend la suite.

pnpm create turbinekit my-app
Voir le prompt

Collez-le dans un agent qui peut lancer des commandes, comme Claude Code, Codex ou Cursor. Le prompt est en anglais.

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

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.

Sans inscription, sans clé d'API. Il faut Node.js 24 et pnpm 10.