Ayuda

¿Buscas un paso a paso completo? Mira el Manual de Monad.

Guías breves de las funciones que la aplicación Monad abre desde botones como "¿Necesitas ayuda?" y "Ver la guía de solución de problemas".

Actualizar Monad

La versión 1.25.29 trae la nueva identidad azul, iconos renovados, una página de inicio más ordenada y la versión visible en la barra de título.

1. En la aplicación instalada, abre Cuenta (el icono de persona en el menú) y haz clic en Buscar actualizaciones.
2. Espera la descarga y elige Reiniciar para actualizar.
3. Tras el reinicio, comprueba la versión en la barra de título.

El Monad instalado en Windows también busca actualizaciones automáticamente cada hora. Si todavía no has instalado la aplicación, descarga el instalador actual para Windows de 64 bits. Ejecutar una copia de desarrollo o un ejecutable sin instalar no activa este flujo.

GitHub

Conecta Monad con GitHub en la configuración de la app para publicar el código y mantener un repositorio sincronizado.

Solución de problemas

• Si la conexión falla, desconecta y vuelve a conectar; el código de autorización caduca en pocos minutos.
• Si se rechaza el envío, comprueba que el repositorio exista, que tengas permiso de escritura y que la rama elegida sea la correcta.
• Si hay un conflicto con lo que ya está en GitHub, resuélvelo o elige otra rama antes de enviar.
• Monad muestra el texto completo del error cuando viene de Git; cópialo al pedir ayuda.

App para móvil (Capacitor)

El botón "Actualizar a app híbrida con Capacitor" añade Capacitor a tu proyecto, para que funcione en iOS y Android además de en la web. Para hacerlo a mano, instala @capacitor/core, @capacitor/cli y las plataformas que quieras, y luego ejecuta npx cap init y npx cap add android (o ios).

Solución de problemas

• Para Android hace falta Android Studio; para iOS, un Mac con Xcode.
• Después de cambiar el código web, genera la versión de producción y ejecuta npx cap sync antes de abrir el proyecto nativo.
• Si el proyecto nativo no se abre, confirma que las herramientas de la plataforma estén instaladas y en el PATH.

Seleccionar un componente para editar

La actualización "Activar selección de componentes" instala el plugin de Vite que marca cada componente de la vista previa. Así haces clic en lo que quieres cambiar y Monad sabe exactamente qué archivo y qué línea editar. Para instalarlo a mano, añade el plugin de Monad a vite.config e instala sus dependencias; el botón lo hace por ti y es la forma recomendada.

Migrar a la versión actual de pnpm

Monad usa su propio pnpm, que escribe el archivo de bloqueo (pnpm-lock.yaml) en un formato que las versiones antiguas de pnpm no leen. Si tu app todavía declara un pnpm antiguo en packageManager, el aviso aparece en la consola. La migración actualiza packageManager y el lockfile juntos, para que la vista previa, el CI y quien descargue el proyecto usen la misma versión.

• Antes de migrar, haz un commit con el estado actual.
• Si publicas la app en otro sitio, actualiza allí también la versión de pnpm.

Migración de base de datos (plantilla Portal)

"Generar migración de base de datos" crea un nuevo archivo de migración a partir de los cambios en el esquema y lo guarda en un commit. Revisa el archivo generado antes de aplicarlo a una base de datos con datos reales.

Revisión de seguridad

La revisión de seguridad lee el código de la app y lista los hallazgos por gravedad (crítico, alto, medio, bajo). Usa "Corregir" para pedirle a Monad que resuelva los hallazgos seleccionados. Trata el resultado como un apoyo, no como una auditoría completa: los secretos, las políticas de base de datos y los permisos merecen una revisión humana.

Restaurar los ajustes desde una copia de seguridad

Si Monad avisa de que no pudo leer el archivo de ajustes y volvió a los valores predeterminados, los datos anteriores no se borraron. Cierra Monad y ve a su carpeta de datos (en Windows, %APPDATA%\Monad). Allí están:

• user-settings.json, el archivo actual;
• user-settings.json.bak, la copia anterior;
• archivos user-settings.json.recovery-…bak, guardados cuando Monad tuvo que recuperar el archivo.

Copia la copia de seguridad que quieras sobre user-settings.json (guarda antes una copia del archivo actual) y vuelve a abrir Monad.