> ## Documentation Index
> Fetch the complete documentation index at: https://docs.layeron.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Диагностика

> Частые проблемы Layeron: генерация, preview, Cloud, Storage, Env, домены и лимиты.

## Генерация зависла

Проверьте:

* есть ли активная генерация в проекте
* не была ли закрыта вкладка во время ответа
* хватает ли credits и AI requests
* не слишком ли большой запрос или набор изображений
* не попросили ли вы одновременно слишком много изменений

Что сделать:

<Steps>
  <Step title="Обновите страницу проекта">
    Layeron восстановит актуальное состояние проекта и активную генерацию, если она еще идет.
  </Step>

  <Step title="Проверьте последнее сообщение">
    Если чат уже вернул ошибку, используйте ее текст в следующем запросе.
  </Step>

  <Step title="Разбейте задачу">
    Вместо большого запроса попросите исправить один экран, один компонент или одну ошибку.
  </Step>

  <Step title="Повторите запрос">
    Если генерация завершилась ошибкой, отправьте более короткую и конкретную инструкцию.
  </Step>
</Steps>

## Потерялся stream ответа

Иногда браузер может потерять соединение из-за сети, сна ноутбука или обновления вкладки.

Откройте проект заново. Если генерация еще активна, Layeron должен показать текущее состояние или дать возможность продолжить работу. Если ответ оборвался, отправьте в чат короткое сообщение: `Продолжи с места, где остановился, и проверь текущие файлы проекта`.

## Preview не обновился

Возможные причины:

* сборка еще идет
* браузер показывает кешированную версию
* deploy завершился ошибкой
* проект ушел в hibernation
* изменения были применены в коде, но приложение не перезапустилось

Что сделать:

* дождитесь статуса `deployed`
* обновите страницу preview
* откройте preview в новой вкладке
* проверьте Cloud logs
* попросите чат проверить, почему изменения не видны

## Deploy failed

Откройте вкладку логов и найдите первую понятную ошибку: missing dependency, syntax error, failed build, invalid import, missing env variable, port/start command issue.

Хороший запрос в чат:

```text theme={null}
Deploy упал с ошибкой ниже. Найди причину, исправь код и проверь, что проект снова собирается.

[вставьте только текст ошибки без секретов]
```

<Warning>
  Перед вставкой лога в чат удалите токены, ключи, приватные URL и персональные данные.
</Warning>

## Проект ушел в hibernation

Это нормально для неактивных Cloud-проектов на Free. Откройте preview или нажмите wake up в интерфейсе. Первый запуск после простоя может занять больше времени.

Если после пробуждения статус стал `failed`, проверьте логи и попросите чат исправить ошибку запуска.

## Не загружается файл в Storage

Проверьте:

* тип файла: JPEG, PNG, WebP или GIF
* размер файла: до 10 MB
* не заполнен ли Storage по тарифу
* стабильное ли интернет-соединение
* включен ли Cloud для проекта

Если файл слишком большой, сожмите изображение или конвертируйте его в WebP.

## Env-переменная не видна в приложении

Проверьте:

* имя переменной написано в верхнем регистре
* имя содержит только `A-Z`, `0-9` и `_`
* для frontend-переменной используется `VITE_`, `NEXT_PUBLIC_` или `PUBLIC_`
* проект был перезапущен или redeploy после добавления переменной
* код читает правильное имя переменной

Пример запроса в чат:

```text theme={null}
Я добавил переменную VITE_API_URL в Cloud Env, но приложение ее не использует. Проверь код, найди место чтения env и исправь.
```

## Достигнут лимит проектов или Cloud

Если интерфейс не дает создать новый проект или включить Cloud, проверьте тариф:

* Free: ограничение по проектам и Cloud-проектам
* Pro и Team: больше credits, запросов и ресурсов
* Enterprise: индивидуальные лимиты

Перейдите на страницу тарифов или удалите неиспользуемые проекты, если они больше не нужны.

## Домен не подтверждается

Проверьте DNS-записи у провайдера домена. Убедитесь, что запись добавлена для правильного домена или поддомена, а старые конфликтующие записи удалены.

DNS может обновляться с задержкой. Если вы только что изменили запись, подождите и повторите проверку позже.

## Что писать в поддержку

Чтобы быстрее получить помощь, подготовьте:

* slug проекта
* статус проекта
* что вы пытались сделать
* текст ошибки без секретов
* пример запроса в чат
* ссылку на preview, если ее можно безопасно открыть

<Note>
  Не отправляйте в поддержку пароли, приватные API-ключи, платежные токены и содержимое `.env`.
</Note>