Primeros pasos

Esta guía parte de un proyecto existente, por ejemplo una app Vite o Laravel en ~/Code/miproyecto. ¿No tienes ningún proyecto a mano? Crea uno desde una plantilla.

1. Añade el proyecto

   Arrastra la carpeta a la ventana de Joppa, o haz clic en Añadir un proyecto (atajo N) y elígela.

   Joppa lee la carpeta (scripts de package.json, workspaces, artisan, Docker Compose) y propone un dominio para cada servidor de desarrollo encontrado:

   miproyecto.test       → :5173   vite
   api.miproyecto.test   → :8000   laravel

   Ajusta los subdominios o los puertos si hace falta y confirma. Consulta Añadir un proyecto.

2. Inicia el servidor de desarrollo

   Inícialo como siempre en tu terminal (bun dev, php artisan serve…), o deja que Joppa se encargue: pestaña Procesos (P) › Analizar el proyecto y luego Guardar e iniciar. Consulta Procesos.

3. Abre https://

   Pulsa O en la página del proyecto: se abre https://miproyecto.test, con el candado.

4. Conecta una base de datos

   En Servicios, añade PostgreSQL (o MySQL, MariaDB) e inícialo. Después, en la pestaña Entorno del proyecto (E), haz clic en Usar PostgreSQL: Joppa crea la base de datos del proyecto y muestra el diff del .env antes de escribirlo.

5. Usa el teclado

   ⌘ K abre la paleta: escribe «abrir», «copiar», «iniciar»… Todas las acciones de la app están ahí. Consulta Atajos de teclado.

Y después

• Conceptos: cómo encajan las piezas.
• El comando joppa: lo mismo desde la terminal.
• Servidor MCP: deja que Claude o Cursor inicien tus servicios.