# Документация Layero > Layero — платформа деплоя фронтенда и фуллстек-приложений с серверами в > России. Здесь собрана документация: как AI-агент работает с Layero (навык, > MCP, CLI в JSON-режиме), деплой из репозитория (GitHub, GitVerse, GitLab, > GitFlic, SourceCraft), окружения и превью, runtime-приложения, базы данных > и Data API, домены, тарифы. О самом продукте — https://layero.ru/llms.txt Каждая страница отдаётся и как Markdown: добавьте `.md` к адресу (например https://docs.layero.ru/cli/agents.md). Список страниц с описаниями — https://docs.layero.ru/sitemap.md Английская версия: https://docs.layero.ru/en/llms.txt ## Быстрый старт - [Быстрый старт](https://docs.layero.ru/getting-started/): Поднимите первый сайт на Layero и разберитесь, как устроена платформа. - [Основные концепции](https://docs.layero.ru/getting-started/concepts/): Проект, окружение, деплой, runtime, handle и билд-окружение — словарь, чтобы говорить о Layero одинаково. - [Поддерживаемые фреймворки](https://docs.layero.ru/getting-started/frameworks/): Vite, Next.js, Astro, CRA, Nuxt, SvelteKit, Gatsby — что Layero определяет автоматически и как задать пресет вручную. - [Быстрый старт](https://docs.layero.ru/getting-started/quickstart/): Установите CLI, залогиньтесь и опубликуйте первый сайт за одну команду. Git не нужен. ## AI-агенты - [Как AI-агент работает с Layero](https://docs.layero.ru/agents/): Три пути агента — подключённый репозиторий, папка с кодом, уже опубликованный сайт. Как выбрать путь, чего агент не делает никогда, где лежит навык. - [Подключить агента](https://docs.layero.ru/agents/install/): Команды установки Layero для CLI, навыка, Claude Code, Cursor, Codex и любого MCP-клиента — из одного файла agents-install.json. OAuth для клиентов и LAYERO_TOKEN для CI. - [Инструменты MCP](https://docs.layero.ru/agents/mcp-tools/): Полный список инструментов сервера mcp.layero.ru по группам, какие из них меняют сайт и требуют подтверждения человека, параметры адреса project и read_only. - [Навык layero](https://docs.layero.ru/agents/skill/): Что лежит в навыке LayeroInfra/layero-agents, как его ставить через npx skills или плагины и что npx layero@latest init пишет в AGENTS.md. ## CLI - [CLI](https://docs.layero.ru/cli/): npm-пакет `layero` — деплой и управление проектами из терминала. - [Деплой из AI-агентов](https://docs.layero.ru/cli/agents/): Как Cursor, Claude Code, Aider и другие AI-агенты могут задеплоить сайт через Layero без git-репозитория и без визарда в браузере. - [Команды](https://docs.layero.ru/cli/commands/): Полный список команд layero — init, login, projects, deploy, rollback, deploys list, link, token. - [layero deploy](https://docs.layero.ru/cli/deploy/): Что делает layero deploy, какие у него флаги, как работают авто-детект, .layeroignore и лимиты архива. - [Деплой из GitHub Actions](https://docs.layero.ru/cli/github-actions/): Официальный GitHub Action для деплоя на Layero — токен для CI, сборка артефакта в пайплайне, превью на пулл-реквесты, выходы шага и типовые ошибки. - [Установка и логин](https://docs.layero.ru/cli/install/): Как поставить Layero CLI (npx / project-local / глобально), залогиниться через device-flow и где хранится токен. - [JSON-events схема](https://docs.layero.ru/cli/json-events/): Полный список событий и кодов ошибок, которые Layero CLI эмитит на stdout в JSON-режиме. Канонический справочник для AI-агентов и CI. - [layero promote](https://docs.layero.ru/cli/promote/): Перевести production apex на конкретный деплой — из любой ветки, без пересборки. Плюс one-click rollback на предыдущий production. - [Rollback](https://docs.layero.ru/cli/rollback/): Как вернуть production apex на предыдущий рабочий деплой — командой rollback или точечным promote на нужный commit_sha. ## Деплой и окружения - [Деплой и окружения](https://docs.layero.ru/deploys/): Деплой из GitHub, GitVerse, GitLab, GitFlic и SourceCraft, окружения, preview-URL, переменные окружения и кастомные домены. - [Кастомные домены](https://docs.layero.ru/deploys/custom-domains/): Привяжите купленный домен к проекту — Layero сам выпустит HTTPS-сертификат Let's Encrypt. Без ручного certbot и без шагов в панели Cloudflare. - [Кастомные HTTP-заголовки](https://docs.layero.ru/deploys/custom-headers/): Добавьте свои HTTP response headers (HSTS, X-Frame-Options, CSP и др.) к статическому сайту через файл _headers в сборке. Синтаксис Netlify, поддержка путей и wildcard. - [Переменные окружения](https://docs.layero.ru/deploys/env-vars/): Env vars шифруются AES-256-GCM, доступны на стадии сборки и в runtime-контейнере. - [Окружения, preview и production](https://docs.layero.ru/deploys/environments/): Один стабильный apex на проект, preview-ссылки для веток и явный promote — Vercel-like модель доменов в Layero. - [Подключение репозитория: GitHub, GitVerse, GitLab, GitFlic, SourceCraft](https://docs.layero.ru/deploys/git-providers/): Пять git-провайдеров, из которых Layero собирает сайт по push. Как подключается каждый, что умеет (вебхук, превью веток, архив по коммиту) и где ограничения. - [Деплой из GitHub](https://docs.layero.ru/deploys/github/): Подключите репозиторий — каждый git push будет публиковать новую версию автоматически. - [Деплой из GitVerse](https://docs.layero.ru/deploys/gitverse/): Пошагово — выпустить токен в GitVerse, подключить его к организации Layero, импортировать репозиторий и получить сборку по push. - [layero.json — конфигурация в репозитории](https://docs.layero.ru/deploys/layero-json/): Файл в репозитории задаёт фреймворк, команды сборки и запуска, папку результата, версию Node, тип приложения и раскладку «фронт + бэк». Когда он нужен, полный список ключей, таблица «симптом → что править» и как проверить по логу сборки. - [Страница 404 и SPA-fallback](https://docs.layero.ru/deploys/not-found-404/): Как статический сайт на Layero отдаёт несуществующие URL. Свой 404.html с кодом 404 (Next export, Astro, Hugo) или SPA-fallback на index.html для приложений с клиентским роутингом. Управление через файл _redirects. - [Точки отката и хранение исходников](https://docs.layero.ru/deploys/retention/): Сколько прошлых деплоев Layero хранит для отката, что происходит со старыми ветками и как долго лежат файлы, загруженные без репозитория, и как их скачать. - [Версии Node.js и Python](https://docs.layero.ru/deploys/runtime-versions/): Какие версии поддерживаются, как закрепить нужную и что происходит, когда версия снимается с поддержки. ## Runtime-приложения - [Runtime-приложения](https://docs.layero.ru/runtime/): SSR Next.js, Streamlit, Gradio, Flask и любые приложения с долгоживущим процессом. - [Жизненный цикл и скорость](https://docs.layero.ru/runtime/lifecycle/): Serverless-модель Layero: тёплый ответ ~0.2 с, холодный старт 4–12 с в зависимости от стека, заморозка при простое. Реальные замеры и что они значат для вашего приложения. - [Когда нужен runtime](https://docs.layero.ru/runtime/overview/): SSR Next.js, любой Node-сервер (Express, NestJS, Fastify), любое WSGI/ASGI-приложение на Python (Django, FastAPI, Flask), Streamlit и Gradio — для приложений с долгоживущим процессом. - [Stateless-инвариант](https://docs.layero.ru/runtime/stateless/): Файловая система runtime-контейнера эфемерна. Что НЕ работает (SQLite-запись, файловые сессии) и как делать правильно. ## Data API (бета) - [Что такое Data API](https://docs.layero.ru/data-api/): HTTP-слой над базой проекта Layero — таблицы, функции, вход пользователей, файлы. Совместим с клиентами Supabase. - [Вход пользователей](https://docs.layero.ru/data-api/auth/): Регистрация и вход в приложение на Data API, роль вошедшего, auth.uid() в политиках и обмен сессии панели на сессию базы. - [Пример: Layero Inbox](https://docs.layero.ru/data-api/example-inbox/): Приложение с базой и без бэкенда: Postgres, Data API, вход, приватные файлы и уведомления в Telegram — по шагам, в панели и в CLI. - [Чего нет](https://docs.layero.ru/data-api/limits/): Что не поддержано в Data API и какие есть границы. - [Вход через Яндекс, VK ID и Сбер ID](https://docs.layero.ru/data-api/oauth/): Как подключить вход через внешнего провайдера: шаги у провайдера, адрес возврата, права, кнопка на сайте и что происходит с учёткой. - [Приём с чужого домена](https://docs.layero.ru/data-api/origins/): Как разрешить сайту клиента слать данные в вашу базу, не отдавая ему доступ к базе. - [HTTP из SQL](https://docs.layero.ru/data-api/outbound/): Уведомления в Telegram и вебхуки прямо из функции базы — net.http_post, как pg_net у Supabase. - [Грабли переезда](https://docs.layero.ru/data-api/pitfalls/): Пять мест, на которых чаще всего спотыкаются те, кто переносит проект с Supabase или пишет первое приложение на Data API. - [Таблицы и REST](https://docs.layero.ru/data-api/rest/): Чтение и запись таблиц по HTTP, фильтры PostgREST, выдача доступа роли и политики RLS. - [Функции и RPC](https://docs.layero.ru/data-api/rpc/): Вызов функций базы по HTTP. Схема api — единственная публичная витрина; имена аргументов — публичный контракт. - [Файлы](https://docs.layero.ru/data-api/storage/): Хранилище файлов базы — бакеты, политики на storage.objects, подписанные ссылки и лимиты. Совместимо с supabase.storage. ## Базы данных (бета) - [Базы данных](https://docs.layero.ru/database/): Управляемый PostgreSQL в Layero — общая база из тарифа Pro и выделенная база со своей конфигурацией. Что умеет раздел, чем отличаются размещения, как получить доступ к бета-версии. - [Резервные копии](https://docs.layero.ru/database/backups/): Резервные копии баз Layero — расписание и срок хранения у общей базы, платная опция у выделенной, восстановление кнопкой и скачивание дампа PostgreSQL. - [Базы из CLI](https://docs.layero.ru/database/cli/): Команды layero db — список баз, создание, подключение к проекту и отключение, выполнение SQL из терминала и в CI. Что из терминала сделать нельзя и почему. - [Подключение к базе](https://docs.layero.ru/database/connect/): Строка подключения к базе Layero, режимы сетевого доступа и проверка сертификата сервера (verify-full) для psql, asyncpg, node-pg, Prisma и Drizzle. - [Как завести базу](https://docs.layero.ru/database/create/): Создание базы данных Layero из панели и из CLI — общая база из тарифа Pro или выделенная со своей конфигурацией, версия PostgreSQL, оплата, сколько ждать и что делать при отказе. - [Лимиты](https://docs.layero.ru/database/limits/): Ограничения баз данных Layero — сколько баз, место и что будет при его нехватке, подключения и пул, время запроса, SQL-редактор и layero db sql, резервные копии, доступ по адресам. - [Работа в панели](https://docs.layero.ru/database/panel/): Что есть на странице базы Layero — обзор, мониторинг, таблицы, SQL-редактор, функции, роли, политики RLS, расширения, настройки, подключённые проекты, переименование и удаление. - [Тарификация](https://docs.layero.ru/database/pricing/): Сколько стоят базы данных Layero — общая база в тарифе Pro, цены выделенной базы и произвольной конфигурации, оплата и продление, смена конфигурации, возврат при удалении, что будет при неоплате. ## Page Speed - [Page Speed](https://docs.layero.ru/performance/): Page Speed в Layero — замер скорости страницы в настоящем браузере. Что измеряем, в каких условиях, как читать отчёт и вердикт «стало хуже», расписания, уведомления в Telegram, CLI и тариф. - [Как мы измеряем скорость](https://docs.layero.ru/performance/methodology/): Как устроен аудит производительности Layero — где и как открывается страница, какие метрики мы снимаем, как считается балл Lighthouse, как сравниваются замеры и почему цифры отличаются от PageSpeed Insights. ## Команды и интеграции - [Команды и интеграции](https://docs.layero.ru/team/): Организации, GitHub App, доступ участников. - [Аналитика и 152-ФЗ](https://docs.layero.ru/team/analytics/): Кто отвечает за данные посетителей при подключённой Яндекс.Метрике и выгрузке форм в Google Таблицы, зачем баннер cookie, что делает запись сессий (Вебвизор) и как её включить или выключить. - [GitHub App интеграция](https://docs.layero.ru/team/github-app/): Зачем нужен GitHub App, как установить на personal или organization, в чём отличие от OAuth, как отключить. - [Организации (личная и командная)](https://docs.layero.ru/team/organizations/): Чем отличается личный аккаунт от команды, когда что использовать, как переключаться. ## Тарифы и оплата - [Истечение и продление Pro](https://docs.layero.ru/billing/lifecycle/): Что происходит с проектами, доменами, настройками и общей базой данных, когда подписка Pro заканчивается, и как всё восстанавливается после повторной оплаты. Проекты не удаляются. - [Дополнительное потребление](https://docs.layero.ru/billing/overage/): Как на Pro работать сверх лимитов тарифа: как включить и задать бюджет, как и когда списываем с баланса, что будет, когда бюджет исчерпан или на балансе нет денег. - [Тарифы Free и Pro](https://docs.layero.ru/billing/plans/): Чем отличаются Free и Pro в Layero — лимиты проектов и сборок, кастомные домены, аналитика, места в команде и цены. - [Потребление и лимиты](https://docs.layero.ru/billing/usage/): Что считает страница «Потребление», какие лимиты у Free и Pro, с какого дня они действуют, как устроен расчётный период и что происходит, когда лимит исчерпан. ## Прочее - [Контакты](https://docs.layero.ru/contacts/): Как связаться с командой Layero — виджет поддержки в дашборде, Telegram-бот, почта и GitHub. - [Поддержка](https://docs.layero.ru/support/): Если что-то не работает или непонятно — напишите нам.