从模板新建项目
创建 Vite+、Next.js、Nuxt、Astro、SvelteKit、Laravel 项目,或从 GitHub 仓库创建项目,并固定其版本、分配域名。
新建项目(在首页、⌘ K 命令面板中,或在 TUI 中按 N)会从模板创建项目,固定其版本,然后将它连同域名一起添加到 Joppa。没有任何交互式提问:一切都在窗口中设置。

模板
| 模板 | 创建方式 | 变体 |
|---|---|---|
| Vite | vp create(Vite+) |
React、Vue、Svelte、Solid、Preact、Lit、无框架(TypeScript) |
| Vite+ monorepo | vp create vite:monorepo |
apps/website 和 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 仓库 | 复制仓库 | 所有者/仓库、所有者/仓库#分支 或 URL;复制时不含历史记录 |
| Laravel | laravel new 或 composer create-project |
套件:无、React、Vue、Svelte、Livewire |
JavaScript 模板需要 Vite+。
选项
- 名称:小写字母、数字和连字符。
- 父文件夹:默认为
~/Code。 - 包管理器:bun(默认)、pnpm、npm 或 yarn。
- Node:不固定、最新 LTS 或某个主版本。
- 初始化 git 仓库。
Laravel
- PHP:8.5、8.4(默认)、8.3、8.2 或 8.1。缺少的版本会从 static-php.dev 下载(≈ 15 MB)。
- 数据库:SQLite(默认)、PostgreSQL、MySQL 或 MariaDB。对于后三种,可选择「服务 中的数据库 项目」(Joppa 在你的某个服务中创建数据库)或「我自己的数据库(无需创建)」。
- 测试:Pest 或 PHPUnit。
- 套件的登录页面:取消勾选会移除身份验证。
创建过程
开始之前,窗口会显示将要运行的确切命令。创建期间,日志会实时滚动;取消创建 会停止一切并删除文件夹。
完成后,项目会连同其 .test 域名一起被添加。Laravel 项目会获得 myproject.test → :8000(php artisan serve)和一个 .php-version。