---
title: "Introduction"
description: "Ce qu'est Scribekit, et comment les surfaces blog et documentation s'articulent."
tab: "Documentation"
group: "Get started"
order: 1
icon: "book"
updated: "2026-07-11"
---

Scribekit est un petit paquet TypeScript qui transforme un dossier de fichiers MDX en un blog *et* un
site de documentation prêts pour la production, pour l'App Router de Next.js - des composants serveur
pour les pages, des compétences d'agent portables pour les rédiger, et le SEO intégré.

## Ce que vous apportez, et ce que Scribekit affiche

Vous apportez le contenu : un dossier par page. La part d'habillage à fournir dépend de la surface.

- Pour la **documentation**, Scribekit fournit tout l'habillage : la barre de navigation, la barre
  d'onglets, la barre latérale, le sélecteur de langue, la palette de commandes et la minicarte. Vous
  fournissez le logo et les actions de droite.
- Pour le **blog**, vous apportez l'habillage de page (votre barre de navigation, votre pied de page
  et votre hero) et Scribekit affiche la grille de cartes et l'article.

## Ce que vous obtenez

- Une vue d'ensemble de **blog** avec recherche floue, filtres par catégorie et une grille de cartes
  à défilement infini (avec un bouton « Charger plus » en repli), ainsi que les pages d'article.
- Un site de **documentation** à onglets et groupé, avec une palette de commandes et une minicarte à
  défilement synchronisé.
- Des `Metadata`, du JSON-LD et des sitemaps i18n dérivés de la configuration de votre site.

## Comment tout s'articule

Les classes `Blog` et `Docs` lisent votre MDX côté serveur : elles sont `server-only`, de sorte que le
système de fichiers ne peut jamais franchir la frontière du bundle client. Avec le rendu statique de
Next, cette lecture a lieu une seule fois, à la compilation.

Vous passez l'instance elle-même aux composants serveur, qui en dérivent ce dont ils ont besoin et
transmettent des données simples et sérialisables aux parties client interactives.