Nuevo proyecto desde una plantilla

Nuevo proyecto (en el inicio, en la paleta ⌘ K, o N en el TUI) crea un proyecto desde una plantilla, fija sus versiones y luego lo añade a Joppa con sus dominios. Sin preguntas interactivas: todo se configura en la ventana.

Las plantillas

Plantilla	Creada con	Variantes
Vite	vp create (Vite+)	React, Vue, Svelte, Solid, Preact, Lit, sin framework (TypeScript)
Monorepo Vite+	vp create vite:monorepo	apps/website y packages/utils
Next.js	create-next-app	App Router, TypeScript, Tailwind, ESLint, src/
Nuxt	create-nuxt	mínima
Astro	create-astro	Minimal, Basics, Blog, Portfolio
SvelteKit	sv create	Minimal, Demo, Library
Repositorio de GitHub	copia del repositorio	propietario/repositorio, propietario/repositorio#rama o URL; se copia sin el historial
Laravel	laravel new o composer create-project	Kit: ninguno, React, Vue, Svelte, Livewire

Las plantillas de JavaScript pasan por Vite+, que Joppa instala en el primer arranque. Si aún se está instalando, la ventana lo indica y las plantillas se activan en cuanto está listo.

Las opciones

• Nombre: minúsculas, números y guiones.
• Carpeta principal: ~/Code por defecto.
• Paquetes: bun (por defecto), pnpm, npm o yarn.
• Node: No fijar, Última LTS o una versión mayor.
• Inicializar un repositorio git. En un Mac nuevo, git todavía no está (viene con las herramientas de línea de comandos de Apple): la ventana lo indica y el proyecto se crea sin repositorio. Instalar git abre la ventana de instalación de Apple; cuando termina (unos minutos), Joppa detecta git por sí solo.

Laravel

• PHP: 8.5, 8.4 (por defecto), 8.3, 8.2 u 8.1. Si falta una versión, se descarga de static-php.dev (≈ 15 MB).
• Base de datos: SQLite (por defecto), PostgreSQL, MySQL o MariaDB. Para las tres últimas, elige «Base proyecto en servicio» (Joppa crea la base de datos en uno de tus servicios) o «Mi propia base de datos (nada que crear)».
• Tests: Pest o PHPUnit.
• Páginas de inicio de sesión del kit: desmarcarlo quita la autenticación.

La creación

Antes de empezar, la ventana muestra los comandos exactos que se van a ejecutar. Durante la creación, el registro avanza en directo; Cancelar la creación lo detiene todo y elimina la carpeta.

Con pnpm, las dependencias que tienen un script de build (esbuild, por ejemplo) no bloquean la creación: Joppa las aprueba después con pnpm approve-builds --all, que las anota en pnpm-workspace.yaml (allowBuilds). Así, un pnpm install lanzado más tarde en el proyecto pasa sin «Ignored build scripts».

Al terminar, el proyecto se añade con sus dominios .test. Un proyecto Laravel recibe miproyecto.test → :8000 (php artisan serve) y un .php-version.