<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Jordan Philippot</title>
    <description>The latest articles on DEV Community by Jordan Philippot (@jordanphilippot).</description>
    <link>https://dev.to/jordanphilippot</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4214987%2F11226d4f-1a18-43f8-92c7-e7a9e03b1d60.jpg</url>
      <title>DEV Community: Jordan Philippot</title>
      <link>https://dev.to/jordanphilippot</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/jordanphilippot"/>
    <language>en</language>
    <item>
      <title>Stratégie de tests React et Next.js : du portfolio au socle Payload</title>
      <dc:creator>Jordan Philippot</dc:creator>
      <pubDate>Wed, 11 Nov 2026 08:16:10 +0000</pubDate>
      <link>https://dev.to/jordanphilippot/strategie-de-tests-react-et-nextjs-du-portfolio-au-socle-payload-118n</link>
      <guid>https://dev.to/jordanphilippot/strategie-de-tests-react-et-nextjs-du-portfolio-au-socle-payload-118n</guid>
      <description>&lt;p&gt;&lt;strong&gt;En bref&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;La répartition des tests dépend de ce que le projet peut casser. Un site sans backend se protège surtout par des tests de logique et de contenu, une application avec base de données par des tests d’intégration.&lt;/li&gt;
&lt;li&gt;Sur ce portfolio, les tests Vitest vérifient la logique pure et le contenu lui-même (liens entre articles, longueur des descriptions, typographie), sans Testing Library ni Playwright.&lt;/li&gt;
&lt;li&gt;Sur mon socle Payload, les tests d’intégration tournent sur une vraie base PostgreSQL, et quelques parcours Playwright s’exécutent sur le build de production, dont un audit axe de chaque route publique.&lt;/li&gt;
&lt;li&gt;Le taux de couverture ne sert pas d’objectif&amp;nbsp;; un test vaut par le comportement qu’il protège.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Sur un projet React ou Next.js, la vraie question porte sur ce qu’il faut tester, avec quel outil et jusqu’où aller. Je n’y réponds pas de la même façon sur ce portfolio, qui n’a pas de backend, sur &lt;a href="https://jordan-philippot.fr/projets/les-chemins-de-la-maison" rel="noopener noreferrer"&gt;Les Chemins de la Maison&lt;/a&gt;, un site vitrine avec un blog, et sur &lt;a href="https://jordan-philippot.fr/projets/payload-boilerplate" rel="noopener noreferrer"&gt;mon socle Next.js × Payload&lt;/a&gt;, qui embarque une base de données, un back-office et des comptes d’administration avec des rôles. Les exemples qui suivent viennent de leurs dépôts.&lt;/p&gt;

&lt;h2&gt;
  
  
  Pourquoi la répartition dépend-elle du projet&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Un test automatisé sert d’abord à détecter une régression avant la production, puis à refactoriser avec confiance. Le taux de couverture mesure le code exécuté et ne dit rien de la pertinence des assertions. Je ne lui fixe donc pas d’objectif chiffré, et un test qui ne protège aucun comportement réel n’est pas ajouté pour la métrique.&lt;/p&gt;

&lt;p&gt;Les niveaux de tests n’ont pas le même coût. Un test unitaire vérifie une fonction en quelques millisecondes, un test de composant rend une interface dans un DOM simulé, un test d’intégration fait travailler plusieurs briques ensemble, souvent avec une base de données, et un test de bout en bout pilote un vrai navigateur sur l’application complète. Je mets l’essentiel de l’effort sur les niveaux rapides et ne monte que lorsque le risque se trouve plus haut, ce qui donne des répartitions très différentes d’un projet à l’autre&amp;nbsp;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;ce portfolio, plus de 500 tests Vitest, tous sur de la logique pure ou du contenu&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;Les Chemins de la Maison, près de 190 tests Vitest, sur le listing du blog, les métadonnées, les tarifs et l’intégrité des articles&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;le socle Payload, plus d’une centaine de fichiers de tests unitaires et de composants, 55 fichiers de tests d’intégration et 7 parcours Playwright.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;En équipe, le dosage suit aussi les habitudes du projet. Sur la refonte d’un back-office chez &lt;a href="https://jordan-philippot.fr/projets/meilleurtaux-assurances" rel="noopener noreferrer"&gt;Meilleurtaux Assurances&lt;/a&gt;, les tests unitaires avec React Testing Library faisaient partie du quotidien.&lt;/p&gt;

&lt;h2&gt;
  
  
  Que tester sur un site sans backend&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Sur ce portfolio, le contenu (projets, articles, compétences) est typé dans des fichiers TypeScript et les pages en dérivent. Ce qui peut casser, c’est la logique qui transforme ces données, comme les builders JSON-LD, le flux RSS ou la validation du formulaire de contact, et le contenu lui-même. Une partie des tests vérifie donc des règles éditoriales, par exemple les espaces insécables avant la ponctuation, l’unicité des textes alternatifs ou les liens entre articles&amp;nbsp;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// tests/unit/data/blogData.content.spec.ts (simplified)&lt;/span&gt;
&lt;span class="n"&gt;it&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;each&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;blogPosts&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;as&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
  &lt;span class="s1"&gt;'%s is linked from at least two other pages'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;_slug&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;post&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;fromProjects&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;projects&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;project&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;getPostsForProject&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;project&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;post&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;fromArticles&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;blogPosts&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;other&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;other&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="n"&gt;post&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nf"&gt;getRelatedPosts&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;other&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;includes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;post&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;length&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;fromProjects&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;fromArticles&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toBeGreaterThanOrEqual&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Ce test échoue dès qu’un nouvel article n’est relié à aucune autre page. Il tient en quelques lignes et protège chaque ajout de contenu, là où une relecture pourrait passer à côté. Les Chemins de la Maison suit la même logique, notamment sur la pagination et les filtres du blog, rendus côté serveur à partir de l’URL, et sur les tarifs, qui alimentent à la fois les pages et les données structurées.&lt;/p&gt;

