llms.txt dans Next.js : Route Handler ou fichier statique

Before you start

• Un projet Next.js utilisant l'App Router. Les valeurs par défaut de cache décrites ici sont propres à l'App Router et ne s'appliquent pas au Pages Router.
• Une source de vérité à partir de laquelle générer le contenu : un tableau de services, une requête au CMS, votre module d'entités. Si la seule source est une chaîne écrite à la main, utilisez public/ et acceptez la dérive.

Implementation on Next.js

1. 1.Choisissez le mode d'échec que vous acceptez

   Un fichier dans public/llms.txt est servi directement et ne coûte rien, mais c'est une copie des faits de votre site que rien ne synchronise : il devient faux en silence le jour où vous publiez une nouvelle page de service. Un Route Handler généré à partir des vraies données ne peut pas dériver, puisqu'il lit la même source que vos pages. Prenez public/ seulement si le site est petit et change rarement.

2. 2.Créez le Route Handler

   Ajoutez app/llms.txt/route.ts qui exporte une fonction GET renvoyant une Response. Déclarez le type de contenu explicitement : ce fichier doit être servi en texte brut pour être utile, et l'écrire évite de dépendre des valeurs par défaut du cadriciel. Rappel de la documentation : un route.ts et un page.tsx ne peuvent pas coexister au même segment de route, ce qui ne pose aucun problème ici.

   import { siteUrl } from "@/lib/data";
   import { organization } from "@/data/entities";
   import { SERVICES } from "@/data/services";
   
   // Dans l'App Router, les Route Handlers ne sont PAS mis en cache par défaut.
   // Sans cette ligne, le fichier est régénéré à chaque requête de robot.
   export const dynamic = "force-static";
   
   export function GET() {
     const actifs = SERVICES.filter((s) => s.active);
   
     const corps = [
       `# ${organization.name}`,
       "",
       `> ${organization.description}`,
       "",
       "## Services (English)",
       ...actifs.map((s) => `- ${s.name} — ${siteUrl}${s.enPath}`),
       "",
       "## Services (français)",
       ...actifs.map((s) => `- ${s.nameFr} — ${siteUrl}${s.frPath}`),
       "",
     ].join("\n");
   
     return new Response(corps, {
       headers: { "Content-Type": "text/plain; charset=utf-8" },
     });
   }

3. 3.Activez la mise en cache explicitement

   C'est l'étape que tout le monde saute. Dans l'App Router, les Route Handlers ne sont pas mis en cache par défaut ; seule la méthode GET peut y adhérer, et elle le fait par une option de configuration de route. Ajouter export const dynamic = "force-static" prérend la réponse au build, ce qui convient à un fichier dont le contenu ne change qu'au déploiement. Sans ça, chaque robot qui récupère /llms.txt invoque votre fonction.

4. 4.Traitez le bilinguisme dans le contenu, pas dans les routes

   Rien ne vous empêche techniquement de créer app/fr/llms.txt/route.ts, mais la convention place le fichier à la racine du domaine et aucun robot n'ira chercher ailleurs. llms.txt ne possède aucun mécanisme équivalent à hreflang. La solution qui fonctionne est un fichier unique qui énumère explicitement les URL des deux langues, avec un intertitre par langue, comme dans l'exemple de Route Handler ci-dessus.

5. 5.Générez à partir de la même source que vos pages

   La seule raison d'utiliser un Route Handler plutôt qu'un fichier statique, c'est qu'il peut lire vos vraies données. Sur ce site, le gestionnaire importe les mêmes modules d'entités et de services que ceux qui produisent le JSON-LD et les pages de service : le fichier ne peut donc ni annoncer un service disparu ni oublier un service ajouté. Si votre llms.txt est généré depuis une autre source, vous entretenez deux choses.

6. 6.Déployez et confirmez le prérendu

   Après le build, regardez le tableau des routes. Une route marquée statique a été prérendue ; une route marquée dynamique s'exécutera à chaque requête, ce qui signifie presque toujours que l'export force-static manque ou que le gestionnaire touche à des données de requête. Sur Vercel et les plateformes équivalentes, c'est la différence entre une ressource statique en cache et une invocation de fonction par passage de robot.

   npx next build
   # Repérez /llms.txt dans le tableau des routes et vérifiez qu'il est statique.

