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

# Побудова та публікація

> Побудова додатків за допомогою ШІ, ітерація на живому перегляді та розгортання у виробництво.

## Створення додатку

Два способи:

* **Попросити ШІ** - опишіть, що вам потрібно в чаті, і ШІ побудує додаток
* **Кнопка нового додатку** - натисніть **+** на бічній панелі Drive та виберіть **Новий додаток**

ШІ вибирає стартовий шаблон на основі вашого запиту:

| Шаблон    | Що ви отримаєте   | Використовуйте, коли вам потрібно               |
| --------- | ----------------- | ----------------------------------------------- |
| `ui`      | React веб-додаток | Веб-додаток, панель керування, цільова сторінка |
| `process` | HTTP сервер       | API, обробник вебхука, запланована задача       |

## Один додаток, одна гілка

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

## Цикл побудови

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

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

Публікація розгортає поточний коміт `main`. Немає окремої гілки виробництва — найновіший опублікований коміт на `main` — це те, що працює.

Коли ви публікуєте в каталог для встановлення іншими, ваш додаток отримує токен ідентифікації користувача при запуску, ключ встановлення для його бекенду та вебхуки встановлення/видалення. Див. [Публікація](/apps/publishing).

## Кешування, оновлення та автономний режим

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

Ваш веб-додаток керує кешуванням:

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

Коли Kazzle бачить нову опубліковану версію для відкритої вкладки додатку, він просить зареєстрований service worker перевірити оновлення (`registration.update()`). Додатки без service worker ігнорують цю перевірку та продовжують використовувати власні HTTP заголовки кешу.

Опубліковані додатки можуть тому відкриватися миттєво з кешу, отримувати нову побудову без жорсткого оновлення та зберігати останню побудову доступною в автономному режимі.

## Розгортання

Після публікації розгорніть, щоб отримати живий URL:

* **Віддалені додатки** розгортаються в хмару Kazzle та отримують публічний URL
* **Локальні додатки** встановлюються на ваш комп'ютер. Інтерфейс завантажується безпосередньо, а частина процесу запускає dev сервер.

## Додатки в реальному часі

Для додатків, які потребують миттєвого локального читання та підтримки автономного режиму, ШІ:

1. Створює базу даних
2. Включає синхронізацію в реальному часі
3. Побудовує двочастинний додаток: UI (React + клієнт синхронізації) та Process (кінцева точка токена + завантаження синхронізації)
4. Підключає облікові дані через [сховище](/work/vault)

Див. [Синхронізація в реальному часі](/apps/sync), щоб дізнатися, як це працює.

## Цільові сторінки

Цільові сторінки — це додатки лише з UI. Без бекенду, без бази даних. Опишіть сторінку, і ШІ побудує її, розгорне та надасть вам живий URL. Щоб використовувати власний домен, спрямуйте свій домен або поддомен на URL розгорнутого додатку.