&lt;p&gt;Aucun des deux sites n’a de tests de composants ni de parcours Playwright. Leurs composants sont surtout visuels, et le typage strict, le build de production et la vérification à l’écran suffisent pour l’instant. Les règles de test du portfolio excluent d’ailleurs les tests de rendu purement visuels, comme les détails d’implémentation (état interne, structure exacte du DOM) qu’un refactoring changerait sans rien casser.&lt;/p&gt;

&lt;p&gt;Sur ce portfolio comme sur le socle, la logique nouvelle ou corrigée s’écrit en TDD, avec le test d’abord, vu en échec, puis le code minimal qui le fait passer. Un bug corrigé laisse ainsi derrière lui un test qui échouait avant la correction. &lt;a href="https://jordan-philippot.fr/blog/claude-code-au-quotidien" rel="noopener noreferrer"&gt;L’article sur Claude Code&lt;/a&gt; montre comment ce cycle s’intègre à mon workflow.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quand passer aux tests de composants et d’intégration&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Le socle Payload change d’échelle. Ses blocs de page builder et ses formulaires sont de vrais composants à comportement, testés avec React Testing Library dans un DOM simulé (jsdom). Les tests les retrouvent par leur rôle ou leur libellé, comme le ferait un utilisateur, ce qui vérifie au passage qu’un champ a bien un nom accessible.&lt;/p&gt;

&lt;p&gt;Une grande partie du risque se trouve pourtant côté données, avec les droits d’accès de chaque collection, la redirection créée quand un slug change, la purge des données expirées ou le rate limiting. Ces règles passent par Payload et PostgreSQL, et les simuler reviendrait à tester le mock plutôt que le comportement. Les tests d’intégration tournent donc sur une vraie base, via la Local API de Payload&amp;nbsp;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// tests/int/redirectOnSlugChange.int.spec.ts (simplified)&lt;/span&gt;
&lt;span class="nf"&gt;it&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'follows successive renames without a redirect chain'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;page&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;createPage&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`v1-${RUN}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;payload&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;update&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;collection&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'pages'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sb"&gt;`v2-${RUN}`&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;payload&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;update&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;collection&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'pages'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sb"&gt;`v3-${RUN}`&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;first&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;redirectFrom&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`/v1-${RUN}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;first&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nf"&gt;resolveRedirectDestination&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;first&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toBe&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`/v3-${RUN}`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Les Server Components asynchrones posent une limite à ce niveau. La documentation de Next.js indique que certains outils ne les prennent pas encore entièrement en charge et recommande pour eux les tests de bout en bout. Dans le socle, une bonne partie de la logique qu’ils appellent est extraite dans des fonctions testées en intégration, et leur rendu est couvert par Playwright.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quels parcours confier à Playwright&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Les tests de bout en bout coûtent le plus cher à écrire et à maintenir, et le socle n’en compte que sept. Ils couvrent les parcours dont une régression bloquerait un visiteur ou un administrateur, comme la page d’accueil, la connexion avec un code reçu par e-mail, le mot de passe oublié, l’administration, le blog et les pages créées dans le CMS. Le septième vérifie l’accessibilité de chaque route publique avec axe et échoue sur toute violation sérieuse ou critique des WCAG A et AA. Il s’assure d’abord que la page existe, sans quoi axe auditerait la page 404 et passerait sans rien contrôler&amp;nbsp;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// tests/e2e/accessibility.e2e.spec.ts (simplified)&lt;/span&gt;
&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;auditPage&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;Page&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;path&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;response&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;goto&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;path&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sb"&gt;`${path} must exist`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toBe&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;results&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;AxeBuilder&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;page&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;withTags&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'wcag2a'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'wcag2aa'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'wcag21a'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'wcag21aa'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;analyze&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;seriousOrCritical&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;results&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;violations&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;filter&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;violation&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;violation&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;impact&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'serious'&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;violation&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;impact&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'critical'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;seriousOrCritical&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;toEqual&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;En CI, ces parcours tournent sur le build de production plutôt que sur le serveur de développement, car certains bugs n’existent que dans le code assemblé pour la production. C’est sur ce build qu’est apparu un code d’erreur de la connexion par e-mail que pnpm dev ne montrait pas. Un audit axe reste par ailleurs un complément. Il repère une partie des problèmes d’accessibilité et ne remplace pas une vérification manuelle au clavier et au lecteur d’écran.&lt;/p&gt;

&lt;h2&gt;
  
  
  Dans quel ordre la CI lance-t-elle tout ça&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;La CI du socle va du plus rapide au plus coûteux, pour échouer le plus tôt possible&amp;nbsp;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;typage et lint, puis audit des dépendances&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;tests unitaires et d’intégration, sur une base PostgreSQL dédiée&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;build de production&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;parcours Playwright sur ce build, après un seed du contenu de base&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;smoke test des images Docker avant leur publication, qui lance la configuration de production réelle sur ces images pour vérifier ce que les autres étapes ne voient pas.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Une vérification qui échoue bloque la suite, et un test instable se corrige au lieu d’être relancé jusqu’au vert. À force de relances, plus personne ne croit aux échecs, et le filet perd sa valeur.&lt;/p&gt;

&lt;p&gt;D’un projet à l’autre, je me pose la même question, à savoir ce qui peut casser et quel test le verrait au moindre coût. Sur ce portfolio, la réponse tient dans Vitest et des tests de contenu&amp;nbsp;; sur le socle Payload, elle passe par une vraie base et un navigateur. Le portfolio n’a pas encore de test de composant, et le menu mobile ou le formulaire de contact en seraient les premiers candidats.&lt;/p&gt;

