Preguntas frecuentes
Respuestas claras.

vagejs es un generador de sitios estáticos gratuito y de código abierto para crear sitios web. Escribes las páginas como archivos de texto sencillos, y lo convierte en un sitio web rápido con los archivos para buscadores y para IA ya incluidos. Cada archivo .md de la carpeta src/pages se convierte en una página, y cada compilación genera por ti un sitemap, robots.txt y llms.txt. Cuando probamos un sitio recién creado con la herramienta Lighthouse de Google, obtuvo 100 en todas las categorías y envió 0 KB de JavaScript a los visitantes.

Sí. Se publica con la licencia MIT, así que puedes usarlo sin coste para sitios personales y comerciales. El código está en GitHub y el paquete en npm, así que puedes leer exactamente lo que hace antes de confiar en él. Crea un sitio nuevo con npm create vagejs@latest my-site, o añádelo a un proyecto existente con npm install --save-dev vagejs. El hosting es un coste aparte, y para un sitio pequeño a menudo también es gratis.

Ayuda sentirse algo cómodo con la terminal. Para escribir páginas solo hace falta texto plano, y los asistentes de programación con IA como Claude Code pueden configurar y actualizar un sitio por ti. Al crear un sitio, te ofrece abrir Claude Code, Codex o Gemini CLI si los encuentra en tu ordenador, o el editor en el navegador si no usas ninguna herramienta de programación. El editor te da un formulario para cada página, una vista previa en directo con el diseño de tu sitio y los problemas que encuentra vage check después de cada guardado.

Un CMS típico ejecuta una base de datos y código en el servidor cada vez que alguien visita el sitio. vagejs genera páginas normales con antelación, así que no hay ninguna base de datos que proteger ni actualizar. Tampoco hay un panel de administración en línea; tu contenido vive en archivos de texto, y un editor local te permite cambiarlos en tu navegador, en tu propio ordenador. Mientras se ejecuta npm run dev, el editor está en /_vage/edit/ en la dirección local de tu sitio, y nunca forma parte del sitio compilado. Sin panel de administración, base de datos ni plugins, los atacantes tienen mucho menos que atacar.

Se encarga de la parte técnica: sitemaps, resúmenes de página, datos estructurados, velocidad y revisión de enlaces rotos. El posicionamiento sigue dependiendo de tu contenido y de que otros sitios te enlacen, y ninguna herramienta puede garantizarlo. Antes de publicar, npx vage check lee cada página e informa de problemas como resúmenes de página que faltan, títulos duplicados y enlaces rotos, y cada despliegue se detiene ante sus errores. En nuestra prueba con Lighthouse, un sitio nuevo obtuvo 100 en SEO, y su contenido principal apareció en 0.8 s con una conexión móvil lenta simulada.

Crea llms.txt, una guía sencilla de tu sitio para las herramientas de IA, y te permite elegir qué rastreadores de IA pueden visitarlo. Que un asistente de IA mencione tu sitio depende de ese asistente. En vage.config.ts, el ajuste aiTraining cubre los rastreadores que recopilan páginas para entrenamiento, como GPTBot y ClaudeBot, y aiSearch cubre los rastreadores de búsqueda con IA, como OAI-SearchBot y PerplexityBot. Ten en cuenta que llms.txt es una convención propuesta, no un estándar de los buscadores: algunas herramientas de IA lo leen, y no cambiará tu posicionamiento en Google.

Los enlaces a sitios web que no has aprobado, y los enlaces ocultos a los visitantes, detienen la compilación. vage verify compara tu sitio publicado con tus archivos, así que los enlaces, scripts o páginas inyectados se detectan enseguida. Los sitios web aprobados están en links.lock.json, y npx vage links approve example.com añade uno solo después de preguntarte. vage verify también descarga cada página como Googlebot, porque los sitios hackeados a menudo muestran el spam solo a los buscadores, y los sitios nuevos incluyen una comprobación diaria con GitHub Actions que te envía un correo si falla.

En cualquier lugar que sirva archivos. GitHub Pages, Cloudflare (Workers o Pages) y Netlify tienen publicación con un solo comando incluida, y cualquier otro hosting estático, como Vercel, puede servir la carpeta dist. En esos tres, npx vage deploy ejecuta primero vage check y vage build, te muestra su plan y te pregunta antes de cambiar nada, y solo informa de éxito cuando el sitio publicado responde. En otros hostings, configura npm run build como comando de compilación y dist como carpeta de salida, con Node.js 22.12 o una versión más reciente.

A menudo, nada. Un sitio de vagejs es una carpeta de archivos, y Cloudflare, Netlify y GitHub Pages alojan sitios estáticos en sus planes gratuitos, dentro de sus límites. No hay base de datos ni código de servidor que pagar, y los archivos son pequeños: la página de inicio de un sitio recién creado descarga 1.7 KB en 2 peticiones, y el sitio de inicio de cuatro páginas se compila en 0.5 s. Cada hosting fija sus planes gratuitos y sus límites, que pueden cambiar, así que revisa el plan actual de tu hosting antes de publicar.

Sí. Cada sitio incluye instrucciones que leen Claude Code, Codex, Cursor, Copilot y otros agentes, y todos los comandos pueden responder en JSON. Tú sigues aprobando la publicación y los nuevos enlaces externos. Los sitios nuevos incluyen AGENTS.md y CLAUDE.md, y npx vage info --json enumera cada comando, opción y ajuste, además de las funciones que aún no existen, para que un asistente no las prometa. npx vage mcp también ejecuta un servidor MCP con herramientas de solo lectura que revisan el sitio y enumeran sus páginas y enlaces externos.

vagejs es joven (0.x) y este sitio web funciona con él. El sitio que genera es HTML plano, así que es tan estable como tu hosting. Lee el registro de cambios antes de actualizar, porque las versiones 0.x pueden cambiar su comportamiento. Para actualizar, ejecuta npm install vagejs@latest y después npm run check para asegurarte de que tu sitio sigue pasando las comprobaciones. También puedes fijar el paquete de reglas en vage.config.ts, para que los datos de proveedores, como los nombres de los rastreadores de IA, cambien solo cuando tú decidas.

Node.js 22.12 o una versión más reciente. Después ejecuta npm create vagejs@latest my-site y sigue los tres pasos que muestra. Puedes comprobar tu versión con node --version. El comando crea una carpeta my-site con páginas de ejemplo, una plantilla, la configuración y AGENTS.md, y luego te ofrece instalarlo todo y abrir el sitio en tu navegador. vagejs funciona en macOS, Windows y Linux, y para volver a iniciar el sitio más adelante, ejecuta npm start en esa carpeta.