Kuunda Docs

Kuunda Cloud Managed = BaaS compatible Supabase (PostgREST, GoTrue, Storage, Realtime) + Management API pour les outils de vibe coding (Lovable, Bolt, CI, scripts).

Deux plans

Plan	Hôte	Usage
Data plane	{ref}.kuunda-cloud.com	App générée : @kuunda/kuunda-js, clé anon, JWT utilisateurs
Control plane	https://api.kuunda-cloud.com/v1	Agents : PAT, DDL SQL, création projet

Authentification

Créez un Personal Access Token (kuunda_pat_*) dans la console : Compte → Access Tokens. Permissions :

database_query — POST /v1/projects/{ref}/database/query
projects_create — POST /v1/projects (nouveau projet dans la même organisation)

Authorization: Bearer kuunda_pat_xxxxx

Découverte projet

GET https://api.kuunda-cloud.com/v1/projects/{ref}
→ ref, schema, rest_url, auth_url, anon_key, sdk…

Créer un projet (Managed)

POST https://api.kuunda-cloud.com/v1/projects
{ "name": "Mon app Lovable" }
→ project { ref, anon_key, rest_url, schema, … }

Exécuter du SQL (migrations)

POST https://api.kuunda-cloud.com/v1/projects/{ref}/database/query
{ "query": "CREATE TABLE …; NOTIFY pgrst, 'reload schema';" }

Client dans le code généré

npm install @kuunda/kuunda-js

import { createClient } from '@kuunda/kuunda-js';

const kuunda = createClient(
  process.env.NEXT_PUBLIC_KUUNDA_URL!,
  process.env.NEXT_PUBLIC_KUUNDA_ANON_KEY!,
  { dbSchema: process.env.KUUNDA_DB_SCHEMA! }
);

KUUNDA_DB_SCHEMA = proj_ + UUID projet (32 hex, sans tirets), pas la ref courte à 8 caractères.

Parité Supabase

Remplacez conceptuellement supabase-js par @kuunda/kuunda-js, api.supabase.com par https://api.kuunda-cloud.com/v1, et les clés sb_* par kuunda_anon_* / kuunda_pat_*.