&lt;p&gt;Pour en discuter, &lt;a href="https://jordan-philippot.fr/contact" rel="noopener noreferrer"&gt;écrivez-moi&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sources
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://nextjs.org/docs/app/guides/testing" rel="noopener noreferrer"&gt;Next.js — tests (Server Components asynchrones)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://testing-library.com/docs/guiding-principles" rel="noopener noreferrer"&gt;Testing Library — principes directeurs&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://vitest.dev/guide/" rel="noopener noreferrer"&gt;Vitest — guide&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://playwright.dev/docs/accessibility-testing" rel="noopener noreferrer"&gt;Playwright — tests d’accessibilité&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Publié à l’origine sur &lt;a href="https://jordan-philippot.fr/blog/strategie-de-tests-react" rel="noopener noreferrer"&gt;jordan-philippot.fr&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>react</category>
      <category>nextjs</category>
      <category>vitest</category>
      <category>tdd</category>
    </item>
    <item>
      <title>GSAP avec React et Next.js : de la SPA à l’App Router</title>
      <dc:creator>Jordan Philippot</dc:creator>
      <pubDate>Sun, 08 Nov 2026 16:50:29 +0000</pubDate>
      <link>https://dev.to/jordanphilippot/gsap-avec-react-et-nextjs-de-la-spa-a-lapp-router-le</link>
      <guid>https://dev.to/jordanphilippot/gsap-avec-react-et-nextjs-de-la-spa-a-lapp-router-le</guid>
      <description>&lt;p&gt;&lt;strong&gt;En bref&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Dans l’App Router, le contenu reste dans un Server Component et seul un petit Client Component, qui reçoit ce contenu en children, lance les animations.&lt;/li&gt;
&lt;li&gt;gsap.matchMedia(), apparu avec GSAP 3.11, regroupe le nettoyage des animations et la condition prefers-reduced-motion. Avec le mouvement réduit, rien ne démarre et le contenu reste affiché.&lt;/li&gt;
&lt;li&gt;Animer le premier écran avec GSAP le fait clignoter&amp;nbsp;: le HTML l’affiche, puis le JavaScript le masque pour le révéler. Sur ce portfolio comme sur Les Chemins de la Maison, il est donc animé en CSS, et GSAP se charge de ce qui apparaît au scroll.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;GSAP est présent sur la plupart des projets React et Next.js sur lesquels j’ai travaillé. Sur &lt;a href="https://jordan-philippot.fr/projets/ted" rel="noopener noreferrer"&gt;TED&lt;/a&gt; et &lt;a href="https://jordan-philippot.fr/projets/aliz" rel="noopener noreferrer"&gt;Aliz&lt;/a&gt;, deux applications React rendues entièrement dans le navigateur, nous l’utilisions pour animer le site vitrine de l’une et les landing pages de l’autre. Je l’utilise aujourd’hui sur ce portfolio et sur &lt;a href="https://jordan-philippot.fr/projets/les-chemins-de-la-maison" rel="noopener noreferrer"&gt;Les Chemins de la Maison&lt;/a&gt;, deux sites construits avec l’App Router de Next.js, où le rendu côté serveur change la façon de l’intégrer.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quand GSAP plutôt que CSS&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Pour un changement d’état ou un survol, une transition CSS suffit et n’ajoute pas de JavaScript. GSAP devient utile quand il faut enchaîner plusieurs animations dans une timeline, les lier au scroll avec ScrollTrigger ou suivre une valeur continue comme la position du pointeur.&lt;/p&gt;

&lt;p&gt;La frontière ne se place pas toujours là où on l’attend. Sur ce portfolio comme sur Les Chemins de la Maison, même l’entrée du premier écran est écrite en CSS, avec des keyframes sur l’opacité et le transform, pour qu’elle démarre sans attendre le JavaScript. GSAP ne prend le relais qu’ensuite, notamment pour les éléments qui apparaissent au scroll.&lt;/p&gt;

&lt;h2&gt;
  
  
  Qu’est-ce qui change entre une SPA React et l’App Router&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Sur TED, nous avions regroupé les animations dans des helpers partagés, comme revealText, qui fait glisser un texte en fondu, ou revealImage, qui retire un overlay posé sur une image. Tout le rendu se faisait dans le navigateur, et chaque composant appelait ces fonctions sur ses propres éléments.&lt;/p&gt;

&lt;p&gt;Dans l’App Router, les composants sont des Server Components par défaut, alors que GSAP, qui manipule le DOM, demande un Client Component. Mettre «&amp;nbsp;use client&amp;nbsp;» sur toute une section ferait passer tout son contenu côté client. Je garde donc la frontière la plus basse possible&amp;nbsp;: la section reste un Server Component, et un petit composant client, RevealSection, reçoit son contenu en children pour l’animer.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// About.tsx (simplified): a Server Component. Only RevealSection runs in the browser.&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;revealSteps&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;RevealStep&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'header-item'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;opacity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;y&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;28&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.65&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stagger&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.1&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'card'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;opacity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;y&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;40&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stagger&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.14&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;position&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'-=0.3'&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'stack'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;opacity&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;y&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;24&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;duration&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mf"&gt;0.6&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;position&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'-=0.2'&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nc"&gt;About&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;RevealSection&lt;/span&gt; &lt;span class="n"&gt;steps&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;revealSteps&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"about"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;h2&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;gsap&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"header-item"&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;…&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;h2&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
      &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="cm"&gt;/* … */&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="nc"&gt;RevealSection&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Les étapes passent d’un Server Component à un Client Component, et doivent donc être sérialisables. RevealSection n’accepte qu’un sous-ensemble des propriétés de GSAP (opacity, x, y, duration, stagger, ease), sans fonction de rappel. Elles sont aussi déclarées au niveau du module, car un tableau recréé à chaque rendu relancerait l’animation. Les Chemins de la Maison suit le même principe avec RevealGrid, qui anime les cartes d’une grille rendue côté serveur.&lt;/p&gt;

