Guide

Docusaurus, le générateur de documentation de Meta

Docusaurus génère un site de documentation à partir de Markdown et MDX : licence, version 3.10.2, recherche, versionnement, traductions et alternatives.

L'équipe CodeWorlds21 min de lecture ·

Pratique HTML et CSS dans des leçons interactives avec un éditeur de code.

Crée un compte gratuit→
Dans cet article9

Docusaurus construit un site de documentation statique à partir de fichiers Markdown et MDX, avec React comme couche de templates. La version actuelle de @docusaurus/core est la 3.10.2 du 10 juillet 2026, sous licence MIT. Il n'y a pas de moteur de recherche dans la boîte, et c'est la première décision à prendre avant le déploiement, pas après.

Ce qu'est Docusaurus et ce qu'il n'est pas

Docusaurus prend un dossier de fichiers Markdown et MDX, ajoute une barre de navigation, une barre latérale, un sélecteur de thème et une section blog, et génère du HTML statique à partir de tout cela. Tu déposes le résultat sur n'importe quel hébergeur statique, Netlify ou GitHub Pages par exemple. Aucun serveur d'application n'est nécessaire.

La couche de templates est React. Ce n'est pas un détail d'implémentation mais une conséquence que tu porteras. Le paquet 3.10.2 publié déclare des peerDependencies sur react en ^18.0.0 || ^19.0.0 et sur react-dom dans la même plage, et engines.node exige Node 20.0 ou plus récent. Chaque page que tu veux écrire en dehors de Markdown est un composant React dans src/pages. Chaque changement visuel qui dépasse les variables CSS passe par le swizzling, c'est-à-dire le remplacement d'un composant du thème par ta propre copie.

Ce que Docusaurus ne fait pas compte tout autant. Il n'y a pas de recherche côté serveur, car il n'y a pas de serveur. Il ne génère pas de documentation d'API à partir du code source, pour laquelle il te faut un plugin séparé ou un générateur qui produit des fichiers Markdown. Il ne gère pas les permissions, donc une documentation derrière une connexion est un problème d'hébergement, pas de générateur. Ce n'est pas non plus une bibliothèque de composants que tu montres aux designers, ce qui est le rôle de Storybook.

Il inclut en revanche trois choses que la concurrence n'a souvent pas dans son cœur : le versionnement de la documentation, les traductions et un blog. Ces trois éléments décident du moment où Docusaurus l'emporte.

Version, licence et rythme des versions

La licence est un cas d'école et la vérifier prend trois minutes. Le dépôt facebook/docusaurus a un fichier LICENSE sur la branche principale avec le texte MIT et l'en-tête « Copyright (c) Facebook, Inc. and its affiliates ». Il n'y a pas de LICENSE.md, donc il n'y a rien à deviner sur celui qui s'applique. Le champ license dans le registre npm pour @docusaurus/core indique MIT. L'archive décompressée core-3.10.2.tgz contient package/LICENSE avec le même texte MIT, à côté de 122 fichiers .js et d'environ 1,2 Mo de code réel. Trois sources, une seule réponse, aucun paquet factice. Les paquets associés se comportent de la même façon : @docusaurus/preset-classic, @docusaurus/theme-search-algolia, @docusaurus/faster et create-docusaurus sont tous en 3.10.2 sous MIT.

La question sur Docusaurus 4 demande une réponse précise, car de cela dépend le fait de démarrer un projet maintenant. Le registre npm n'a aucune version commençant par 4., sur aucun canal. Les dist-tags se présentent ainsi : latest est 3.10.2, next est 3.0.0-rc.1, alpha est 3.9.2-alpha.4, canary est 3.10.1-canary-6655 du 4 juin 2026. Le tag next a été laissé sur une release candidate de la version 3 et personne ne l'a déplacé depuis, donc npm install @docusaurus/core@next te donne une ancienne version plutôt qu'un aperçu de la v4.

La version 4 existe bien sous une autre forme, et déjà dans la 3.10.2 publiée. Le fichier lib/server/configValidation.js du paquet publié contient des drapeaux future.v4 avec quatre entrées : useCssCascadeLayers, siteStorageNamespacing, fasterByDefault et mdx1CompatDisabledByDefault. Tous valent false par défaut. C'est un mécanisme pour préparer un site à la prochaine version majeure sans l'attendre. La conclusion pratique : tu peux démarrer sur la version 3, mais active ces drapeaux tout de suite, car sinon la migration signifiera corriger quatre choses d'un coup au lieu d'une à la fois.

