Blume 2.0

Las carpetas se vuelven rutas y los nombres de archivo se vuelven slugs, así que una página nueva es un archivo nuevo. La barra lateral se arma sola con el árbol de directorios y luego acepta ajustes desde el frontmatter o desde un meta.ts colocado junto a las páginas. Puedes reordenar un grupo, ponerle un icono o esconder una página sin tocar el archivo de configuración, y las migas de pan y el índice lateral siguen la misma estructura.

Cada sitio de Blume publica llms.txt y una réplica .md por ruta, de forma que un agente descarga el origen de la página en lugar de raspar el HTML renderizado. El servidor MCP opcional expone la búsqueda y la lectura de páginas como herramientas, y el sitio también sirve una API JSON de documentación descrita con un documento OpenAPI 3.1. Un manifiesto en /.well-known/ai-catalog.json permite que los registros de agentes descubran el sitio.

Blume funciona como generador de referencias de API para esquemas OpenAPI, AsyncAPI o GraphQL, en local o en remoto. Apuntas la configuración al archivo y aparecen la vista general, una página por operación, los parámetros, los cuerpos de petición y las tablas de respuesta. Los ejemplos de código se generan en 18 lenguajes, desde cURL y Python hasta Go, Ruby y C#. Como la referencia se construye en el build, un cambio de esquema aparece en el siguiente despliegue.

El buscador funciona sin clave de API gracias a un índice local, y acierta también con texto chino, japonés, coreano y tailandés, idiomas que no separan palabras con espacios. Los sitios grandes pueden cambiar a Algolia, Typesense, Orama Cloud, Mixedbread o Pagefind mediante un adaptador. El panel del asistente responde con las páginas del propio sitio, con adaptadores para Vercel AI Gateway, OpenRouter, LLM Gateway, Inkeep o cualquier endpoint compatible con OpenAI.

Las carpetas de idioma producen rutas con prefijo, navegación por idioma y textos de interfaz traducidos, y blume translate rellena los idiomas que falten. El versionado congela una carpeta por cada release, añade un selector de versión y mantiene la búsqueda limitada a la versión elegida. Las dos funciones llegan también a la superficie para agentes, así que un agente ve las mismas rutas que un lector.

blume validate revisa enlaces, anclas y frontmatter antes de desplegar. blume audit lee el HTML construido y señala problemas de SEO con el archivo y la línea de origen. blume eval lanza un agente lector y otro juez contra la documentación para comprobar si las respuestas se encuentran de verdad. Si el framework se te queda corto, blume eject convierte el proyecto oculto en una aplicación Astro independiente que pasa a ser tuya.