Перейти к основному содержимому

Быстрый старт

За 30 секунд опубликуем локальный фронтенд через CLI. Git и GitHub не требуются — Layero заливает локальную директорию напрямую. Если хочется автодеплой по git push — это уже Day-N апгрейд, см. Деплой из GitHub.

1. Запустите CLI​

Установка не нужна — используйте npx:

cd my-site
npx layero@latest init

Команда определит ваш фреймворк (Next / Vite / Astro / SvelteKit / Nuxt / Gatsby / CRA / Docusaurus / static HTML) и создаст .layero/project.json.

Требуется Node.js ≥ 20. Если предпочитаете локальную установку:

npm install -D layero

2. Залогиньтесь​

npx layero login

Команда напечатает URL вида https://app.layero.ru/cli?code=ABCD-1234 и (если запущена в обычном терминале) откроет его в браузере. В браузере выбираете провайдера — GitHub или Яндекс ID, аккаунт в Layero создаётся автоматически при первом OAuth — и жмёте «Разрешить доступ». CLI получит токен в течение пары секунд и сохранит его в ~/.layero/config.json (chmod 600).

:::tip CLI на одной машине, браузер на другой Это device-flow (как gh auth login или AppleTV). CLI не открывает локальный HTTP-сервер — обмен идёт через api.layero.ru. Поэтому логин работает из SSH, Docker-контейнера, песочницы Cursor и где угодно ещё — лишь бы был интернет. :::

3. Задеплойте​

npx layero deploy

CLI:

  1. Авто-детектит фреймворк и заполняет build_cmd / output_dir (если они ещё не заданы).
  2. Упакует папку в tar.gz, уважая .gitignore и .layeroignore (см. layero deploy).
  3. Зальёт архив в Yandex Object Storage.
  4. Запустит сборку на стороне платформы.
  5. Стримит логи в терминал, в конце печатает preview URL.

Первый деплой создаст проект и сохранит ссылку на него в ./.layero/project.json — последующие layero deploy уйдут в тот же проект.

4. Откройте сайт​

После завершения сборки сайт будет доступен на https://<organization>-<project>.layero.ru. Например, для пользователя vasya (его персональная организация — vasya) и проекта my-site — https://vasya-my-site.layero.ru.

:::tip Apex прогревается 5–15 мин — preview работает сразу При первом деплое в новом проекте apex <org>-<project>.layero.ru прогревается 5–15 минут (YC CDN выпускает per-host LE-сертификат). Пока он ещё не готов, шерьте preview-URL вида https://<org>-<project>-cli.preview.layero.ru — доступен через ~30 секунд после успешной сборки. Все последующие promote'ы apex'а — моментальные. Подробнее — в Окружения, preview и production. :::

5. Поменяли код — снова layero deploy​

# отредактировали что-то в редакторе (или AI-агент это сделал)
npx layero deploy
# → новый preview URL на ту же CLI-pseudo-ветку

layero deploy по умолчанию приземляется в preview (псевдо-ветку cli), apex остаётся нетронутым. Чтобы выкатить в production:

# auto-promote default-ветки (то же что push в main)
npx layero deploy --prod

# или явно: собрать и сразу промоутнуть на apex
npx layero deploy --promote

См. layero promote для подробностей о production-флоу.

Что дальше​