Le rythme des versions doit être vérifié, pas supposé. Les versions stables se sont enchaînées ainsi : la 3.9.2 est arrivée le 17 octobre 2025, la 3.10.0 seulement le 7 avril 2026, soit après presque six mois de silence, la 3.10.1 vingt-trois jours plus tard le 30 avril 2026, et la 3.10.2 le 10 juillet 2026. Aujourd'hui, 22 août 2026, six semaines se sont donc écoulées depuis la dernière version, ce qui, à ce rythme, est tout à fait dans la norme, puisque des intervalles de six mois se sont déjà produits. La branche principale est vivante : les derniers commits sur main datent du 21 août 2026, il y a un jour. Par ailleurs, on remarque que le canal canary s'est arrêté à un paquet du 4 juin 2026, donc la publication automatique des builds de développement ne tourne pas aussi régulièrement que l'activité du dépôt le laisserait penser.

Démarrer un projet et la forme de la config

Entrer dans un projet est rapide et ne demande aucune installation globale.

Bash
npx create-docusaurus@latest my-website classic --typescript
cd my-website
npm run start
npm run build
npm run serve

Le template classic contient @docusaurus/preset-classic, c'est-à-dire le plugin de docs, le plugin de blog, le plugin de pages et un thème qui gère le mode sombre. L'option --typescript bascule le template vers la variante TypeScript. Les scripts du package.json généré sont start, build, swizzle, deploy, clear, serve, write-translations et write-heading-ids, tous de fines enveloppes autour de la commande docusaurus.

Toute la configuration vit dans un seul docusaurus.config.js. La section à connaître dès le premier jour est future, car c'est là que se trouvent les drapeaux de vitesse de build et ceux de préparation à la version 4.

JSdocusaurus.config.js
// docusaurus.config.js
export default {
  future: {
    v4: {
      useCssCascadeLayers: true,
      siteStorageNamespacing: true,
      fasterByDefault: true,
      mdx1CompatDisabledByDefault: true,
    },
    faster: {
      swcJsLoader: true,
      swcJsMinimizer: true,
      swcHtmlMinimizer: true,
      lightningCssMinimizer: true,
      rspackBundler: true,
      rspackPersistentCache: true,
      mdxCrossCompilerCache: true,
      ssgWorkerThreads: true,
      gitEagerVcs: true,
    },
  },
};

Chacun de ces drapeaux a un sens concret : swcJsLoader remplace Babel par SWC, lightningCssMinimizer remplace cssnano et clean-css, rspackBundler remplace webpack par Rspack, rspackPersistentCache ajoute un cache persistant et exige de conserver le dossier ./node_modules/.cache entre les builds, ssgWorkerThreads répartit la génération du site statique sur un pool de threads, et gitEagerVcs lit tout le dépôt Git d'un coup au lieu de fichier par fichier, ce qui compte sur les gros dépôts. La section faster exige d'ajouter le paquet @docusaurus/faster à tes dépendances. Dans la version 3.10.2, tous ces drapeaux sont désactivés par défaut, sauf si tu actives future.v4.fasterByDefault.

La documentation contient aussi un avertissement facile à manquer : les fonctionnalités préfixées par experimental_ ou unstable_, comme experimental_router et experimental_vcs, peuvent changer dans les versions mineures et ne sont pas traitées comme des changements cassants au regard du versionnement sémantique.

La recherche, la surprise la plus fréquente

Docusaurus n'a pas de recherche intégrée. La documentation officielle liste quatre voies et indique ouvertement laquelle est prise en charge : Algolia DocSearch bénéficie d'un support de premier ordre de l'équipe Docusaurus, tandis que Typesense DocSearch, la recherche locale et ton propre composant SearchBar sont maintenus par la communauté, avec une demande de signaler les bugs dans leurs dépôts respectifs. Cette distinction a des conséquences pratiques dès que quelque chose casse après une mise à jour.

La voie officielle fonctionne ainsi. Algolia propose un programme DocSearch gratuit, mais il vise la documentation technique publique et les blogs techniques. La page d'éligibilité indique que les candidatures sont généralement refusées quand le site n'est pas prêt pour la production ou contient du contenu non technique. Tu postules via le tableau de bord d'Algolia, où tu soumets un domaine pour validation au regard des exigences du programme, et après l'approbation tu dois vérifier la propriété du domaine dans les sept jours, sinon le crawler cesse de fonctionner. Par défaut, le crawler visite le site une fois par semaine, et le calendrier peut être modifié dans l'interface.

