# Карта документации Layero

Каждая страница доступна и как Markdown — тот же адрес с `.md` на конце.


- [Что такое Layero](https://docs.layero.ru/): Layero собирает и публикует сайты и приложения на серверах в России — из репозитория, из папки или через AI-агента. Свои домены, превью веток, приложения с сервером, базы Postgres.
- [Контакты](https://docs.layero.ru/contacts/): Как связаться с командой Layero — чат поддержки в панели, почта support@layero.ru, Telegram-бот и GitHub. Первый ответ — в течение трёх рабочих часов.
- [Поддержка](https://docs.layero.ru/support/)

## Начало

- [Как всё устроено](https://docs.layero.ru/getting-started/concepts/): Организация, проект, окружение, сборка и основной адрес — из чего состоит Layero и как эти части связаны. Статический сайт и приложение с сервером, плашка «Сделано на Layero».
- [Первый сайт](https://docs.layero.ru/getting-started/quickstart/): Опубликуйте сайт из папки одной командой — без репозитория. Вход по коду из письма или через Яндекс ID, сборка на стороне Layero, адрес сразу после сборки.

## AI-агенты

- [Как AI-агент работает с Layero](https://docs.layero.ru/agents/): Агент публикует и обслуживает сайт сам — через подключённый репозиторий, CLI или MCP. Три пути агента, вход в один клик, сайт без аккаунта, чего агент не делает.
- [Отчёты агентов о документации](https://docs.layero.ru/agents/feedback/): Как AI-агент сообщает Layero об ошибке в документации, что входит в отчёт и чего в нём не бывает. Правила и шаблон для агентов — на английском.
- [Подключить агента](https://docs.layero.ru/agents/install/): Команды установки навыка и MCP-сервера Layero для Claude Code, Cursor, Codex и любого агента. Вход через браузер, токен LAYERO_TOKEN для CI и плагина Claude Code, проверка подключения.
- [Инструменты MCP](https://docs.layero.ru/agents/mcp-tools/): Все инструменты сервера mcp.layero.ru по группам — какие меняют сайт и требуют согласия человека, что работает без входа, как ограничить подключение одним проектом или только чтением.
- [Навык layero](https://docs.layero.ru/agents/skill/): Что лежит в навыке LayeroInfra/layero-agents, как его поставить и что команда npx layero@latest init дописывает в AGENTS.md проекта.
- [JSON-события CLI](https://docs.layero.ru/cli/json-events/): Полный список событий и кодов ошибок, которые Layero CLI эмитит на stdout в JSON-режиме. Канонический справочник для AI-агентов и CI.

## Сборка

- [Переменные окружения](https://docs.layero.ru/deploys/env-vars/): Как задать переменные окружения проекта в панели, через CLI и API, когда они начинают действовать, какие переменные ставит платформа и какие ограничения есть.
- [layero.json — конфигурация в репозитории](https://docs.layero.ru/deploys/layero-json/): Файл в репозитории задаёт фреймворк, команды сборки и запуска, папку результата, версию Node, тип приложения и раскладку «фронт + бэк». Когда он нужен, полный список ключей, таблица «симптом → что править» и как проверить по логу сборки.
- [Версии Node.js и Python](https://docs.layero.ru/deploys/runtime-versions/): Какие версии Node.js и Python поддерживает Layero, какая берётся по умолчанию, как закрепить свою и что будет, если указать неподдерживаемую.
- [Фреймворки](https://docs.layero.ru/getting-started/frameworks/): Какие фреймворки Layero определяет сам и где ищет результат сборки, как отличает статический сайт от приложения с сервером, какой пакетный менеджер берёт и как задать фреймворк вручную.

## Деплой

- [Из папки через CLI](https://docs.layero.ru/cli/deploy/): Как опубликовать папку командой layero deploy — без репозитория. Что происходит при загрузке, куда она попадает, флаги, что не отправляется, лимиты сборки и режим JSON.
- [Из GitHub Actions](https://docs.layero.ru/cli/github-actions/): Официальный GitHub Action для публикации на Layero — токен для CI, сборка в пайплайне, почему превью пулл-реквестов даёт подключённый репозиторий, выходные данные шага и типовые ошибки.
- [Откат и выбор сборки](https://docs.layero.ru/cli/rollback/): Как вернуть прошлую сборку на основной адрес или выложить любую готовую сборку — кнопками в панели и командами layero rollback и layero promote.
- [Окружения и превью](https://docs.layero.ru/deploys/environments/): Основной адрес проекта и превью веток, как сборка становится основной, сколько превью работает одновременно, откат и страница «Сайт скоро появится».
- [Подключение репозитория](https://docs.layero.ru/deploys/git-providers/): Как подключить репозиторий на GitHub, GitVerse, GitLab, GitFlic или SourceCraft, чем провайдеры отличаются и что происходит после пуша.
- [GitHub](https://docs.layero.ru/deploys/github/): Как подключить репозиторий с GitHub через GitHub App, что происходит после пуша в основную и в другие ветки и как публиковать вручную.
- [GitVerse](https://docs.layero.ru/deploys/gitverse/): Как выпустить токен в GitVerse, подключить его к организации Layero и импортировать репозиторий. Чем GitVerse отличается от GitHub.
- [Хранение сборок](https://docs.layero.ru/deploys/retention/): Сколько готовых сборок Layero хранит для отката, что происходит со старыми ветками, как вернуться к старой версии и как скачать исходники загрузки.

## Адреса

- [Свой домен](https://docs.layero.ru/deploys/custom-domains/): Как подключить свой домен к проекту на Pro — какие записи DNS добавить, как Layero выпускает сертификат, что делать с записями прежнего хостинга и что будет с доменом, если Pro закончится.
- [HTTP-заголовки](https://docs.layero.ru/deploys/custom-headers/): Как добавить статическому сайту свои HTTP-заголовки файлом _headers — синтаксис, какие пути поддерживаются, какие заголовки задать нельзя и как проверить результат.
- [Страница 404 и переадресации](https://docs.layero.ru/deploys/not-found-404/): Что Layero отвечает на адрес, которого нет в сборке, как работают чистые адреса и SPA, как задать свою страницу 404 и переадресации в файле _redirects.

## Приложения с сервером

- [Запуск и простой](https://docs.layero.ru/runtime/lifecycle/): Как приложение с сервером замораживается, засыпает и просыпается по первому запросу, что это значит для вашего кода, какие ресурсы даёт тариф и за какое время вы платите.
- [Когда нужно приложение с сервером](https://docs.layero.ru/runtime/overview/): Next.js с серверной отрисовкой, серверы на Node.js (Express, NestJS, Fastify) и Python (Django, FastAPI, Flask), Streamlit и Gradio — какие типы приложений бывают, как задать тип и что нужно от приложения.
- [Файлы и состояние](https://docs.layero.ru/runtime/stateless/): Диск приложения с сервером временный. Что из-за этого не работает — запись в SQLite, файловые сессии, загрузки на диск — и где хранить данные, файлы и сессии.

## Базы данных (бета)

- [Базы данных](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, цены выделенной базы и произвольной конфигурации, почасовое списание с баланса, смена конфигурации, удаление и что будет, если на балансе не хватит денег.

## 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.

## Скорость и аналитика

- [Page Speed](https://docs.layero.ru/performance/): Page Speed в Layero — замер скорости страницы в настоящем браузере. Что измеряем, в каких условиях, как читать отчёт и вердикт «стало хуже», расписания, уведомления в Telegram, CLI и тариф.
- [Как мы измеряем скорость](https://docs.layero.ru/performance/methodology/): Как устроен аудит производительности Layero — где и как открывается страница, какие метрики мы снимаем, как считается балл Lighthouse, как сравниваются замеры и почему цифры отличаются от PageSpeed Insights.
- [Аналитика и 152-ФЗ](https://docs.layero.ru/team/analytics/): Кто отвечает за данные посетителей при подключённой Яндекс.Метрике и выгрузке форм в Google Таблицы, зачем баннер cookie, что делает запись сессий (Вебвизор) и как её включить или выключить.

## Справочник CLI

- [Все команды](https://docs.layero.ru/cli/commands/): Справочник команд Layero CLI — публикация, проекты и окружения, откат, логи и диагностика, переменные, домены, базы и Data API, аналитика, скорость, хуки, токены. Общие флаги и переменные окружения CLI.
- [Установка и вход](https://docs.layero.ru/cli/install/): Как запускать Layero CLI через npx layero@latest, войти в браузере по коду из письма или через Яндекс ID, где хранится вход и какой токен нужен для CI.

## Команды и интеграции

- [GitHub App интеграция](https://docs.layero.ru/team/github-app/): Зачем нужен GitHub App, как установить на personal или organization, в чём отличие от OAuth, как отключить.
- [Организации (личная и командная)](https://docs.layero.ru/team/organizations/): Чем отличается личный аккаунт от команды, когда что использовать, как переключаться.

## Тарифы и оплата

- [Баланс и продление](https://docs.layero.ru/billing/lifecycle/): Как пополнить баланс организации и настроить автопополнение, как продлевается подписка, что будет после пробного периода, льготный период, что приостанавливается после перехода на Free и как всё возвращается. Удаление аккаунта и деньги на балансе.
- [Дополнительное потребление](https://docs.layero.ru/billing/overage/): Как на Pro работать сверх лимитов тарифа: как включить и задать бюджет, как и когда списываем с баланса, что будет, когда бюджет исчерпан или на балансе нет денег.
- [Тарифы Free и Pro](https://docs.layero.ru/billing/plans/): Чем отличаются Free и Pro — проекты, сборки, свои домены, индексация, приложения с сервером, общая база, места для коллег. Цены, пробный период и как перейти с тарифа на тариф.
- [Потребление и лимиты](https://docs.layero.ru/billing/usage/): Что считает страница «Потребление», какие лимиты у Free и Pro, с какого дня они действуют, как устроен расчётный период и что происходит, когда лимит исчерпан.
