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

# Git интеграция

> Как экспортировать проект в GitHub/GitLab, синхронизировать код и настраивать webhook.

## Зачем нужна Git-интеграция

Git-интеграция позволяет:

* хранить код проекта в вашем репозитории
* отслеживать изменения через коммиты
* использовать воркфлоу с pull requests
* синхронизировать код между Layeron и внешним репозиторием
* делать backup проекта

## Подключение Git-провайдера

### GitHub

<Steps>
  <Step title="Установите GitHub App">
    Откройте настройки проекта и нажмите "Connect GitHub". Следуйте инструкциям по установке GitHub App.
  </Step>

  <Step title="Авторизуйте доступ">
    Подтвердите доступ к нужным репозиториям.
  </Step>

  <Step title="Выберите репозиторий">
    Выберите существующий репозиторий или создайте новый.
  </Step>
</Steps>

### GitLab

<Steps>
  <Step title="Подключите GitLab">
    Откройте настройки проекта и нажмите "Connect GitLab".
  </Step>

  <Step title="Введите Personal Access Token">
    Создайте PAT в настройках GitLab с правами `api` и `read_repository`.
  </Step>

  <Step title="Выберите репозиторий">
    Выберите репозиторий для синхронизации.
  </Step>
</Steps>

### GitVerse

Поддерживается аналогично GitLab через Personal Access Token.

## Экспорт проекта

Экспорт отправляет текущее состояние проекта в Git-репозиторий.

<Steps>
  <Step title="Откройте настройки проекта">
    Перейдите в вкладку Git или используйте меню проекта.
  </Step>

  <Step title="Нажмите Export">
    Выберите "Export to GitHub" или другой провайдер.
  </Step>

  <Step title="Подтвердите экспорт">
    Layeron создаст коммит со всеми файлами проекта и отправит в репозиторий.
  </Step>
</Steps>

## Синхронизация кода

Синхронизация позволяет двусторонний обмен изменениями между Layeron и Git-репозиторием.

### Из Layeron в Git

После каждой генерации или исправления в чате изменения автоматически коммитятся в подключенный репозиторий (если включена авто-синхронизация).

### Из Git в Layeron

Если вы внесли изменения в репозиторий вне Layeron, вы можете импортировать их:

<Steps>
  <Step title="Откройте настройки Git">
    Перейдите в настройки проекта → Git.
  </Step>

  <Step title="Нажмите Sync">
    Layeron загрузит последние изменения из репозитория.
  </Step>

  <Step title="Проверьте preview">
    Изменения отобразятся в preview после синхронизации.
  </Step>
</Steps>

## Webhook автоматизация

Layeron может автоматически синхронизироваться при пуше в репозиторий через webhook.

### Настройка webhook

Webhook настраивается автоматически при подключении GitHub App. Для ручной настройки:

1. Откройте настройки репозитория → Webhooks
2. Добавьте webhook с URL: `https://layeron.ru/api/v1/webhooks/github`
3. Выберите события: `push`, `pull_request`
4. Укажите секрет для верификации

## Версионирование

Layeron сохраняет версии проекта при каждой значимой генерации.

### Просмотр версий

Откройте вкладку Version History в проекте, чтобы увидеть список сохраненных версий.

### Восстановление версии

<Steps>
  <Step title="Выберите версию">
    Откройте Version History и найдите нужную версию.
  </Step>

  <Step title="Нажмите Restore">
    Layeron восстановит файлы проекта из выбранной версии.
  </Step>

  <Step title="Проверьте preview">
    Убедитесь, что восстановленные файлы работают корректно.
  </Step>
</Steps>

<Tip>
  Регулярно экспортируйте важные проекты в Git. Это защитит от потери данных и позволит работать с кодом в привычном редакторе.
</Tip>

## Частые вопросы

### Можно ли подключить несколько репозиториев?

Один проект может быть подключен к одному Git-репозиторию. Для разных репозиториев создайте отдельные проекты.

### Что происходит при конфликте?

Если изменения в Layeron и Git конфликтуют, Layeron предложит выбрать, какие изменения сохранить.

### Как отключить Git-интеграцию?

Откройте настройки проекта → Git и нажмите "Disconnect". Файлы проекта останутся в Layeron.