vagejs
GitHub Primeros pasos

Funciones de vagejs
Lo que vagejs hace por tu sitio.

vagejs es un generador de sitios estáticos gratuito y de código abierto creado para los asistentes de programación con IA. Sus funciones principales son las páginas Markdown y MDX, los componentes React y Vue, los sitios en varios idiomas, los archivos que buscan los buscadores y los asistentes de IA, una revisión de cada página antes de publicarla, la protección contra el spam y la publicación segura. Tú escribes las páginas, o dejas que tu asistente de IA las escriba. Aquí tienes todo lo que hace, con un enlace a la documentación de cada parte.

npm create vagejs@latest my-site

Primeros pasosÚsalo con tu asistente de IA

Escribe y genera tus páginas

Archivos sencillos que te pertenecen, con componentes solo donde los quieras.

  • Escribir páginas

    Cada página es un archivo Markdown en src/pages, y su carpeta decide su dirección: src/pages/pricing.md se convierte en /pricing/. Las páginas pueden ser borradores, llevar etiquetas que tienen sus propias páginas o esperar a una fecha de publicación. Una página con un datePublished futuro queda fuera de la compilación, del sitemap y de los feeds hasta ese día, y aparece con la siguiente compilación.

    Consulta creación de contenido

  • Un editor local

    npm run dev también abre un editor en tu navegador: un formulario para cada página, el texto con una vista previa en directo con el diseño de tu sitio, subida de imágenes y los resultados de la revisión de la página. Se niega a sobrescribir una página que haya cambiado desde que la abriste, funciona solo en tu propio ordenador y nunca forma parte del sitio generado.

    Consulta edita en tu navegador

  • React, Vue y MDX

    Las plantillas pueden ser funciones de TypeScript o componentes de React y Vue, y las páginas pueden ser MDX con componentes de React. Todo se convierte en HTML plano. Añade client:visible a un componente de React y se convierte en una isla interactiva solo en esa página.

    Consulta React, Vue y MDX

  • Varios idiomas

    Pon las traducciones en una carpeta por idioma. vagejs define el idioma de cada página, escribe enlaces hreflang entre las versiones y te avisa de las páginas que aún hay que traducir.

    Consulta sitios multilingües

Haz que te encuentren los buscadores y la IA

Todo lo que leen los buscadores y los asistentes de IA se escribe por ti, a partir de las páginas que tienes.

El sitemap, robots.txt, llms.txt, los enlaces canónicos, las etiquetas para compartir, los datos estructurados y los feeds RSS salen de las páginas que existen. En robots.txt puedes tratar los rastreadores de entrenamiento de IA (como GPTBot y ClaudeBot) de forma distinta a los rastreadores de búsqueda con IA (como OAI-SearchBot y PerplexityBot). Consulta SEO y búsqueda con IA.

Publica sin sorpresas

Cada página se revisa antes de publicarse, y no sale nada que no hayas aprobado.

  • Revisiones antes de publicar

    vage check lee todas las páginas sin escribir nada e informa de enlaces rotos, títulos y descripciones que faltan o están duplicados, datos estructurados no válidos y fallos básicos de accesibilidad, cada uno con el archivo que hay que corregir. vage audit genera el sitio y somete cada página a límites de tamaño, como 100 KB de JavaScript.

    Consulta revisiones y auditorías

  • Protección contra la inyección de spam

    Todos los sitios web externos a los que enlazan tus páginas aparecen en links.lock.json. Un enlace a un sitio web que no está en la lista, o un enlace oculto a los visitantes, hace fallar la revisión. vage verify compara el sitio publicado con tus archivos.

    Consulta seguridad

  • Publicación segura

    vage deploy publica en GitHub Pages, Cloudflare Workers, Cloudflare Pages o Netlify. Primero ejecuta la revisión, muestra un plan y espera a que digas que sí, se niega a hacer commit de secretos y nunca hace un force push. Cualquier otro hosting estático, como Vercel, puede servir la carpeta dist.

    Consulta publicación

  • Formularios de contacto sin JavaScript

    En Cloudflare Workers, un formulario de contacto no necesita ningún script en la página: vage deploy añade un pequeño Worker que envía cada mensaje por correo, con una trampa para spam y un límite por visitante.

    Consulta formulario de contacto

Hecho para asistentes de programación con IA

Cada sitio nuevo incluye AGENTS.md, que les dice a Claude Code, Codex, Cursor y otros asistentes los comandos y las reglas. vage info --json describe todos los comandos y ajustes en una sola respuesta, y vage mcp permite que un asistente revise el sitio directamente. Consulta las guías para agentes.

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

Guías y comparativas de las funciones de vagejs

Las guías explican paso a paso tareas concretas, y vagejs comparado muestra cómo se comparan estas funciones con las de otros generadores de sitios estáticos y CMS. Para saber quién hace vagejs y por qué, lee acerca de vagejs.

Preguntas sobre las funciones de vagejs

¿vagejs envía JavaScript a los visitantes?

No, a menos que lo pidas. Las páginas son HTML plano, así que un sitio nuevo envía 0 KB de JavaScript. Un componente de React marcado con client:visible, client:load o client:idle es lo único que añade algo, y solo en la página que lo usa.

¿Puedo usar componentes de React o Vue?

Sí. Las plantillas pueden ser componentes de React o Vue, y las páginas MDX pueden usar componentes de React. Se convierten en HTML plano al generar el sitio, así que los visitantes no descargan React ni Vue a menos que un componente tenga que ser interactivo.

¿Qué busca vage check?

Enlaces rotos, títulos y descripciones que faltan o están duplicados, datos estructurados no válidos, enlaces a sitios web que no has aprobado y fallos básicos de accesibilidad, como imágenes sin texto alternativo. Cada problema indica el archivo que hay que corregir, para que tú o tu asistente de IA lo arreglen enseguida.

¿Puedo editar páginas sin un editor de código?

Sí. npm run dev abre un editor en tu navegador con un formulario para cada página y una vista previa en directo con el diseño de tu sitio. Solo funciona en tu propio ordenador y nunca forma parte del sitio publicado.

Empieza con un solo comando.
Tendrás un sitio funcionando en un minuto.

npm create vagejs@latest my-site

Leer la documentaciónÚsalo con tu asistente de IA