&lt;h2&gt;
  
  
  Comment nettoyer les animations et respecter le mouvement réduit&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;En développement, le Strict Mode de React monte, démonte puis remonte les composants, et un effet qui ne nettoie pas ses animations peut alors lancer deux fois la même. Depuis la version 3.11, plus récente que celle de TED, GSAP fournit gsap.context() et gsap.matchMedia(), qui enregistrent les animations créées dans leur callback pour les annuler toutes d’un seul revert().&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// Simplified example&lt;/span&gt;
&lt;span class="nf"&gt;useEffect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;mm&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;gsap&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;matchMedia&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

  &lt;span class="n"&gt;mm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;add&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'(prefers-reduced-motion: no-preference)'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;section&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;sectionRef&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;current&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="c1"&gt;// Already on screen at hydration: hiding it to replay the reveal would flash.&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="n"&gt;section&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;section&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;getBoundingClientRect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;top&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="nb"&gt;window&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;innerHeight&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;tl&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;gsap&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;timeline&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;scrollTrigger&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;trigger&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;section&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;start&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'top 78%'&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="n"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;forEach&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;target&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;position&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;tl&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`[data-gsap="${target}"]`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;from&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;position&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sectionRef&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// selectors only match inside this section&lt;/span&gt;

  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;mm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;revert&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;steps&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La condition passée à mm.add() sert aussi à respecter prefers-reduced-motion, le réglage par lequel certaines personnes demandent à leur système moins d’animations, parce que certains mouvements peuvent provoquer des vertiges ou gêner la lecture. Avec ce réglage, aucune animation n’est créée, et le contenu, déjà à sa place dans le HTML, reste simplement affiché&amp;nbsp;: la frise du parcours apparaît entièrement dessinée, avec toutes ses étapes. La même mécanique accepte d’autres conditions. L’effet qui suit le pointeur dans le Hero n’est ainsi créé qu’avec (pointer: fine) and (min-width: 1024px), c’est-à-dire sur un écran large utilisé avec une souris ou un pavé tactile.&lt;/p&gt;

&lt;p&gt;Le hook useGSAP de @gsap/react assure le même nettoyage avec gsap.context(), mais matchMedia garde ici ces conditions au même endroit que les animations. &lt;a href="https://jordan-philippot.fr/blog/accessibilite-web-bases" rel="noopener noreferrer"&gt;L’article sur l’accessibilité&lt;/a&gt; montre le même réglage appliqué à une vidéo d’accueil et aux animations Framer Motion.&lt;/p&gt;

&lt;h2&gt;
  
  
  Comment animer sans retarder le premier affichage&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Les deux sites ne chargent pas GSAP au même moment. Sur Les Chemins de la Maison, la librairie n’est importée qu’après le premier affichage, ce qui retire environ 44 Ko compressés du JavaScript initial de chaque page, comme le détaille &lt;a href="https://jordan-philippot.fr/blog/site-vitrine-plusieurs-publics" rel="noopener noreferrer"&gt;l’article sur ce site vitrine&lt;/a&gt;. C’est possible parce que son premier écran est animé en CSS.&lt;/p&gt;

&lt;p&gt;Sur ce portfolio, le Hero s’animait d’abord avec GSAP, lancé au chargement. Le HTML rendu côté serveur affichait pourtant déjà son contenu&amp;nbsp;: à l’arrivée du JavaScript, gsap.from() le replaçait à son état de départ, opacité à zéro, avant de le révéler. Le contenu apparaissait, disparaissait puis revenait. Ce flash se voyait d’autant plus que le JavaScript arrivait tard, comme lors d’une première visite depuis un résultat de recherche. Le Hero s’anime désormais en keyframes CSS, avec les mêmes durées et des courbes équivalentes. L’animation démarre ainsi au premier affichage, sans dépendre du JavaScript. GSAP reste importé directement, car l’effet qui suit le pointeur dans le Hero s’en sert dès le chargement.&lt;/p&gt;

&lt;p&gt;Dans les deux cas, le contenu occupe sa place dès le HTML et l’animation ne touche qu’à son apparence, avec transform et opacity, ce qui évite les décalages de mise en page. La frise de ce portfolio se dessine ainsi avec un scaleY plutôt qu’en animant sa hauteur. Sur Les Chemins de la Maison, un élément déjà visible au moment où GSAP arrive n’est jamais masqué pour être révélé ensuite, et l’image principale de la page n’apparaît jamais en fondu. Ce portfolio applique la même idée à l’échelle d’une section entière. Une section déjà à l’écran quand GSAP arrive, parce que la page s’ouvre sur une ancre ou que le navigateur restaure le scroll, reste affichée sans animation.&lt;/p&gt;

&lt;p&gt;PageSpeed donne à ce portfolio 100 dans les quatre catégories, sur mobile comme sur desktop, mesuré le 11 novembre. Les Chemins de la Maison obtient 100 sur desktop et 94 sur mobile, mesurés le 15 octobre. GSAP ajoute du JavaScript, et ces scores montrent seulement que son usage n’empêche pas les pages de s’afficher vite.&lt;/p&gt;

&lt;p&gt;Entre les applications React de TED ou d’Aliz et l’App Router, GSAP sert toujours aux mêmes animations, mais sa place dans le code a changé. Le contenu reste rendu côté serveur, un petit composant client l’anime, et gsap.matchMedia() regroupe le nettoyage et le mouvement réduit. Le premier écran, lui, s’anime en CSS, et le moment où charger la librairie dépend de ce qui reste à animer.&lt;/p&gt;

