Empieza aquí
Instalar y abrir Luvin
Requisitos, cómo usar Luvin en el navegador o como app de escritorio, cómo generar los instaladores y qué cambia entre las dos versiones.
Luvin corre en tu equipo, en el navegador o como app de escritorio. No hay backend ni cuenta.
npm install # una veznpm run dev # navegador: abre http://localhost:5173npm run desktop:dev # app de escritorioRequisitos
Sección titulada «Requisitos»- Node.js 20.19 o posterior, o 22.12 o posterior. Revisa con
node --version. - npm, que viene con Node.js.
- La carpeta del proyecto de Luvin en tu equipo.
Inicia Luvin
Sección titulada «Inicia Luvin»-
Abre una terminal en la carpeta del proyecto de Luvin.
-
Instala las dependencias (una sola vez):
Ventana de terminal npm install -
Inicia la app:
Ventana de terminal npm run dev -
Abre
http://localhost:5173en tu navegador.
Aparece la pantalla de bienvenida. Para publicarla para tu equipo, ejecuta npm run build: genera un sitio estático en dist/ que cualquier servidor web puede servir.
-
Abre una terminal en la carpeta del proyecto de Luvin.
-
Ejecuta
npm installsi todavía no lo hiciste. -
Inicia la app:
Ventana de terminal npm run desktop:dev
Se abre una ventana de Luvin con la misma pantalla de bienvenida.
Genera los instaladores
Sección titulada «Genera los instaladores»-
En la carpeta del proyecto, ejecuta:
Ventana de terminal npm run desktop:build -
Abre la carpeta
release/. Ahí queda el instalador.
| Sistema | Qué se genera |
|---|---|
| macOS | Un .dmg y un .zip |
| Windows | Un instalador (NSIS) |
| Linux | Un AppImage |
Abre un instalador sin firmar
Sección titulada «Abre un instalador sin firmar»Los instaladores todavía no están firmados, así que tu sistema te avisa la primera vez.
- Arrastra Luvin a Aplicaciones y ábrela. macOS dice que no puede verificar la app. Cierra el aviso.
- Abre Ajustes del Sistema → Privacidad y seguridad y baja hasta Seguridad.
- Junto al mensaje sobre Luvin, haz clic en Abrir igualmente y confirma con tu contraseña.
Solo hace falta la primera vez. Desde macOS Sequoia (15), hacer clic derecho en la app y elegir Abrir ya no salta el aviso.
- Ejecuta el instalador.
- En el aviso, haz clic en Más información.
- Haz clic en Ejecutar de todas formas.
Navegador o escritorio
Sección titulada «Navegador o escritorio»Las dos tienen la misma interfaz. Las diferencias vienen de lo que permite un navegador.
| Navegador | App de escritorio | |
|---|---|---|
| CORS | La API debe permitir el origen de la app | No aplica |
Parámetros en cookie y el header Host |
No se envían: los navegadores no lo permiten | Se envían |
| Cookies que ponen tus APIs | Las maneja el navegador. Luvin no puede leerlas | Las guarda Luvin, que las muestra y las administra |
| Requests gRPC | No disponibles | Disponibles |
| Autorización NTLM | No disponible | Disponible |
| Terminal en Dev Tools | No disponible | Disponible |
| Dónde se guarda un workspace | Almacenamiento del navegador, o una carpeta del disco en Chrome y Edge | Una carpeta del disco |
| Secretos | Cifrados en el navegador con WebCrypto | Cifrados con el llavero del sistema operativo |
Si la API que pruebas no permite CORS y no puedes cambiarlo, usa la app de escritorio.
CORS en la versión de navegador
Sección titulada «CORS en la versión de navegador»CORS es una regla de los navegadores: una página web solo puede llamar a una API de otra dirección si esa API lo permite. En el navegador Luvin es una página web, así que la regla aplica a cada llamada.
La API que pruebas debe:
- permitir el origen de la app, por ejemplo
http://localhost:5173; - incluir en
Access-Control-Allow-Headerslos headers que envían tus workflows.
Cuando una llamada queda bloqueada, Luvin muestra los headers exactos que hay que pedir. Consulta Solución de problemas. La app de escritorio envía los requests ella misma, así que CORS no aplica.