Docusaurus compila tu documentación en un sitio estático en build/: cada documento y cada entrada del blog como HTML, con búsqueda y navegación que funcionan en el navegador. Lobsite aloja esa carpeta. Ejecuta npm run build, luego npx lobsite, y tu documentación estará publicada en una dirección *.lobsite.app con HTTPS. Cada deploy tiene además su propia URL, útil para revisar los cambios en la documentación antes de publicarlos.
Cómo funciona
- Compila la documentación con
npm run build. Docusaurus escribe el sitio enbuild/y, por defecto, hace fallar el build si hay enlaces rotos. - Ejecuta
npx lobsiteen el proyecto. Despliegabuild/, nostatic/. El primer deploy no necesita cuenta y dura 6 horas. - Consérvala con el enlace para reclamarla, en una cuenta gratuita. Después,
npm run build && npx lobsiteactualiza la misma dirección.
url, baseUrl y barras finales
// docusaurus.config.js
export default {
url: "https://my-docs.lobsite.app",
baseUrl: "/",
};
urles la dirección de tu sitio. Docusaurus la usa para los enlaces canónicos y el sitemap.baseUrles/en Lobsite. Un sitio de proyecto de GitHub Pages usa/repo-name/; si lo dejas, se rompen todos los enlaces a recursos.trailingSlashse puede omitir. Los documentos generados comodocs/intro/index.htmlse abren en/docs/intro/;/docs/introredirige ahí.
Revisar cambios en la documentación
La documentación la escriben muchas personas y a menudo la revisa otra. lobsite deploy --preview publica el build en su propia URL sin tocar la documentación publicada, así quien revisa lee el cambio tal como se verá. lobsite promote lo publica, y lobsite rollback vuelve a la versión anterior en un solo paso. ¿Mueves páginas? Añade redirecciones para las rutas antiguas en lobsite.toml para que los enlaces desde resultados de búsqueda y otros sitios sigan funcionando; el Generador de redirecciones escribe las reglas. Los agentes de programación con IA pueden ejecutar el mismo deploy con npx -y lobsite --yes, que nunca se detiene a preguntar.
Previsualiza antes de publicar. Vuelve atrás con un clic, redirecciones incluidas.
Los archivos se guardan por su hash. Volver a desplegar un sitio sin cambios sube 0 bytes.
Cada sitio recibe una dirección *.lobsite.app con HTTPS desde el primer deploy.
Las redirecciones, cabeceras y formularios están en lobsite.toml y viajan con cada deploy.
Sin preguntas bajo un agente, y una línea Tell the user: con la URL y el enlace para reclamarlo.
Todos los límites están publicados y cada error te dice qué hacer a continuación.
Comparativa de hostings para Docusaurus
| Lobsite | GitHub Pages | Netlify | Vercel | |
|---|---|---|---|---|
| Compila la documentación por ti | No: despliegas build/ |
En GitHub Actions, o docusaurus deploy |
Sí | Sí |
| URL de vista previa para cada deploy | Sí | No | Sí | Sí |
| Rollback en un paso | Sí | Revertir un commit | Sí | Sí |
| Cuenta antes del primer deploy | No: publicado 6 horas, luego consérvalo gratis | Sí, y un repositorio | Sí | Sí |
| Dominio propio | Sí, gratis | Sí, gratis | Sí | Sí |
GitHub Pages funciona bien para documentación open source que vive junto al código. Lobsite encaja con documentación que compilas en local o en CI y quieres previsualizar, publicar y revertir sin un flujo de Git alrededor del hosting.
Preguntas frecuentes
¿Qué baseUrl debe usar Docusaurus en Lobsite?
/. El sitio se sirve desde la raíz de su dirección. Solo un sitio de proyecto de GitHub Pages necesita /repo-name/.
¿Funciona la búsqueda de Docusaurus en un hosting estático?
Sí. Algolia DocSearch se ejecuta en el navegador del visitante, y los plugins de búsqueda local generan su índice en build/. Ninguno necesita servidor.
¿Puedo alojar documentación versionada de Docusaurus?
Sí. Cada versión se genera en build/ como páginas propias, así que todas se despliegan juntas. Solo se suben los archivos que cambiaron desde el último deploy.
¿Qué tamaño puede tener un sitio de Docusaurus?
En el plan gratuito, hasta 100 archivos y 50 MB por deploy, suficiente para la mayoría de los sitios de documentación. Una documentación más grande, con muchas versiones o imágenes, necesita el plan de pago, disponible pronto; todos los límites están en la tabla de límites.