vagejs
GitHub Commencer

Les fonctionnalités de vagejs
Ce que vagejs fait pour votre site.

vagejs est un générateur de sites statiques gratuit et open source, conçu pour les assistants de code IA. Ses principales fonctionnalités sont les pages Markdown et MDX, les composants React et Vue, les sites en plusieurs langues, les fichiers que les moteurs de recherche et les assistants IA viennent chercher, une vérification de chaque page avant sa mise en ligne, la protection anti-spam et des déploiements sûrs. Vous écrivez les pages, ou vous laissez votre assistant IA les écrire. Voici tout ce qu'il fait, avec un lien vers la documentation pour chaque partie.

npm create vagejs@latest my-site

CommencerL'utiliser avec votre assistant IA

Écrire et construire vos pages

Des fichiers simples qui vous appartiennent, avec des composants seulement là où vous le voulez.

  • Écrire des pages

    Chaque page est un fichier Markdown dans src/pages, et son dossier décide de son adresse : src/pages/pricing.md devient /pricing/. Les pages peuvent être des brouillons, porter des tags qui ont leurs propres pages, ou attendre une date de publication. Une page avec un datePublished dans le futur reste hors du build, du sitemap et des flux jusqu'à ce jour-là, puis apparaît au build suivant.

    Voir la rédaction de contenu

  • Un éditeur local

    npm run dev lance aussi un éditeur dans votre navigateur : un formulaire pour chaque page, le texte avec un aperçu en direct dans le design de votre site, l'envoi d'images et les résultats de la vérification de la page. Il refuse d'écraser une page qui a changé depuis que vous l'avez ouverte, ne fonctionne que sur votre propre ordinateur et ne fait jamais partie du site construit.

    Voir modifier dans votre navigateur

  • React, Vue et MDX

    Les layouts peuvent être des fonctions TypeScript ou des composants React et Vue, et les pages peuvent être en MDX avec des composants React. Tout cela devient du HTML simple. Ajoutez client:visible à un composant React et il devient un îlot interactif, sur cette page uniquement.

    Voir React, Vue et MDX

  • Plusieurs langues

    Placez les traductions dans un dossier par langue. vagejs définit la langue de chaque page, écrit les liens hreflang entre les versions et vous avertit des pages qui restent à traduire.

    Voir les sites multilingues

Être trouvé par les moteurs de recherche et l'IA

Tout ce que lisent les moteurs de recherche et les assistants IA est écrit pour vous, à partir des pages que vous avez.

Le sitemap, robots.txt, llms.txt, les liens canoniques, les balises de partage, les données structurées et les flux RSS sont générés à partir des pages qui existent. Dans robots.txt, vous pouvez traiter les robots d'entraînement d'IA (comme GPTBot et ClaudeBot) différemment des robots de recherche IA (comme OAI-SearchBot et PerplexityBot). Voir SEO et recherche IA.

Publier sans mauvaise surprise

Chaque page est vérifiée avant sa mise en ligne, et rien ne part sans votre accord.

  • Des vérifications avant de publier

    vage check lit chaque page sans rien écrire et signale les liens cassés, les titres et descriptions manquants ou en double, les données structurées invalides et les erreurs d'accessibilité de base, chacun avec le fichier à corriger. vage audit construit le site et soumet chaque page à des budgets de taille, comme 100 KB de JavaScript.

    Voir vérifications et audits

  • Protection contre l'injection de spam

    Chaque site externe vers lequel vos pages pointent est listé dans links.lock.json. Un lien vers un site qui ne figure pas sur la liste, ou un lien caché aux visiteurs, fait échouer la vérification. vage verify compare le site en ligne avec vos fichiers.

    Voir sécurité

  • Des déploiements sûrs

    vage deploy publie sur GitHub Pages, Cloudflare Workers, Cloudflare Pages ou Netlify. Il lance d'abord la vérification, affiche un plan et attend votre oui, refuse de committer des secrets et ne force jamais un push. N'importe quel autre hébergeur statique, comme Vercel, peut servir le dossier dist.

    Voir déploiement

  • Des formulaires de contact sans JavaScript

    Sur Cloudflare Workers, un formulaire de contact n'a besoin d'aucun script sur la page : vage deploy ajoute un petit Worker qui envoie chaque message par e-mail, avec un piège à spam et une limite par visiteur.

    Voir formulaire de contact

Conçu pour les assistants de code IA

Chaque nouveau site inclut AGENTS.md, qui indique à Claude Code, Codex, Cursor et aux autres assistants les commandes et les règles. vage info --json décrit chaque commande et chaque réglage en une seule réponse, et vage mcp permet à un assistant de vérifier le site directement. Voir les guides pour les agents.

terminal
npx vage info --json   # every command and setting, in one reply
claude mcp add --transport stdio --scope project vagejs -- npx -p vagejs vage mcp

Guides et comparatifs sur les fonctionnalités de vagejs

Les guides détaillent des tâches précises étape par étape, et vagejs comparé montre comment ces fonctionnalités se situent face aux autres générateurs de sites statiques et CMS. Pour savoir qui fait vagejs et pourquoi, lisez à propos de vagejs.

Questions sur les fonctionnalités de vagejs

vagejs envoie-t-il du JavaScript aux visiteurs ?

Non, sauf si vous le demandez. Les pages sont du HTML simple, donc un nouveau site envoie 0 KB de JavaScript. Seul un composant React marqué client:visible, client:load ou client:idle en ajoute, et uniquement sur la page qui l'utilise.

Puis-je utiliser des composants React ou Vue ?

Oui. Les layouts peuvent être des composants React ou Vue, et les pages MDX peuvent utiliser des composants React. Ils sont transformés en HTML simple au moment du build, donc les visiteurs ne téléchargent ni React ni Vue, sauf si un composant doit être interactif.

Que vérifie vage check ?

Les liens cassés, les titres et descriptions manquants ou en double, les données structurées invalides, les liens vers des sites que vous n'avez pas approuvés et les erreurs d'accessibilité de base, comme des images sans texte alternatif. Chaque problème indique le fichier à corriger, pour que vous ou votre assistant IA puissiez le régler tout de suite.

Puis-je modifier les pages sans éditeur de code ?

Oui. npm run dev ouvre un éditeur dans votre navigateur, avec un formulaire pour chaque page et un aperçu en direct dans le design de votre site. Il ne fonctionne que sur votre propre ordinateur et ne fait jamais partie du site publié.

Commencez avec une seule commande.
Votre site tourne en une minute.

npm create vagejs@latest my-site

Lire la documentationL'utiliser avec votre assistant IA