New project from a template

New project (on the home screen, in the ⌘ K palette, or N in the TUI) creates a project from a template, pins its versions, then adds it to Joppa with its domains. No interactive prompts: everything is set in the window.

Templates

Template	Created with	Variants
Vite	vp create (Vite+)	React, Vue, Svelte, Solid, Preact, Lit, no framework (TypeScript)
Vite+ monorepo	vp create vite:monorepo	apps/website and packages/utils
Next.js	create-next-app	App Router, TypeScript, Tailwind, ESLint, src/
Nuxt	create-nuxt	minimal
Astro	create-astro	Minimal, Basics, Blog, Portfolio
SvelteKit	sv create	Minimal, Demo, Library
GitHub repository	copy of the repository	owner/repo, owner/repo#branch or URL; copied without history
Laravel	laravel new or composer create-project	Kit: none, React, Vue, Svelte, Livewire

The JavaScript templates require Vite+.

Options

• Name: lowercase letters, digits and dashes.
• Parent folder: ~/Code by default.
• Packages: bun (default), pnpm, npm or yarn.
• Node: Don’t pin, Latest LTS or a major version.
• Initialize a git repository.

Laravel

• PHP: 8.5, 8.4 (default), 8.3, 8.2 or 8.1. A missing version is downloaded from static-php.dev (≈ 15 MB).
• Database: SQLite (default), PostgreSQL, MySQL or MariaDB. For the last three, choose “Database project in service” (Joppa creates the database in one of your services) or “My own database (nothing to create)”.
• Tests: Pest or PHPUnit.
• Kit’s sign-in pages: unchecking removes authentication.

Creation

Before starting, the window shows the exact commands that will run. During creation, the log scrolls live; Cancel creation stops everything and deletes the folder.

When it’s done, the project is added with its .test domains. A Laravel project gets myproject.test → :8000 (php artisan serve) and a .php-version.