← Volver al catálogo

Lumbre

Describe a landing page or a small web app and let your Alisio model build it, with reviewed changes and a live preview.

Detalles:

HerramientasInterfazMantenido aquí

npmRepositorioSitioReportar un problema

Instalación

alisio install npm:@alisio/plugin-lumbre@0.2.0

Metadatos

Paquete	@alisio/plugin-lumbre
Versión	0.2.0
Publicado	10 nov 2026
Autor	Alisio
Licencia	MIT
Categorías	Herramientas, Interfaz
Tamaño	1.1 MB
Dependencias	1
Peer dependencies	1
Descargas (último mes)	—
Origen	Primera parte
Palabras clave	alisio-plugin, web-builder, landing-page, vite, nextjs

Nota de seguridad: Los plugins se ejecutan en proceso con tus privilegios de usuario y no están en un sandbox. Revisa el código fuente antes de instalar un plugin de terceros.

English. Ambos README deben actualizarse juntos.

Describe con tus propias palabras una página de aterrizaje o una pequeña aplicación web; el modelo de Alisio que elijas la construye, revisas cada cambio antes de aplicarlo y la abres en vivo en tu navegador. Lumbre sigue el idioma de Alisio (inglés o español) y su tema claro u oscuro.

Requisitos

• Alisio 0.11.6 o posterior dentro de 0.11.x (el estudio usa la API de aplicaciones de plugins y su aviso de aprobación). En versiones anteriores solo funcionan la herramienta de solo lectura lumbre_projects y el comando de ayuda.
• Un proveedor de modelos conectado (/connect). Lumbre no pide credenciales propias.
• Acceso a internet la primera vez que se instala una base con paquetes.
• Node.js es el que incluye Alisio. Astro necesita Node.js 22.23.4 o posterior; Lumbre lo indica si el de Alisio es anterior.

Uso

1. Abre Lumbre · Creador web en el grupo Aplicaciones de tu proyecto.
2. Describe lo que quieres, elige cómo se debe construir y, si quieres, un modelo. Selecciona Empezar a construir.
3. Planificar (lo predeterminado en el primer mensaje de un proyecto nuevo): Lumbre propone un plan con una dirección de diseño, una paleta, roles tipográficos y un boceto de la composición. Selecciona Construir este plan, Editar o Descartar. El selector Planificar / Construir sobre el cuadro de mensaje siempre está disponible.
4. Construir: con un modelo que puede usar herramientas, Lumbre trabaja paso a paso en un borrador privado (lee, escribe y edita archivos) y la tarjeta de actividad muestra cada paso en vivo, con el tiempo transcurrido y Cancelar. Si se le acaban los pasos, continúa dos veces por su cuenta y luego se pausa con Continuar (y un objetivo opcional) o Revisar el borrador ahora. Antes de la revisión compila el borrador y corrige los errores de compilación hasta dos veces. Los modelos sin llamadas a herramientas escriben los archivos en una sola respuesta, como en la versión 0.1. Cuando Alisio pide permiso, Lumbre muestra "Esperando tu aprobación en Alisio…".
5. Revisa los cambios: archivos nuevos, modificados y eliminados, una comparación por archivo y cualquier paquete que haya pedido el modelo. Aplícalos todos, solo los que marques, o descártalos.
6. Abre Vista previa: una miniatura estática de tu página, más Iniciar vista previa en vivo y Abrir en vivo en tu navegador. La vista previa en vivo se recarga sola cuando aplicas cambios.
7. Sigue conversando para cambiarla. Si una compilación falla, Lumbre le envía el error al modelo y te propone una corrección para revisar, como máximo dos veces seguidas.
8. Usa Exportar para copiar el proyecto a una carpeta nueva de tu espacio de trabajo, o descarga un ZIP.

Código muestra cada archivo (puedes editar los tuyos; los que administra Lumbre son de solo lectura) e Historial conserva las últimas 40 versiones, y puedes restaurar cualquiera.

Bases

Base	Qué obtienes	Vista previa en vivo
HTML, CSS y JavaScript (Tailwind opcional)	Archivos simples; Tailwind se compila con su CLI	Servidor local propio de Lumbre con recarga automática
Vite + Tailwind	Módulos de JavaScript simple	Servidor de desarrollo de Vite
React + Vite + Tailwind	Una aplicación de una página con React	Servidor de desarrollo de Vite
Astro + Tailwind	Páginas de contenido	Servidor de desarrollo de Astro
Next.js (full stack)	Páginas y rutas de API	Servidor de desarrollo de Next.js

Las versiones están fijadas y cada base incluye un archivo de bloqueo confirmado, así que las instalaciones usan npm ci. El modelo solo puede pedir algunos paquetes adicionales de una lista permitida por base (nombre y versión exactos), y tú apruebas cada uno en la revisión. Lumbre escribe package.json, los archivos de bloqueo y los de configuración; ni el modelo ni el editor pueden cambiarlos.

Base	Paquetes adicionales que el modelo puede pedir
HTML, CSS y JavaScript (+ Tailwind)	Ninguno (no hay empaquetador): fuentes del sistema y JavaScript simple
Vite, Astro	clsx, tailwind-merge, class-variance-authority, zod, date-fns, fuentes autoalojadas (@fontsource)
React + Vite, Next.js	Lo anterior más lucide-react, motion, react-hook-form, @hookform/resolvers y primitivas de Radix (slot, dialog, dropdown-menu, tabs, accordion, popover, tooltip, label)
Astro con islas de React	Aprobar @astrojs/react agrega React y su integración a la configuración de Astro que administra Lumbre; luego, los paquetes de React anteriores