Example

La forme de sortie visée pour un site bilingue. Des faits et des URL, pas du texte de positionnement — et les deux langues nommées dans le même fichier.

# Studio Exemple

> Studio de développement web établi à Montréal. Site et services offerts en français et en anglais.

Site web : https://exemple.com
Langues : français (/fr), anglais (racine)

## Services — français

- Refonte de site web — à partir de 4 000 $ CA — https://exemple.com/fr/refonte-site-web
- Référencement technique — 1 200 $ CA/mois — https://exemple.com/fr/referencement-naturel

## Services — English

- Website redesign — from $4,000 CAD — https://exemple.com/website-redesign
- Technical SEO — $1,200 CAD/month — https://exemple.com/seo

## Pages clés

- [À propos](https://exemple.com/fr/a-propos)
- [Contact](https://exemple.com/fr/contact)

What catches people out

Verify it worked

1. 1.Confirmez le code et le type de contenu en production

   Le point d'accès doit renvoyer 200 avec un type de contenu texte brut. Si vous obtenez text/html, quelque chose rend une page : le plus souvent une route attrape-tout ou une réécriture qui intercepte le chemin avant le gestionnaire.

   curl -sI https://votresite.com/llms.txt | grep -iE "^(HTTP|content-type)"

2. 2.Confirmez le prérendu plutôt que le calcul par requête

   Cherchez /llms.txt dans le tableau des routes de next build et vérifiez qu'il est listé comme statique. S'il est dynamique, l'export force-static manque ou le gestionnaire lit des données de requête. C'est la vérification qui attrape le piège de cache, et elle s'automatise facilement en intégration continue.

   npx next build | grep -A2 'llms.txt'

3. 3.Confirmez que les deux langues sont présentes et exactes

   Comparez les services et les URL listés dans le fichier à ce que le site offre réellement aujourd'hui, dans les deux langues. Une section française absente ou pointant vers des chemins anglais est le symptôme d'un fichier généré depuis une source partielle — précisément ce que l'approche par Route Handler doit empêcher.

   curl -s https://votresite.com/llms.txt | grep -c 'exemple.com/fr/'

What this will not do

• force-static fige le fichier au moment du build. Si vos services ou votre contenu changent par un CMS sans redéploiement, le fichier accusera un retard jusqu'au prochain déploiement : prévoyez une revalidation ou un déclencheur de rebuild si c'est important.
• Un fichier unique pour deux langues reste un compromis. Vous ne pouvez pas offrir à un assistant francophone une description française complète sans allonger le fichier pour tout le monde.
• Un Route Handler ne peut décrire que les données que votre application possède déjà. Il ne compense pas un site qui n'énonce nulle part ses prix, son territoire desservi ou qui le dirige.
• Le comportement de cache décrit ici a été vérifié contre Next.js 16.3.0 dans l'App Router. Les versions majeures antérieures et le Pages Router diffèrent, et Next.js a déjà changé ses valeurs par défaut de cache d'une majeure à l'autre.
• llms.txt demeure une proposition sans statut normatif. La servir est peu coûteux et sans risque ; ce n'est pas un levier de classement, et aucun moteur ne garantit de la lire.

Sources

Les faits sur cette plateforme proviennent de la documentation ci-dessous, vérifiée le August 14, 2026.

• Next.js — Route Handlers (mise en cache, résolution de route)primary
• Next.js — dossier public (service des fichiers statiques et en-têtes de cache)primary
• Next.js — convention de fichier route.jsprimary

Autres plateformes

• llms.txt sur Shopify
• llms.txt sur WordPress

Rédigé et vérifié techniquement par Jaeden Doody, fondateur de StillAwake Media, qui construit et maintient les implémentations Next.js décrites ici. Implémentation vérifiée le August 14, 2026.