&lt;p&gt;Pour voir le résultat, parcourez &lt;a href="https://jordan-philippot.fr/" rel="noopener noreferrer"&gt;l’accueil de ce site&lt;/a&gt;&amp;nbsp;; pour en discuter, &lt;a href="https://jordan-philippot.fr/contact" rel="noopener noreferrer"&gt;écrivez-moi&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sources
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://gsap.com/resources/React/" rel="noopener noreferrer"&gt;GSAP — utiliser GSAP avec React (useGSAP)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://gsap.com/docs/v3/GSAP/gsap.matchMedia()" rel="noopener noreferrer"&gt;GSAP — gsap.matchMedia()&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developer.mozilla.org/fr/docs/Web/CSS/Reference/At-rules/@media/prefers-reduced-motion" rel="noopener noreferrer"&gt;MDN — prefers-reduced-motion&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Publié à l’origine sur &lt;a href="https://jordan-philippot.fr/blog/gsap-react-nextjs" rel="noopener noreferrer"&gt;jordan-philippot.fr&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>gsap</category>
      <category>react</category>
      <category>nextjs</category>
      <category>animation</category>
    </item>
    <item>
      <title>SEO technique Next.js : métadonnées, sitemap, JSON-LD et indexation</title>
      <dc:creator>Jordan Philippot</dc:creator>
      <pubDate>Thu, 29 Oct 2026 10:28:46 +0000</pubDate>
      <link>https://dev.to/jordanphilippot/seo-technique-nextjs-metadonnees-sitemap-json-ld-et-indexation-ebc</link>
      <guid>https://dev.to/jordanphilippot/seo-technique-nextjs-metadonnees-sitemap-json-ld-et-indexation-ebc</guid>
      <description>&lt;p&gt;&lt;strong&gt;En bref&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Avec l’App Router, chaque page déclare son titre, sa description et sa canonical via l’API Metadata&amp;nbsp;; next/head appartient à l’ancien Pages Router et n’est pas le mécanisme à utiliser ici.&lt;/li&gt;
&lt;li&gt;Sur ce portfolio et sur Les Chemins de la Maison, le sitemap, le robots.txt et les données structurées se génèrent depuis les mêmes données que les pages, et la date lastModified ne change qu’après une vraie mise à jour.&lt;/li&gt;
&lt;li&gt;Une URL qui change passe par une redirection permanente. Dans next.config, permanent: true renvoie un code 308, que Google traite comme un 301.&lt;/li&gt;
&lt;li&gt;Une page «&amp;nbsp;Détectée&amp;nbsp;» attend d’être explorée, une page «&amp;nbsp;Explorée&amp;nbsp;» a été lue puis écartée. La première demande d’abord des liens internes, la seconde un contenu plus utile, une fois que Google a relu sa dernière version.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Les exemples de cet article viennent de deux sites que j’ai développés avec l’App Router de Next.js&amp;nbsp;: ce portfolio, en Next.js 16, et &lt;a href="https://jordan-philippot.fr/projets/les-chemins-de-la-maison" rel="noopener noreferrer"&gt;Les Chemins de la Maison&lt;/a&gt;, en Next.js 15, le site d’une praticienne qui publie des articles sur des sujets de santé et d’enfance. S’y ajoute &lt;a href="https://jordan-philippot.fr/projets/cora" rel="noopener noreferrer"&gt;l’e-commerce Cora&lt;/a&gt;, en Next.js 14, un site bilingue dont nous avons mené la refonte en équipe. Next.js fournit l’essentiel des outils pour les métadonnées, le sitemap et les images de partage. La Search Console rappelle pourtant assez vite qu’une page bien balisée n’est pas indexée pour autant, et c’est souvent là que le travail continue.&lt;/p&gt;

&lt;h2&gt;
  
  
  Que reçoit Google d’un site Next.js&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Google peut exécuter le JavaScript, mais cela ne dispense pas de fournir un HTML exploitable dès le départ. Avec l’App Router, une page peut être rendue côté serveur ou générée au build, de sorte que son contenu, ses métadonnées et ses données structurées figurent dans le HTML initial.&lt;/p&gt;

&lt;p&gt;Les trois projets n’ont pas fait le même choix. Toutes les pages de ce portfolio sont pré-rendues au build, celles des articles et des projets grâce à generateStaticParams, car son contenu ne change qu’au déploiement. Sur Les Chemins de la Maison, les articles sont pré-rendus au build grâce à generateStaticParams, tandis que la liste du blog est rendue à chaque requête, puisqu’elle dépend des filtres et de la pagination passés dans l’URL. Cora illustre un troisième cas. Presque tout y dépend du magasin choisi, mémorisé dans un cookie, et nous avons donc retenu le rendu côté serveur à chaque requête, comme le raconte &lt;a href="https://jordan-philippot.fr/blog/developpement-ecommerce" rel="noopener noreferrer"&gt;l’article sur la refonte de Cora&lt;/a&gt;. Le mode de rendu se choisit page par page, et &lt;a href="https://jordan-philippot.fr/blog/ssr-isr-ou-statique-nextjs" rel="noopener noreferrer"&gt;le guide SSR, ISR ou statique&lt;/a&gt; détaille ces arbitrages.&lt;/p&gt;

&lt;h2&gt;
  
  
  Des métadonnées propres à chaque page
&lt;/h2&gt;

