Первые шаги

Это руководство исходит из существующего проекта, например приложения Vite или Laravel в ~/Code/myproject. Проекта под рукой нет? Создайте его из шаблона.

1. Добавьте проект

   Перетащите папку в окно Joppa или нажмите Добавить проект (сочетание N) и выберите её. Оставьте предложенное имя (из него получается домен myproject.test) и нажмите Добавить и проанализировать.

   Анализ читает папку (joppa.toml, скрипты package.json, workspaces, artisan, Docker Compose, .env) и шаг за шагом предлагает сервисы Joppa вместо собственных сервисов проекта, а затем домен для каждого найденного сервера разработки:

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

   При необходимости поправьте поддомены или порты, затем нажмите Сохранить и запустить. См. Добавить проект.

2. Запустите сервер разработки

   Если вы сохранили анализ кнопкой Сохранить и запустить, это уже сделано. Иначе запустите его как обычно в своём терминале (bun dev, php artisan serve…) или на вкладке Процессы (P) › Запустить всё. См. Процессы.

3. Откройте https://

   Нажмите O на странице проекта: откроется https://myproject.test с замком.

4. Подключите базу данных

   В разделе Сервисы добавьте PostgreSQL (или MySQL, MariaDB) и запустите его. Затем на вкладке Сервисы проекта (V) нажмите Использовать PostgreSQL: Joppa создаст базу данных проекта и покажет diff файла .env перед записью.

5. Перейдите на клавиатуру

   ⌘ K открывает палитру: введите «открыть», «копировать», «запустить»… Там есть все действия приложения. См. Сочетания клавиш.

Что дальше

• Основные понятия: как всё складывается вместе.
• Команда joppa: то же самое из терминала.
• MCP-сервер: пусть Claude или Cursor запускают ваши сервисы.