CLI

La CLI de sitelo envuelve el Vite incluido e inyecta automáticamente el plugin de páginas HTML.

Comandos

sitelo              # igual que sitelo dev
sitelo dev          # servidor de desarrollo
sitelo build        # compilación de producción
sitelo preview      # previsualiza la compilación de producción
sitelo lighthouse   # audita la compilación de producción

• dev — renderizado SSR real bajo demanda, incluidas las rutas dinámicas, más una pequeña barra de herramientas de desarrollo
• build — HTML estático en dist/ (o el outDir que indiques)
• preview — sirve la compilación de producción en local
• lighthouse — audita la compilación de producción (requiere la dependencia par lighthouse)

Desactiva la barra con devToolbar: false en sitelo.config.js — consulta Configuración.

Opciones útiles

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

• --port / --host / --open — servidor
• --outDir / --emptyOutDir / --base — compilación
• --root — raíz del proyecto (práctico para un sitio en docs/)
• --config — archivo de configuración de Vite personalizado
• --mode / --logLevel / --debug

Para todo lo que reutilices entre comandos, es mejor poner las opciones de Vite en sitelo.config.js bajo vite.

Encontrar código sin usar

knip encuentra archivos, exports y dependencias que nada utiliza. En un proyecto sitelo necesita una pista: las páginas y las islas se descubren en el sistema de archivos, así que nada las importa, y sin esa pista knip informa de todo el sitio como archivos sin usar.

npm install -D knip

import { knipConfig } from 'sitelo/knip'

export default knipConfig()

npx knip

knipConfig() lee tu sitelo.config.js y marca las páginas y las islas como puntos de entrada tal como el build las descubre — pagesDir, pageExtensions, include y exclude se aplican todos. Lo que queda en el informe es código al que el sitio realmente nunca llega.

Hay una cosa que no puede ver: un script de cliente que una página referencia por URL en lugar de importarlo, como <script src="/js/app.js">. Esos los indicas tú, y cualquier otra opción que knip acepte la pasas al lado — se incorpora al resultado. El ! final es la marca de knip para código de producción, que es justo lo que es un script enviado al navegador.

export default knipConfig({
  entry: ['src/js/app.js!'], // lo que las páginas cargan con un <script src>
  ignore: ['legacy/**'], // y cualquier otra opción que knip acepte
})