Pour une documentation de produit commerciale, cela signifie quelque chose de concret : le programme gratuit n'est pas pour toi et tu paies les tarifs publics d'Algolia. Sur la page de tarifs, au 22 août 2026, l'offre Grow inclut 10 000 requêtes de recherche par mois et coûte 0,50 dollar par millier de requêtes supplémentaire, plus 100 000 enregistrements avec 0,40 dollar par millier d'enregistrements supplémentaire. L'offre Grow Plus a les mêmes seuils gratuits, mais le tarif de dépassement des requêtes de recherche est de 1,75 dollar par millier. Le crawler est facturé à part : la section des questions de la même page dit que Grow et Grow Plus incluent 10 000 crawls par mois, tandis que la ligne du tableau des produits indique « 10,000/mo then 0.80 dollars per additional 1K crawls/mo ». Sur cette même ligne, la source brute de la page contient aussi une valeur « 5,000 per month » dans une colonne dont le nom d'offre ne peut pas être lu sans exécuter les scripts de la page. Deux chiffres différents sur une seule ligne sont une raison de vérifier la limite dans le tableau de bord avant de signer quoi que ce soit, pas dans un article.

La configuration côté Docusaurus est courte, et chaque champ ci-dessous existe réellement.

JSdocusaurus.config.js
// docusaurus.config.js
export default {
  themeConfig: {
    algolia: {
      appId: 'YOUR_APP_ID',
      apiKey: 'YOUR_SEARCH_API_KEY',
      indexName: 'YOUR_INDEX_NAME',
      contextualSearch: true,
      externalUrlRegex: 'external\\.com|domain\\.com',
      replaceSearchResultPathname: {
        from: '/docs/',
        to: '/',
      },
      searchParameters: {},
      searchPagePath: 'search',
      insights: false,
    },
  },
};

Le champ apiKey est la clé de recherche publique et la documentation indique clairement qu'il est sûr de la committer. contextualSearch est activé par défaut et limite les résultats à la version de documentation et à la langue courantes, donc parcourir la version 2 ne te renvoie pas de doublons de la version 1. Les filtres contextuels sont fusionnés avec ce que tu passes dans searchParameters.facetFilters. Il existe aussi un champ plus récent askAi, qui accepte un identifiant d'assistant ou un objet avec assistantId, indexName, apiKey, appId et suggestedQuestions.

Un détail de version vaut la peine d'être vérifié avant une mise à jour. @docusaurus/theme-search-algolia en 3.10.2 déclare une dépendance @docsearch/react dans la plage ^3.9.0 || ^4.3.2, alors que le site DocSearch annonce déjà la 5.0.0 comme stable. Docusaurus ne prend pas en charge cette cinquième version aujourd'hui.

Si ta documentation est derrière un pare-feu ou ne remplit pas les conditions du programme gratuit, la documentation de Docusaurus renvoie à la page « run your own » du site DocSearch. Tu dois savoir où tu mets les pieds : cette page est marquée comme version historique, couvre DocSearch 1.x et 2.x, et sa date de dernière mise à jour est le 1er décembre 2021. Elle décrit l'exécution de l'image Docker algolia/docsearch-scraper, avec un ChromeDriver pour les pages qui demandent JavaScript. Ça fonctionne, mais ce n'est pas une voie maintenue.

L'alternative locale que les gens utilisent réellement aujourd'hui est un paquet de la communauté.

JSdocusaurus.config.js
// docusaurus.config.js
export default {
  themes: [
    [
      require.resolve('@easyops-cn/docusaurus-search-local'),
      {
        hashed: true,
        language: ['en', 'pl'],
        indexDocs: true,
        indexBlog: true,
        indexPages: false,
        docsRouteBasePath: '/docs',
        highlightSearchTermsOnTargetPage: true,
        explicitSearchResultPath: true,
        fuzzyMatchingDistance: 1,
      },
    ],
  ],
};

