Новый проект из шаблона
Создание проекта Vite+, Next.js, Nuxt, Astro, SvelteKit, Laravel или из репозитория GitHub, с закреплёнными версиями и доменами.
Новый проект (на главном экране, в палитре ⌘ K или N в TUI) создаёт проект из шаблона, закрепляет его версии, а затем добавляет его в Joppa вместе с доменами. Никаких интерактивных вопросов: всё настраивается в окне.
Шаблоны
| Шаблон | Чем создаётся | Варианты |
|---|---|---|
| Vite | vp create (Vite+) |
React, Vue, Svelte, Solid, Preact, Lit, без фреймворка (TypeScript) |
| Monorepo Vite+ | vp create vite:monorepo |
apps/website и packages/utils |
| Next.js | create-next-app |
App Router, TypeScript, Tailwind, ESLint, src/ |
| Nuxt | create-nuxt |
минимальный |
| Astro | create-astro |
Minimal, Базовый, Blog, Portfolio |
| SvelteKit | sv create |
Minimal, Демо, Библиотека |
| Репозиторий GitHub | копия репозитория | владелец/репозиторий, владелец/репозиторий#ветка или URL; копируется без истории |
| Laravel | laravel new или composer create-project |
Kit: без набора, React, Vue, Svelte, Livewire |
Шаблоны JavaScript работают через Vite+, который Joppa устанавливает при первом запуске. Если он ещё устанавливается, окно сообщает об этом, и шаблоны становятся доступны, как только он будет готов.
Параметры
- Имя: строчные буквы, цифры и дефисы.
- Родительская папка: по умолчанию
~/Code. - Пакеты: bun (по умолчанию), pnpm, npm или yarn.
- Node: Не закреплять, Последняя LTS (с номером и названием линейки, например
24.22.0 Krypton) или мажорная версия; самая новая линейка, ещё без названия, помечена Current. - Инициализировать git-репозиторий. На новом Mac git ещё нет (он входит в инструменты командной строки Apple): окно сообщает об этом, и проект создаётся без репозитория. Установить git открывает окно установки Apple; когда установка завершится (несколько минут), Joppa сам обнаружит git.
Laravel
- PHP: 8.5, 8.4, 8.3, 8.2 или 8.1, закрепляется в
.php-versionпроекта. Joppa предлагает свою версию по умолчанию, иначе самую новую из уже имеющихся, иначе просто самую новую, и объясняет выбор под списком. Отсутствующая версия скачивается с static-php.dev (≈ 15 МБ). - База данных: SQLite (по умолчанию), PostgreSQL, MySQL или MariaDB. Для трёх последних выберите «База данных проект в сервис» (Joppa создаёт базу в одном из ваших сервисов) или «Своя база данных (ничего не создавать)».
- Тесты: Pest или PHPUnit.
- Создать также тестовую базу (если база в сервисе; отмечено по умолчанию): Joppa создаёт
<проект>_testв том же сервисе и связывает с нейphpunit.xml, чтобы тесты никогда не очищали базу приложения. См. Тестовая база данных. - Страницы входа из kit: если снять отметку, аутентификация не добавляется.
Создание
Перед запуском окно показывает точные команды, которые будут выполнены. Во время создания журнал прокручивается в реальном времени; Отменить создание останавливает всё и удаляет папку.
С pnpm зависимости со скриптом сборки (например, esbuild) не блокируют создание: Joppa затем одобряет их командой pnpm approve-builds --all, которая записывает их в pnpm-workspace.yaml (allowBuilds). Поэтому pnpm install, запущенный в проекте позже, проходит без «Ignored build scripts».
В конце проект добавляется со своими доменами .test. Проект Laravel получает myproject.test → :8000 (php artisan serve) и .php-version.
Если предусмотренный порт уже прослушивается на компьютере или зарезервирован другим проектом Joppa (одним из его доменов или процессов, даже остановленных), проект получает первый следующий свободный порт (:8001 вместо :8000).