CLI

La CLI sitelo enveloppe le Vite embarqué et injecte automatiquement le plugin de pages HTML.

Commandes

sitelo              # identique à sitelo dev
sitelo dev          # serveur de développement
sitelo build        # build de production
sitelo preview      # prévisualise le build de production
sitelo lighthouse   # audite le build de production

• dev — véritable rendu SSR à la demande, routes dynamiques comprises, plus une petite barre d’outils de développement
• build — HTML statique dans dist/ (ou votre outDir)
• preview — sert le build de production en local
• lighthouse — audite le build de production (nécessite la dépendance pair lighthouse)

Désactivez la barre d’outils avec devToolbar: false dans sitelo.config.js — voir Configuration.

Options utiles

sitelo --port 8888
sitelo build --outDir public --emptyOutDir
sitelo --root docs

• --port / --host / --open — serveur
• --outDir / --emptyOutDir / --base — build
• --root — racine du projet (pratique pour un site dans docs/)
• --config — fichier de configuration Vite personnalisé
• --mode / --logLevel / --debug

Pour tout ce que vous réutilisez d’une commande à l’autre, préférez les options Vite dans sitelo.config.js sous vite.

Trouver le code inutilisé

knip trouve les fichiers, exports et dépendances que rien n’utilise. Sur un projet sitelo, il lui faut une indication : les pages et les îlots sont découverts dans le système de fichiers, donc rien ne les importe, et sans cette indication knip signale tout le site comme des fichiers inutilisés.

npm install -D knip

import { knipConfig } from 'sitelo/knip'

export default knipConfig()

npx knip

knipConfig() lit votre sitelo.config.js et marque les pages et les îlots comme points d’entrée, exactement comme le build les découvre — pagesDir, pageExtensions, include et exclude s’appliquent tous. Ce qui reste dans le rapport est du code que le site n’atteint réellement jamais.

Une chose lui échappe : un script client qu’une page référence par URL plutôt que par import, comme <script src="/js/app.js">. Ceux-là, vous les listez vous-même, et vous passez à côté toute autre option acceptée par knip — elle est intégrée au résultat. Le ! final est la marque de knip pour le code de production, ce qu’est précisément un script livré au navigateur.

export default knipConfig({
  entry: ['src/js/app.js!'], // ce que les pages chargent via un <script src>
  ignore: ['legacy/**'], // et toute autre option acceptée par knip
})