@easyops-cn/docusaurus-search-local est en 0.55.3 du 29 juillet 2026 sous MIT. L'index est produit au moment du build et téléchargé par le navigateur, donc il grossit avec la documentation, ce qui sur un grand nombre de pages donne un fichier volumineux à récupérer. L'option hashed ajoute un hash de contenu pour que l'index puisse être mis en cache longtemps. Il y a un piège de configuration récurrent : en mode docs seules, quand tu règles routeBasePath dans le preset sur /, tu dois régler docsRouteBasePath sur la même valeur, sinon l'index sortira vide. L'ancien paquet docusaurus-lunr-search est en 3.6.0 publié le 10 janvier 2025, soit plus d'un an et demi sans version, et je ne le choisirais pas pour un nouveau projet.

Le versionnement de la documentation et son coût

Le versionnement est le plus fort argument en faveur de Docusaurus et en même temps la fonctionnalité la plus coûteuse de l'ensemble. La commande docusaurus docs:version 1.1.0 fait trois choses : elle copie tout le contenu du dossier docs/ dans un nouveau dossier versioned_docs/version-1.1.0/, crée versioned_sidebars/version-1.1.0-sidebars.json à partir de la configuration actuelle de la barre latérale, et ajoute le numéro de version à versions.json.

Elle copie, elle ne crée pas de lien. Après avoir figé trois versions, tu as quatre jeux des mêmes fichiers dans le dépôt, et chaque correction de faute de frappe dans un paragraphe présent dans tous représente quatre modifications distinctes ou une décision délibérée de ne pas corriger les anciennes versions.

website
├── docs                         # the "current" version
│   └── hello.md                 # /docs/next/hello
├── versions.json                # ["1.1.0", "1.0.0"]
├── versioned_docs
│   ├── version-1.1.0
│   │   └── hello.md             # /docs/hello
│   └── version-1.0.0
│       └── hello.md             # /docs/1.0.0/hello
├── versioned_sidebars
│   ├── version-1.1.0-sidebars.json
│   └── version-1.0.0-sidebars.json
└── docusaurus.config.js

Ce que dit la documentation sur le temps de build mérite d'être rapporté sans enjolivement. La page sur le versionnement s'ouvre par un avertissement : réfléchis bien avant de commencer, car le versionnement peut compliquer l'aide des contributeurs. Elle poursuit en disant que, la plupart du temps, tu n'as pas besoin du versionnement, puisqu'il ne fera qu'augmenter ton temps de build et introduire de la complexité dans ta base de code, et qu'il convient aux sites à fort trafic dont la documentation change vite d'une version à l'autre. Sous l'option onlyIncludeVersions, un conseil recommande de se limiter à deux ou trois versions en développement et dans les aperçus de déploiement, précisément pour améliorer le temps de démarrage et de build.

Ce que la documentation ne donne pas, ce sont des chiffres. Il n'y a ni multiplicateur, ni graphique, ni mesure montrant de quel pourcentage le temps de build augmente par version. La relation est qualitative : plus de versions signifie plus de pages à générer, plus de fichiers à traiter et une exécution plus longue. Si tu as besoin d'un chiffre ferme pour ton propre dépôt, la seule voie honnête est de mesurer un build avec onlyIncludeVersions réglé sur une seule version et de le comparer à l'ensemble complet.

Les autres options du plugin de docs qui gouvernent ce comportement sont disableVersioning, includeCurrentVersion, lastVersion et le dictionnaire versions, où chaque version accepte label, path, un banner valant none, unreleased ou unmaintained, badge et className. Il existe aussi une astuce pour les projets qui ont livré la version 1 et ne prévoient pas de version 2 : au lieu de figer, tu règles lastVersion: 'current' et tu donnes à la version courante un label et un path, ce qui conserve un seul dossier docs/ tout en montrant un numéro de version au lecteur.

Traductions et construction de plusieurs langues

Les traductions fonctionnent sur des fichiers, pas via un service externe. Dans la configuration, tu déclares i18n.defaultLocale et la liste i18n.locales, puis tu traduis trois sortes de ressources. Les fichiers Markdown et MDX sont traduits en entier, sans découpage en phrases, donc le contexte est préservé. Les libellés issus du code React et de themeConfig vont dans des fichiers JSON au format i18n de Chrome, où chaque clé a des champs message et description. La troisième sorte est les données de plugins, comme les libellés des catégories de la barre latérale.

Bash
npm run write-translations -- --locale fr
npm run start -- --locale fr
npx docusaurus build --locale fr
npx docusaurus build