Lumbre prefiere menos dependencias: primero los elementos nativos y los componentes simples, y solo pide un paquete cuando ayuda claramente, explicando el motivo en el mensaje.

Diseño y calidad del código

El constructor sigue guías incluidas en el paquete: lmb-design (adaptada y combinada a partir de las habilidades frontend-design de Anthropic y de Vercel Labs, licencia Apache 2.0), lmb-tailwind (adaptada de tailwind-design-system de Seth Hobson, MIT) para las bases con Tailwind y lmb-react-next (adaptada de react-best-practices de Vercel, MIT, más las convenciones de archivos de Next.js 16 basadas en la documentación de Next.js, MIT) para React y Next.js. Detalles y licencias: THIRD_PARTY_NOTICES.md.

Seguridad y límites

• Las aplicaciones generadas se ejecutan como tú, sin aislamiento. Las instalaciones, las compilaciones y los servidores de desarrollo son procesos reales en este equipo con los permisos de tu cuenta, y solo se inician después de la aprobación de procesos de Alisio. Revisa el código antes de ejecutarlo o publicarlo, y no le pongas datos reales de clientes ni credenciales.
• npm siempre se ejecuta con --ignore-scripts. Los procesos hijos reciben un entorno mínimo, sin tus claves de proveedores ni tokens.
• Los servidores de desarrollo escuchan en 127.0.0.1 en un puerto que elige Lumbre, con puerto estricto. Una vista previa se detiene tras 20 minutos sin actividad en Lumbre. Los servidores que queden tras un cierre inesperado se detienen la próxima vez que se abre Lumbre, solo después de comprobar que pertenecen al proyecto.
• La miniatura nunca ejecuta los scripts de tu página y sus estilos quedan contenidos en ella.
• Un proyecto admite hasta 150 archivos de texto y 3 MB de código. Como máximo se ejecutan tres trabajos y tres vistas previas en vivo a la vez.

Datos

Los proyectos, su historial y el chat se guardan en el estado privado del plugin en Alisio, una carpeta por proyecto y por espacio de trabajo, así que un proyecto dañado nunca afecta a los demás. Las dependencias se instalan dentro de esa carpeta (un proyecto con framework suele ocupar entre 100 y 400 MB). Exportar solo escribe en una carpeta nueva o vacía de tu espacio de trabajo.

Solución de problemas

Cuando una solicitud falla, selecciona Ver detalles en la tarjeta de error. Muestra, sin nada de tu contenido: el modelo, su ventana de contexto y el presupuesto de salida que usó Lumbre (cada uno "informado por el proveedor" o "estimado"), los tokens usados, si los archivos se escribieron en partes, cuántas continuaciones hicieron falta y el motivo.

• "El modelo se detuvo antes de terminar." Lumbre escribe los proyectos nuevos por partes (primero un plan, luego grupos de archivos) y le pide al modelo que continúe hasta tres veces cuando su límite de salida corta una respuesta. Si aun así se detiene, los archivos que llegaron se conservan para revisarlos y se listan los que faltan. Pídele que continúe, pide un cambio más pequeño o elige un modelo con un límite de salida mayor.
• Límites "estimados". Algunos proveedores no informan la ventana de contexto ni el límite de salida de un modelo. Lumbre asume entonces 128 000 tokens de contexto y pide 32 768 tokens de salida; si el proveedor lo rechaza, reintenta una vez con el límite propio de Alisio.
• "El modelo no terminó (…)". El motivo entre paréntesis viene del proveedor: un límite de solicitudes, un tiempo de espera agotado, credenciales rechazadas o una solicitud demasiado grande para el modelo. Inténtalo más tarde o elige otro modelo.
• "La respuesta del modelo llegó con errores de formato." La respuesta no siguió el formato de Lumbre. Inténtalo de nuevo; si se repite, elige otro modelo.

Por qué npm es una dependencia

La aplicación de escritorio de Alisio ejecuta los plugins dentro de su propio entorno, donde no se garantiza que existan node ni npm. Por eso Lumbre depende de npm 11.9.0 y lo ejecuta con el Node de Alisio. Añade unos 2,4 MB a la descarga y 9,8 MB (1797 archivos) una vez instalado.

Desarrollo

pnpm install
pnpm --filter @alisio/plugin-lumbre test
pnpm --filter @alisio/plugin-lumbre build

LUMBRE_INTEGRATION=1 pnpm --filter @alisio/plugin-lumbre exec vitest run test/integration.test.ts instala, compila y sirve cada base de verdad (requiere red). Después de cambiar una versión fijada, compila y ejecuta node scripts/update-preset-locks.mjs para regenerar los archivos de bloqueo.

Recursos y licencia

Agentes lmb-builder y lmb-agent; habilidades lmb-web, lmb-design, lmb-tailwind, lmb-react-next y lmb-fix (también son las instrucciones de los constructores); herramienta de solo lectura lumbre_projects; las herramientas del borrador lumbre_list_files, lumbre_read_file, lumbre_write_file, lumbre_edit_file, lumbre_delete_file, lumbre_add_dependency, lumbre_progress y lumbre_done (solo funcionan dentro de una construcción de Lumbre y solo cambian su borrador privado); comando help. MIT; las guías de terceros se listan en THIRD_PARTY_NOTICES.md. Los proyectos generados usan las licencias de sus frameworks.