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

# Создание и публикация

> Создание приложений с помощью ИИ, итерация на живом превью и развертывание в production.

## Создание приложения

Два способа:

* **Попросить ИИ** — опишите, что вам нужно, в потоке, и ИИ создаст приложение
* **Кнопка нового приложения** — нажмите **+** в боковой панели Drive и выберите **New app**

ИИ выбирает стартовый шаблон на основе вашего запроса:

| Шаблон    | Что вы получите      | Используйте, когда нужно                        |
| --------- | -------------------- | ----------------------------------------------- |
| `ui`      | React веб-приложение | Веб-приложение, панель управления, лендинг      |
| `process` | HTTP сервер          | API, обработчик webhook, запланированная задача |

## Одно приложение, одна ветка

Каждое приложение — это один git checkout на `main`. Нет отдельных черновиков, нет переключения веток, нет шага слияния. Каждое изменение попадает на `main` как коммит; публикация — это просто «развернуть текущий `main`».

## Цикл сборки

1. ИИ пишет код прямо на `main`
2. ИИ запускает dev сервер. Вы видите живое превью.
3. Вы итерируете через чат: «переместите график на боковую панель», «добавьте темную тему»
4. Dev сервер перезагружается после каждого изменения
5. Когда готово, опубликуйте

## Публикация

Публикация развертывает текущий коммит на `main`. Нет отдельной production ветки — самый свежий опубликованный коммит на `main` — это то, что работает в production.

Когда вы публикуете в каталог для установки другими, ваше приложение получает токен идентификации пользователя при запуске, ключ установки для своего backend и webhook'и установки/удаления. См. [Publishing](/apps/publishing).

## Кеширование, обновления и оффлайн

Desktop и мобильные версии открывают URL вашего приложения в обычном браузере. Они **не** очищают кеш браузера, не принуждают к загрузке только из сети и не выбирают другую политику кеша для публичных и приватных приложений.

Ваше веб-приложение управляет кешированием:

* HTTP `Cache-Control` заголовки для документов и ресурсов
* Опциональная настройка service worker / PWA (шаблоны поставляются с `vite-plugin-pwa` и автоматическим обновлением)
* Активируется ли новая сборка сразу, перезагружается один раз или ждет следующего открытия
* Оффлайн fallback для последней активированной сборки

Когда Kazzle видит новую опубликованную версию для открытой вкладки приложения, она просит зарегистрированный service worker проверить обновление (`registration.update()`). Приложения без service worker игнорируют эту проверку и продолжают использовать свои HTTP кеш-заголовки.

Опубликованные приложения могут открываться мгновенно из кеша, получать новую сборку без жесткого обновления и хранить последнюю сборку в оффлайне.

## Развертывание

После публикации разверните, чтобы получить live URL:

* **Удаленные приложения** развертываются в облако Kazzle и получают публичный URL
* **Локальные приложения** устанавливаются на ваш компьютер. UI загружается напрямую, а процесс запускает dev сервер.

## Приложения реального времени

Для приложений, которым нужны мгновенные локальные чтения и поддержка оффлайна, ИИ:

1. Создает базу данных
2. Включает синхронизацию в реальном времени
3. Создает двухчастное приложение: UI (React + sync клиент) и Process (endpoint токена + sync загрузка)
4. Подключает учетные данные через [vault](/work/vault)

См. [Realtime sync](/apps/sync) для подробностей.

## Лендинги

Лендинги — это приложения только с UI. Без backend, без базы данных. Опишите страницу, и ИИ создаст её, развернет и даст вам live URL. Чтобы использовать пользовательский домен, направьте ваш домен или поддомен на URL развернутого приложения.