La commande write-translations effectue uniquement une analyse statique de ton code, elle n'exécute pas le site, donc les messages construits dynamiquement à partir d'expressions ne seront pas extraits. La commande build sans option --locale construit toutes les locales connues, et avec l'option seulement celles que tu nommes, ce qui est une issue de secours pratique quand un build complet dans le pipeline d'intégration continue commence à prendre trop de temps.

La documentation précise aussi ce que le système de traduction ne fait pas : il ne détecte pas automatiquement la locale de l'utilisateur, car cela relève de l'hébergeur, il ne s'appuie sur aucun service de traduction particulier, et il ne traduit pas les slugs, ce qu'elle qualifie de techniquement compliqué et de peu de valeur pour le référencement. Les libellés du thème classic par défaut sont déjà livrés traduits dans de nombreuses langues dans le paquet @docusaurus/theme-translations.

Docusaurus face aux alternatives

CaractéristiqueDocusaurus 3.10.2Astro Starlight 0.41.7Nextra 4.6.1Mintlify
LicenceMITMITMITmoteur non public
Dernière version2026-07-102026-08-052025-12-04hors du registre npm
Couche de templatesReactAstroNext.jsfermée
Recherche dans le cœuraucunePagefind, sans configurationPagefind dans le thèmeservice du fournisseur
Versionnement des docsintégréplugin communautairepas dans le cœurfonction du service
Traductionsintégréesintégréesdépend du routage Next.jsfonction du service
Blogintégrépas dans le cœurvia le thèmefonction du service

Plusieurs lignes de ce tableau appellent un commentaire. Starlight a une recherche plein texte basée sur Pagefind activée par défaut sans aucune configuration, et une seule page est exclue de l'index avec pagefind: false dans le frontmatter du fichier. Le versionnement n'est pas dans le cœur, il est géré par le plugin communautaire starlight-versions du répertoire des plugins. Nextra recourt aussi à Pagefind, visible dans le paquet 4.6.1 publié où le composant de recherche charge le module pagefind/pagefind.js, mais la version 4.6.1 elle-même date du 4 décembre 2025, soit plus de huit mois. Nous avons couvert Mintlify séparément dans l'article sur Mintlify, et la différence clé y est d'une autre nature : le dépôt du moteur n'est pas public, donc les comparaisons de licence et de version n'ont pas de pendant ici.

Quand Docusaurus l'emporte. Un grand projet open source avec plusieurs versions majeures maintenues, une documentation en plusieurs langues et un blog de versions obtient les trois fonctions d'emblée, gratuitement, sans fournisseur au milieu. S'y ajoute une recherche gratuite du programme DocSearch, à condition que la candidature soit acceptée.

Quand il perd. Pour une documentation de trente pages, toute cette mécanique est excessive et Starlight ou un simple dossier Markdown dans le dépôt suffira. Une équipe qui ne connaît pas React restera coincée sur le swizzling au premier changement visuel inhabituel. Et si la documentation doit faire partie d'une application Next.js existante, sur un seul domaine et partageant l'état connecté, alors Docusaurus est une application distincte avec un build distinct, donc Nextra ou tes propres routes dans Next.js seront plus simples.

Trois inconvénients valent la peine d'être nommés franchement, car aucun ne disparaît après l'installation. Premièrement, tout le build est en React, donc le site de documentation traîne l'écosystème React avec ses mises à jour et ses conflits de versions. Deuxièmement, les migrations entre versions majeures ont exigé de réécrire la configuration, et la trace en est encore dans le code : l'option markdown.mdx1Compat avec ses valeurs par défaut comments, admonitions et headingIds existe précisément pour faciliter le passage à la version 3, et le drapeau future.v4.mdx1CompatDisabledByDefault prépare sa suppression. Troisièmement, la recherche est une dépendance externe, et dans la variante officielle aussi un service externe avec sa propre grille tarifaire et ses propres règles d'admission.

Erreurs courantes

Supposer que la recherche sera simplement là. C'est l'erreur la plus fréquente et elle apparaît la veille du lancement. La décision entre DocSearch et la recherche locale doit être prise au départ, car une candidature au programme d'Algolia n'est pas instantanée et peut être refusée.

Cacher l'apiKey dans des variables d'environnement. La clé de la configuration algolia est la clé de recherche publique et la documentation dit clairement qu'elle peut être committée dans le dépôt. Construire une procédure de gestion de secret autour d'elle fait perdre du temps et complique au passage les aperçus de déploiement.