&lt;p&gt;Dans l’App Router, les métadonnées passent par l’objet metadata ou la fonction generateMetadata, exportés depuis un layout ou une page. Sur ce portfolio, le layout racine fixe les valeurs communes, dont metadataBase pour que les URL relatives soient résolues en URL absolues, et un modèle de titre qui ajoute le nom du site à chaque page&amp;nbsp;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// app/layout.tsx (simplified)&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;metadata&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;Metadata&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="na"&gt;metadataBase&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;URL&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;SEO_CONFIG&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;baseUrl&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
  &lt;span class="na"&gt;title&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="na"&gt;default&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;HOME_TITLE&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="na"&gt;template&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;`%s — &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;SEO_CONFIG&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="na"&gt;description&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;HOME_DESCRIPTION&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;};&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Une page à segment dynamique, comme /blog/[slug], calcule ensuite ses propres métadonnées à partir de ses données. Depuis Next.js 15, params est une Promise qu’il faut attendre&amp;nbsp;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// app/blog/[slug]/page.tsx (simplified)&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;generateMetadata&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;&lt;span class="nx"&gt;params&lt;/span&gt;&lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="nx"&gt;Props&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt; &lt;span class="nb"&gt;Promise&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nx"&gt;Metadata&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nx"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nx"&gt;params&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;post&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;getBlogPost&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;
  &lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{};&lt;/span&gt;

  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;SEO_CONFIG&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;baseUrl&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;/blog/&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;title&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;pageTitle&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;title&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
    &lt;span class="na"&gt;description&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;metaDescription&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;alternates&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="na"&gt;canonical&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;url&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;};&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Sur Les Chemins de la Maison, un helper unique construit l’objet metadata de chaque page à partir de son titre, de sa description et de son chemin. La canonical, l’URL Open Graph et l’image de partage en dérivent, si bien qu’une page qui passe par lui ne peut pas les oublier. Ce type de base partagée compte d’autant plus que Next.js fusionne les métadonnées de façon superficielle. Un objet imbriqué comme openGraph ou alternates, redéclaré plus bas dans l’arbre des routes, remplace celui du parent au lieu de le compléter.&lt;/p&gt;

&lt;p&gt;Cora est bilingue (FR / NL)&amp;nbsp;: la fonction generateMetadata de son layout racine choisit le titre et la description selon la langue du visiteur («&amp;nbsp;L’hypermarché&amp;nbsp;» ou «&amp;nbsp;Hypermarkt&amp;nbsp;»), et l’attribut lang de la balise html suit la même valeur.&lt;/p&gt;

&lt;p&gt;La canonical indique à Google l’URL que je considère comme principale lorsqu’une même ressource est accessible par plusieurs adresses. Google la traite comme une indication forte, qu’il reste libre de ne pas suivre. Pour les titres et les descriptions, il n’existe pas de longueur maximale garantissant un affichage complet dans Google, qui dépend de la largeur disponible et de la requête. Sur ce portfolio, le helper pageTitle retire le suffixe «&amp;nbsp;— Jordan Philippot&amp;nbsp;» quand le titre complet dépasserait 60 caractères, et chaque page garde des textes qui lui sont propres, car des métadonnées trop proches d’une page à l’autre rendent le contenu moins distinctif et peuvent conduire Google à générer ses propres titres ou extraits. La balise meta keywords, elle, n’a aucun effet sur Google et n’a donc pas sa place dans ce portfolio.&lt;/p&gt;

&lt;p&gt;Toutes ces URL reposent sur l’adresse de base du site. Mal renseignée en production, elle fausserait d’un coup les canonicals, le sitemap, le JSON-LD et les images de partage. Sur ce portfolio et sur Les Chemins de la Maison, elle est donc déclarée à un seul endroit, et le portfolio la lit avec une valeur de repli explicite.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sitemap et robots générés depuis les données
&lt;/h2&gt;

&lt;p&gt;Les fichiers sitemap.ts et robots.ts de l’App Router produisent sitemap.xml et robots.txt depuis le code. Le sitemap est construit à partir des mêmes données que les pages, un nouvel article y apparaît donc automatiquement, et sa valeur lastModified reprend la date de mise à jour de l’article, ou à défaut sa date de publication&amp;nbsp;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// app/sitemap.ts (simplified)&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;sitemap&lt;/span&gt;&lt;span class="p"&gt;():&lt;/span&gt; &lt;span class="nx"&gt;MetadataRoute&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;Sitemap&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;blogRoutes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;blogPosts&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;({&lt;/span&gt;
    &lt;span class="na"&gt;url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;BASE_URL&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;/blog/&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;slug&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;lastModified&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nf"&gt;getLastModified&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;post&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="c1"&gt;// update date, else publication date&lt;/span&gt;
  &lt;span class="p"&gt;}));&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[...&lt;/span&gt;&lt;span class="nx"&gt;staticRoutes&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nx"&gt;blogRoutes&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="nx"&gt;projectRoutes&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Les Chemins de la Maison suit le même principe avec ses articles. Une date lastModified ne sert que si elle correspond à une modification réelle de la page. Une valeur recalculée à chaque build annonce un changement qui n’a pas eu lieu et n’aide pas Google à repérer les pages qui ont vraiment évolué. Sur ces deux sites, le robots.txt autorise les pages publiques et donne l’adresse du sitemap.&lt;/p&gt;

&lt;p&gt;Le sitemap de Cora est construit autrement. Il parcourt l’arborescence de src/app et y ajoute les pages créées dans le CMS Prismic, en écartant les pages privées comme le compte, le panier ou les listes. Une page statique ajoutée dans le code, ou une page créée dans le CMS, y apparaît donc sans intervention.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quelles données structurées pour quel site&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Les données structurées décrivent le contenu d’une page dans le vocabulaire de Schema.org, généralement au format JSON-LD. Elles aident les moteurs à comprendre une personne, un article ou un fil d’Ariane, et certains types peuvent donner lieu à des résultats enrichis lorsqu’ils sont pris en charge et correctement implémentés. Ce portfolio présente une personne et son travail. Chaque type sort d’un builder unique dans lib/seo.ts&amp;nbsp;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;WebSite sur toutes les pages, pour identifier le site&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;Person et ProfilePage sur l’accueil, avec le nom, le métier, la localité, les profils LinkedIn et GitHub, et la photo de profil déclarée comme image principale de la page&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;BlogPosting sur chaque article, avec ses dates, son auteur, son image et les sources affichées en fin d’article, reprises en citation&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;CreativeWork sur chaque projet&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;BreadcrumbList sur les articles et les projets, pour le fil d’Ariane.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Les Chemins de la Maison décrit plutôt une activité. Chaque page de service porte un objet Service, chaque article un Article, et la page des tarifs une liste des services avec leur Offer. Ces tarifs viennent du même fichier que les prix affichés sur les pages, ce qui évite qu’un montant diffère entre le texte et le JSON-LD&amp;nbsp;; seuls les montants uniques y figurent, les fourchettes de prix restant hors du balisage.&lt;/p&gt;

&lt;p&gt;Les pages de service portent aussi un FAQPage pour leurs questions fréquentes. Depuis 2023, Google réservait les résultats enrichis FAQ aux sites gouvernementaux ou de santé reconnus, et il les a retirés de la recherche le 7 mai 2026. Le balisage reste valide au sens de Schema.org, mais il ne faut plus en attendre d’affichage particulier dans Google.&lt;/p&gt;

&lt;p&gt;Sur le portfolio comme sur Les Chemins de la Maison, le JSON-LD est inséré par une balise script dont le contenu échappe le caractère &amp;lt;, pour qu’un texte contenant une balise ne puisse pas refermer le script prématurément&amp;nbsp;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight tsx"&gt;&lt;code&gt;&lt;span class="c1"&gt;// components/JsonLd.tsx (simplified)&lt;/span&gt;
&lt;span class="k"&gt;export&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;JsonLd&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;}:&lt;/span&gt; &lt;span class="nx"&gt;JsonLdProps&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nt"&gt;script&lt;/span&gt;
      &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"application/ld+json"&lt;/span&gt;
      &lt;span class="na"&gt;dangerouslySetInnerHTML&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="na"&gt;__html&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;data&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="nf"&gt;replace&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sr"&gt;/&amp;lt;/g&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="se"&gt;\\&lt;/span&gt;&lt;span class="s1"&gt;u003c&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)}&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;/&amp;gt;&lt;/span&gt;
  &lt;span class="p"&gt;);&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Le Rich Results Test de Google vérifie les types qu’il prend en charge et signale les erreurs ou les propriétés manquantes. Pour un article, Google recommande des dates au format ISO 8601, avec le fuseau horaire quand l’heure de publication compte.&lt;/p&gt;

&lt;h2&gt;
  
  
  Comment changer d’URL sans perdre son référencement&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Une URL publiée finit par être connue de Google, partagée et parfois liée depuis d’autres sites. Quand elle doit changer, Google recommande une redirection permanente côté serveur, qu’il interprète comme un signal pour faire de la nouvelle adresse l’URL canonique. Dans Next.js, la clé redirects de next.config s’en charge. Avec permanent: true, elle renvoie un code 308, l’équivalent d’un 301 qui conserve la méthode de la requête, et Google traite les deux de la même façon.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// next.config.mjs (Les Chemins de la Maison, simplified)&lt;/span&gt;
&lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="nf"&gt;redirects&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="c1"&gt;// Slug shortened on 2026-10-09 (year removed).&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="na"&gt;source&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/blog/financer-formation-opco-uniformation-educateurs-2026&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;destination&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;/blog/financer-formation-opco-uniformation-educateurs&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="na"&gt;permanent&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;},&lt;/span&gt;
  &lt;span class="p"&gt;];&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;J’ai retiré l’année de ce slug le 9 octobre, et l’ancienne adresse redirige depuis vers la nouvelle. Dans la Search Console, elle apparaît encore en «&amp;nbsp;soft 404&amp;nbsp;», le statut que Google donne à une page qui répond normalement mais qu’il juge vide ou introuvable. Ce constat date de son dernier passage, fin juillet, donc d’avant la redirection, et il restera affiché tant que Google n’aura pas réexploré l’URL. La validation du motif, dans le rapport d’indexation, sert justement à le lui demander.&lt;/p&gt;

&lt;p&gt;Le soft 404 se prévient aussi dans le code. Dans Cora, une page éditoriale est cherchée dans le dépôt Prismic principal, puis dans celui du magasin&amp;nbsp;; si elle n’existe dans aucun des deux, notFound() renvoie une vraie 404, au lieu d’une page vide que Google pourrait classer en soft 404. Ce portfolio obtient le même résultat avec dynamicParams = false sur les routes des articles et des projets&amp;nbsp;: un slug absent des données renvoie une 404.&lt;/p&gt;

&lt;p&gt;Sur la refonte de Cora, le même mécanisme a servi à plus grande échelle, puisque nous avons déclaré 42 redirections permanentes des anciennes URL vers les nouvelles dans next.config. Une redirection permanente ne se pose toutefois que pour un changement définitif, car la documentation de Next.js rappelle que navigateurs et moteurs la mémorisent sans limite de durée.&lt;/p&gt;

&lt;h2&gt;
  
  
  Image de partage, RSS et llms.txt
&lt;/h2&gt;

&lt;p&gt;Quand une page est partagée sur LinkedIn ou dans une messagerie, l’aperçu utilise son image Open Graph. Ce portfolio générait d’abord des cartes au build avec un fichier opengraph-image.tsx et ImageResponse&amp;nbsp;: le titre de chaque article, dans les polices et les couleurs du site. Je les ai remplacées par ma photo, déclarée dans openGraph.images sur toutes les pages sauf les fiches projet, qui gardent la capture du projet. Google peut reprendre cette image comme vignette dans ses résultats et déconseille celles qui contiennent du texte&amp;nbsp;; sur l’accueil, og:image et primaryImageOfPage, les deux indications qu’il accepte pour l’image préférée, désignent la même photo. Les Chemins de la Maison suit la même logique, avec une illustration déclarée par chaque article et le portrait de la praticienne par défaut sur les autres pages.&lt;/p&gt;

&lt;p&gt;Si une route combine les deux mécanismes, le fichier opengraph-image est ignoré dès que l’objet openGraph contient une clé images, contrairement à ce que laisse entendre la documentation, qui donne la priorité aux fichiers. Je l’avais vérifié dans le code source de Next.js 16 (resolve-metadata.js) quand ce portfolio utilisait encore les cartes générées.&lt;/p&gt;

&lt;p&gt;Le portfolio publie aussi un flux RSS, construit au build par un route handler statique (dynamic = "force-static") et déclaré dans les métadonnées par alternates.types, ainsi qu’un llms.txt généré depuis les données des projets et des articles. Ce dernier suit une convention proposée pour donner aux assistants IA une version synthétique d’un site&amp;nbsp;; ce n’est pas un standard de Google, et rien ne garantit qu’un assistant le lise ou cite le site.&lt;/p&gt;

&lt;h2&gt;
  
  
  Pourquoi Google n’indexe-t-il pas une page&amp;nbsp;?
&lt;/h2&gt;

&lt;p&gt;Le rapport d’indexation de la Search Console classe les pages non indexées par motif, et deux d’entre eux reviennent sur ces sites. «&amp;nbsp;Détectée, actuellement non indexée&amp;nbsp;» signifie que Google connaît l’URL mais a reporté son exploration. «&amp;nbsp;Explorée, actuellement non indexée&amp;nbsp;» veut dire qu’il l’a lue sans la retenir pour le moment, et Google précise qu’il est inutile de redemander l’indexation d’une telle page sans l’avoir modifiée.&lt;/p&gt;

&lt;p&gt;Sur Les Chemins de la Maison, le nombre de pages indexées est passé de 21 à 40 le 10 octobre, au lendemain d’une révision du contenu des articles. Je ne peux pas attribuer toute la hausse à cette seule révision, mais le détail du rapport aide à choisir la suite. Les 8 articles encore «&amp;nbsp;Explorée&amp;nbsp;» avaient été lus en juin et en juillet, donc jugés sur leur ancienne version&amp;nbsp;: une demande d’indexation passe avant toute réécriture. Parmi les 14 pages «&amp;nbsp;Détectée&amp;nbsp;», jamais explorées, figurent la page des services et l’une des pages de service, pourtant présentes dans la navigation. Cela laisse penser que Google explore encore peu le site, et le travail porte d’abord sur le maillage interne.&lt;/p&gt;

&lt;p&gt;Ce portfolio montre un autre cas. Dans l’export Search Console du 15 octobre, 20 des 32 URL du sitemap étaient indexées, et six articles n’avaient pas encore été vus par Google&amp;nbsp;; ils avaient été mis en ligne à la fin de son dernier grand passage, du 1er au 3 octobre, ou après. L’article sur l’accessibilité, lui, avait été lu le 13 octobre puis écarté. Je l’ai repris en profondeur à partir d’audits réels, et &lt;a href="https://jordan-philippot.fr/blog/accessibilite-web-bases" rel="noopener noreferrer"&gt;sa nouvelle version&lt;/a&gt; attend maintenant le prochain passage de Google.&lt;/p&gt;

&lt;h2&gt;
  
  
  Que vérifier après la mise en ligne&amp;nbsp;?
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;la Search Console&amp;nbsp;: soumettre le sitemap, inspecter les pages nouvelles ou réécrites, puis suivre les motifs du rapport d’indexation&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;les anciennes URL, qui doivent répondre par une redirection permanente vers la nouvelle adresse&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;le Rich Results Test sur une page de chaque type comportant des données structurées&amp;nbsp;;&lt;/li&gt;
&lt;li&gt;le LinkedIn Post Inspector sur un article, pour vérifier l’image et les métadonnées de partage, et le W3C Feed Validator pour le flux RSS.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Viennent ensuite les mesures dans la durée, avec les pages indexées, les requêtes qui amènent des visites et les Core Web Vitals. Elles permettent de confronter les choix techniques aux résultats réels et de décider où concentrer les ajustements suivants.&lt;/p&gt;

&lt;p&gt;Sur ce portfolio et sur Les Chemins de la Maison, le SEO technique repose sur une seule source pour chaque information qui compte (URL de base, dates, et tarifs pour le second) et sur des fichiers générés depuis les mêmes données que les pages. Sur les trois projets, les URL qui changent passent par une redirection permanente. La Search Console compte ensuite autant que le code, car c’est elle qui dit si Google a lu la dernière version d’une page avant de la juger. Il me reste à suivre, dans les semaines qui viennent, les pages que Google n’a pas encore relues sur ce portfolio et sur Les Chemins de la Maison.&lt;/p&gt;

&lt;p&gt;Pour en discuter, &lt;a href="https://jordan-philippot.fr/contact" rel="noopener noreferrer"&gt;écrivez-moi&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sources
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;&lt;a href="https://nextjs.org/docs/app/api-reference/functions/generate-metadata" rel="noopener noreferrer"&gt;Next.js — generateMetadata et l’objet metadata&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://nextjs.org/docs/app/api-reference/config/next-config-js/redirects" rel="noopener noreferrer"&gt;Next.js — redirects (next.config.js)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developers.google.com/search/updates" rel="noopener noreferrer"&gt;Google Search Central — Mises à jour de la documentation (fin des résultats enrichis FAQ, mai 2026)&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://support.google.com/webmasters/answer/7440203?hl=fr" rel="noopener noreferrer"&gt;Aide Search Console — Rapport sur l’indexation des pages&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://developers.google.com/search/docs/appearance/google-images?hl=fr" rel="noopener noreferrer"&gt;Google Search Central — Bonnes pratiques pour le référencement des images&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Publié à l’origine sur &lt;a href="https://jordan-philippot.fr/blog/seo-technique-nextjs" rel="noopener noreferrer"&gt;jordan-philippot.fr&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>nextjs</category>
      <category>seo</category>
      <category>react</category>
      <category>webdev</category>
    </item>
  </channel>
</rss>
