Installation

#Ajouter la dépendance

pnpm add -D @kirchdev/duxt

#Étendre la couche

export default defineNuxtConfig({
  extends: ['@kirchdev/duxt']
});

#Écrire votre documentation

Le Markdown se place dans docs/, à la racine de votre dépôt — résolu par rapport au dépôt et non au répertoire d’exécution du site, afin qu’un site situé dans un sous-dossier le trouve. Un fichier devient une page, un dossier une section, et le frontmatter porte le titre, la description et l’icône.

---
title: Introduction
description: Ce qu’est ce projet.
icon: lucide:rocket
---

Votre première page.

Un préfixe numérique ordonne l’arborescence et disparaît de l’URL : 1.getting-started/ est servi sur /getting-started. Réordonner une section ne déplace donc jamais une URL — seul le renommage de la partie après le point le fait.

#Ce dont la compilation a besoin

• Node 24. La couche lit sa base de données via node:sqlite ; aucun pilote SQLite natif n’est installé ni nécessaire.
• Un accès réseau à vos sources, si certaines sont d’autres dépôts, et un jeton pour les dépôts privés — Content le lit dans l’auth de la collection.

#Ce qui vient avec

Le paquet livre une commande, duxt-report, et étendre la couche suffit à en disposer :

pnpm exec duxt-report            # ce que vos sources sont devenues, en Markdown
pnpm exec duxt-report --json     # les mêmes données, non rendues

Elle affiche les collections résolues, tout ce que la compilation vérifie et les redirections que déclarent les pages — aucun serveur de développement, elle s’exécute donc en CI et dans un pipe. Voir Ce que la compilation vérifie.

#Résultat

nuxt dev sert le site. Tout ce que le thème dessine est une donnée avec une valeur par défaut ; l’étape suivante est donc le seul fichier qui la remplace : Configuration.