快速上手

本指南从一个现有项目开始，例如 ~/Code/myproject 中的一个 Vite 或 Laravel 应用。手头没有项目？从模板创建一个。

1. 添加项目

   把文件夹拖到 Joppa 窗口中，或点击 添加项目（快捷键 N）并选择它。

   Joppa 会读取文件夹（package.json 脚本、workspaces、artisan、Docker Compose），并为找到的每个开发服务器推荐一个域名：

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

   如有需要，调整子域名或端口，然后确认。参见 添加项目。

2. 启动开发服务器

   像平常一样在终端中启动它（bun dev、php artisan serve…），或交给 Joppa：进程 标签页（P）› 分析项目，然后 保存并启动。参见 进程。

3. 打开 https://

   在项目页面按 O：https://myproject.test 会打开，并显示锁形图标。

4. 接入数据库

   在 服务 中添加 PostgreSQL（或 MySQL、MariaDB）并启动它。然后在项目的 环境 标签页（E）中点击 使用 PostgreSQL：Joppa 会创建项目的数据库，并在写入 .env 之前显示 diff。

5. 用键盘操作

   ⌘ K 打开命令面板：输入「打开」「复制」「启动」……应用的所有操作都在这里。参见 键盘快捷键。

下一步

• 概念：各个部分如何协同工作。
• joppa 命令：在终端中做同样的事。
• MCP 服务器：让 Claude 或 Cursor 为你启动服务。