Серверная часть Supabase (подключается один раз)

1Что даёт подключение Supabase#

По умолчанию приложение, созданное ИИ, хранит данные на том единственном телефоне, где оно установлено, — режим «Офлайн». Подключите Supabase, и то же приложение получит настоящую облачную базу данных (Postgres), аккаунты пользователей и хранилище файлов, так что данные будут общими для устройств и пользователей.

Это модель «принесите своё»: приложение работает с ВАШИМ бесплатным проектом Supabase. AppMint ничего не хостит для вас и не берёт за это дополнительную плату.

Вам не нужно проектировать таблицы или писать SQL. AppMint сам определяет схему по описанию приложения, применяет её и синхронизирует при каждой сборке.

2Что нужно сначала#

Бесплатный аккаунт Supabase — и всё. Создавать проект заранее НЕ нужно; AppMint может создать его за вас при входе.

Что стоит знать о бесплатном тарифе:

• 2 проекта на организацию.
• Проекты приостанавливаются после недели без трафика и просыпаются при следующем запросе.

Если у вас уже есть проект, который вы хотите использовать повторно, это тоже подойдёт — AppMint помещает каждое приложение в отдельную схему внутри него, поэтому несколько приложений могут делить один проект.

3Подключите (одно нажатие, рекомендуется)#

В AI Studio в разделе «WHERE YOUR APP'S DATA LIVES» нажмите карточку «Supabase» (там написано «Нажмите, чтобы подключить»). Выберите «Войти через OAuth».

Браузер откроет Supabase, вы войдёте и одобрите AppMint, после чего автоматически вернётесь в приложение — копировать токен не нужно.

То же самое доступно через шестерёнку ⚙ Настройки → «BACKEND - SUPABASE» → «🔗 Подключить Supabase (OAuth)».

Создать бесплатный аккаунт Supabase →

4Выберите или создайте проект#

Сразу после одобрения AppMint показывает «Выберите проект Supabase»:

• Выберите существующий проект или
• Нажмите «➕ Создать новый проект…» → выберите организацию → назовите его (например, appmint-prod) → выберите регион поближе к вашим пользователям (позже изменить нельзя) → «Создать». Подготовка занимает 1–2 минуты.

Когда AppMint создаёт проект, он показывает пароль базы данных ОДИН раз, потому что Supabase хранит только его хеш. Скопируйте его в надёжное место, прежде чем закрыть это окно, — для AppMint он не нужен, но понадобится для подключения любого другого инструмента.

Достигли лимита бесплатного тарифа («Free tier allows 2 projects per organization»)? Выберите существующий проект или перейдите на платный тариф в панели Supabase.

5Или подключите вручную (self-hosted / без OAuth)#

Настройки → «BACKEND - SUPABASE» → «MANUAL / SELF-HOSTED»:

1. URL проекта — из панели Supabase, Project Settings → API. Выглядит так: https://YOUR-PROJECT-REF.supabase.co
2. Ключ anon — публичный ключ с той же страницы; он начинается с «eyJ». Этот ключ предназначен для публичного использования: данные защищает Row-Level Security, а не сокрытие ключа.
3. Включите «Включить бэкенд Supabase для созданных приложений» и нажмите «Сохранить настройки Supabase».

Отметьте «Self-hosted instance», если вы сами запускаете Supabase. В ручном режиме нельзя автоматически развернуть схему в Cloud — добавьте персональный токен доступа (следующий шаг), если нужно.

Project URL   https://abcdefghijkl.supabase.co
anon key      eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

6Что AppMint делает при каждой сборке#

После подключения каждая генерация выполняет работу с бэкендом за вас:

• Применяет схему, написанную ИИ (таблицы, индексы, политики Row-Level Security).
• Выполняет начальные данные, если приложению они нужны.
• Создаёт хранилища Storage для загрузок и изображений.
• Разворачивает Edge Functions (платежи, почта, вебхуки) и пропускает те, что не изменились.
• Настраивает провайдеров аутентификации и Site URL.
• Запускает проверку безопасности и проверку миграций, затем подтягивает типы TypeScript обратно в проект.

Таблицы вашего приложения находятся в отдельной схеме с именем appmint_<ваше приложение>. Аккаунты пользователей общие для всех приложений проекта, поэтому одна регистрация работает везде.

7Проверьте, что всё работает#

Две быстрые проверки:

• Карточка «Supabase» в AI Studio теперь показывает «Подключено», а в настройках отображается ref проекта.
• Настройки → «DIAGNOSTICS» → «⚡ Проверить подключение к Supabase» — покажет успех или точную ошибку.

После создания приложения откройте панель Supabase → Table Editor и переключите селектор схемы с «public» на appmint_<ваше приложение>, чтобы увидеть созданные AppMint таблицы.

8Какие ключи где безопасны#

• Ключ anon — безопасен внутри созданных приложений. Row-Level Security определяет, что каждый вошедший пользователь может читать или записывать.
• Ключ service_role — НИКОГДА не попадает в приложение. AppMint хранит его в зашифрованном виде только на этом устройстве и использует для хранилищ Storage и применения схемы в self-hosted.
• Персональный токен доступа (sbp_…) — тоже только на устройстве; он позволяет AppMint автоматически разворачивать схему и Edge Functions в Supabase Cloud. Создайте его на supabase.com/dashboard/account/tokens с правами чтения и записи проекта.

Оба необязательных ключа находятся в Настройки → «ADVANCED - DEPLOY CREDENTIALS».

Создать персональный токен доступа →

9Открывает: вход через Google, Stripe, удалённое обновление#

Для нескольких функций сначала нужно подключить Supabase, и пока он не подключён, вас будут отправлять сюда:

• «Продолжить через Google» в созданных приложениях.
• Платежи Stripe (оплата выполняется в Edge Function в вашем проекте).
• Удалённое обновление — обновления, которые вы отправляете в установленные приложения, хранятся в вашем собственном проекте Supabase.

Подключите один раз, и все три станут доступны; повторять для каждого приложения не нужно.

10Удаление бэкенда приложения#

Настройки → «DANGER ZONE» (виден при подключении):

• «📋 Список и удаление таблиц проекта» — просмотрите все таблицы, созданные AppMint, и удалите ненужные.
• «🗑 Удалить весь бэкенд приложения» — удаляет схему этого приложения, а при желании и его хранилища Storage и Edge Functions. Для подтверждения введите DELETE.

Выбирайте «Только данные», если не уверены: хранилища и Edge Functions общие для всего проекта, а не для каждого приложения. Аккаунты пользователей никогда не затрагиваются.

Чтобы отключиться полностью: Настройки → «ONE-TAP OAUTH» → «🔒 Отключить Supabase OAuth».

11Если что-то не работает#

• «Не подключено» после входа → OAuth завершён, но проект ещё не привязан. Настройки → «Выбрать проект».
• Предупреждение, что ключ anon не получен автоматически → в вашем одобрении Supabase OAuth отсутствует разрешение Secrets:Read. Скопируйте ключ anon из Project Settings → API и вставьте его в настройках (шаг 5).
• «Не удалось получить список организаций Supabase» при создании проекта → создайте проект в панели Supabase, затем вернитесь и выберите его.
• «Сначала подключите Supabase» в Удалённом обновлении или Stripe → эта глава, шаг 3.
• Чтение/запись данных не работает в созданном приложении → сначала запустите «⚡ Проверить подключение к Supabase»; если проверка пройдена, попросите ИИ исправить политику Row-Level Security для названной им таблицы.