Versionner dès le premier jour. Figer une version avant que la documentation ne se stabilise te donne deux dossiers à maintenir et aucun bénéfice. La documentation conseille l'inverse, et l'astuce lastVersion: 'current' te permet d'afficher un numéro de version sans copier de fichiers.

Activer les drapeaux future.faster sans le paquet. La section faster exige @docusaurus/faster dans tes dépendances, de même que future.v4.fasterByDefault. Sans ce paquet, le build échoue.

Une incohérence de docsRouteBasePath avec la recherche locale. En mode docs seules, quand le routeBasePath du preset est réglé sur /, la même valeur doit parvenir aux options du plugin de recherche. Le symptôme est trompeur, car le site se construit très bien et la recherche ne trouve simplement rien.

Mettre à jour initialIndexSettings dans la configuration du crawler. Ces réglages n'initialisent l'index que s'il n'existe pas encore. Après un changement, la démarche recommandée est de supprimer l'index et de lancer un nouveau crawl, plutôt que d'attendre que la nouvelle configuration s'applique d'elle-même.

FAQ

Docusaurus 4 est-il déjà sorti ?

Pas dans le registre npm. Au 22 août 2026, il n'y a pas de paquet @docusaurus/core en 4.x, sur aucun canal. Le tag next pointe vers 3.0.0-rc.1, c'est-à-dire une release candidate de la version 3, donc installer depuis ce canal te fait reculer. La version 4 se prépare via les drapeaux future.v4 déjà disponibles dans la 3.10.2, et c'est la bonne façon de s'y préparer.

Que coûte réellement la recherche sur un projet commercial ?

Le programme gratuit DocSearch couvre la documentation technique publique et les blogs techniques, donc la documentation de produit commerciale n'en bénéficiera pas. Tu paies les tarifs publics d'Algolia : l'offre Grow inclut 10 000 requêtes de recherche par mois et 0,50 dollar par millier supplémentaire, plus 100 000 enregistrements et 0,40 dollar par millier supplémentaire. Grow Plus a les mêmes seuils mais 1,75 dollar par millier de requêtes en dépassement. S'y ajoute la facturation du crawler, où la grille de prix affiche deux chiffres différents, donc vérifie la limite dans le tableau de bord.

Une équipe peut-elle utiliser Docusaurus sans connaître React ?

Pour écrire et publier de la documentation, oui, car le contenu est constitué de fichiers Markdown et MDX et le thème classic fonctionne sans écrire de composants. La limite se situe là où s'arrêtent les variables CSS. Une page d'accueil personnalisée, une mise en page de page de doc inhabituelle ou un changement du comportement de la barre latérale passent tous par le swizzling d'un composant du thème, c'est-à-dire travailler en React et maintenir cette copie à chaque mise à jour.

Peut-on désactiver le versionnement après coup ?

Oui. L'option disableVersioning désactive le versionnement malgré les versions existantes, et le site ne contient alors que la version courante. Une version peut aussi être supprimée définitivement : retire son numéro de versions.json, supprime le dossier versioned_docs/version-X et le fichier versioned_sidebars/version-X-sidebars.json. Si tu veux seulement des builds d'aperçu plus rapides, onlyIncludeVersions avec deux ou trois versions suffit.

Docusaurus convient-il à une documentation dans une application Next.js ?

Pas au sens d'une intégration. Docusaurus est une application autonome avec son propre build et son propre routeur, pas un ensemble de composants à brancher sur des routes existantes. Tu peux le servir sous un chemin /docs au niveau du reverse proxy, mais cela reste deux déploiements distincts. Quand la documentation doit partager la mise en page et la session avec l'application, Nextra ou tes propres pages MDX dans le projet Next.js sont plus proches de l'objectif.

Que donnent les drapeaux Docusaurus Faster et valent-ils la peine d'être activés ?

Ils remplacent des outils plus lents par des plus rapides : SWC au lieu de Babel pour la transpilation et la minification, Lightning CSS au lieu de cssnano et clean-css, Rspack au lieu de webpack, un pool de threads pour la génération du site statique et des lectures plus rapides des métadonnées Git. Dans la 3.10.2 ils sont désactivés par défaut, ils exigent le paquet @docusaurus/faster, et rspackPersistentCache exige en plus de conserver ./node_modules/.cache entre les builds. Ils valent la peine d'être activés, mais mesure sur ton propre dépôt, car le gain dépend du nombre de pages et de versions.

À lire aussi