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

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

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

Кода ещё нет?

Эта страница про публикацию готового проекта. Если сайта пока не существует и хочется собрать его с нуля прямо в чате IDE — это другой инструмент: плагин @layero для Cursor, Claude Code и Codex. Описываете идею одной фразой, отвечаете на два-три коротких вопроса, получаете готовую страницу и сразу публикуете.

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@latest login

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

CLI на одной машине, браузер на другой

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

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

npx layero@latest 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. Откройте сайт​

После завершения сборки CLI напечатает адрес сайта — открывайте его. Сайт живой сразу: ждать прогрева хоста не нужно.

Какой адрес получит проект

Пользовательские сайты живут в отдельной зоне — layero.app. Новый проект получает адрес из одного слага: https://my-site.layero.app. У проектов, созданных до переезда (26 июля 2026), в адресе остался префикс организации — https://vasya-my-site.layero.app.

Точный адрес печатает CLI и показывает дашборд — не собирайте его по шаблону. Подробнее — в Окружения, preview и production.

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

# отредактировали что-то в редакторе (или AI-агент это сделал)
npx layero@latest deploy
# → новая сборка снова публикуется на production-адрес проекта

Для CLI-проекта (без подключённого репозитория) каждый layero deploy публикуется в apex автоматически — прямые загрузки авто-промоутятся, отдельный --prod или promote не нужен.

--branch в layero deploy не работает

Флаг принимается и молча игнорируется: архивные загрузки бэкенд всегда кладёт в зарезервированное окружение cli — чтобы ручная загрузка не столкнулась с веткой подключённого репозитория (projects.py:2865). Проверено опытом: после layero deploy --branch=probe окружение probe не создаётся.

Что это значит на практике:

  • Проект без репозитория. cli у него и есть ветка по умолчанию, поэтому деплой авто-промоутится на апекс. Каждый layero deploy заменяет живой сайт, и способа загрузить непромоутящую версию из CLI нет.
  • Проект с подключённым репозиторием. cli — не дефолтная ветка, поэтому CLI-загрузка живёт на отдельном адресе <проект>-cli и апекс не двигает (пока не передан --prod).

Превью веток — это git-путь: пуш в ветку создаёт окружение через вебхук.

См. layero promote и Окружения для production-флоу git-проектов.

Что дальше​