Aller au contenu
Démarrer un projetDémarrer

Docs de l'API

Des docs pour les personnes et les agents qui utilisent votre API. Guides et référence de l'API sur /docs de votre domaine, dans chaque langue du projet.

Ce qu’il ajoute

  • apps/docs, construit par Blume : des guides en MDX, et la référence de l’API construite à partir du document OpenAPI de vos opérations. Une nouvelle opération apparaît dans la référence avec sa propre description.
  • Les docs sur /docs de votre domaine principal : l’app redirige /docs vers le déploiement des docs.
  • Son propre llms.txt et une copie Markdown de chaque page, pour les agents.
  • Des guides dans chaque langue du projet. pnpm --filter docs translate écrit les traductions manquantes avec Claude.

L’installer

pnpm dev démarre aussi les docs sur http://localhost:4321/docs, et l’app les sert sur http://localhost:3000/docs.

Pour déployer, créez un second projet Vercel avec le Root Directory apps/docs et SITE_URL réglé sur l’URL de production de l’app. Puis mettez dans DOCS_ORIGIN, sur l’app, l’URL du projet des docs.

Avant la mise en ligne

Le projet des docs est déployé, et /docs sur le domaine principal l’affiche.

L’écarter ou l’ajouter plus tard

Retirez docs de --modules pour démarrer avec une seule app. Pour ajouter les docs à 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.