Kuunda Docs

Ouvrir la console

Documentation

Cette documentation est séparée de la landing pour permettre un cycle de publication indépendant, avec des guides techniques orientés build produit.

Guide Kuunda Vibe

Créer un projet, parler à l’assistant et publier, sans être développeur.

Connexion Google (OAuth)

Flux OAuth, URLs Kuunda, alias SDK vs identifiant HTTP (Google, GitHub, Apple, …).

Premier compte

Créer un compte et initialiser un premier projet.

Racine API (sonde JSON)

Hôte public : https://api.kuunda-cloud.com. Ce n’est pas une page web : la racine renvoie une sonde JSON ; l’API REST vit sous /rest/v1/. Explication et liens utiles.

Extensions PostgreSQL

Catalogue CORE, PostGIS, citext : pool partagé vs dédié, search_path et console Database → Extensions.

Kuunda Cloud Managed

BaaS + Management API pour Lovable, CI et agents : PAT, discovery, SQL DDL, @kuunda/kuunda-js.

API Plateforme

Comptes, projets, Auth, providers, stockage et REST : quelle clé lit et écrit, sans ouvrir la console.

Migration Supabase

Export pg_dump, import Auth / Storage / SQL, adaptation @kuunda/kuunda-js et cutover production.

Migration Neon

URI Neon (sslmode=require), carte « Neon » dans l’assistant, pg_dump du schéma.

Migrer depuis Firebase

Équivalents Auth / Storage / SQL. Pas d’import Firestore ni Firebase Auth JSON.

Import de données

Identifiants source, pg_dump schema.sql + data.sql, assistant Auth / Storage / SQL.

Migrations à distance

DDL/DML sur le schéma tenant via POST sur la console, clé service_role, corps SQL : pour CI et outils automatisés (pas l’API REST).

Utilisateurs

Comptes du projet : invitation, profils de données, réparation des orphelins.

Politiques (RLS)

Le modèle de sécurité par ligne, appliqué par défaut et vérifiable en un écran.

Tables et API REST

Créer le schéma, éditer les données et interroger chaque table en HTTP.

Stockage de fichiers

Buckets, envoi de fichiers et contrôle d’accès des objets.

Edge Functions

TypeScript côté serveur : handler, secrets, tests et journaux.

Realtime

Changements de la base et messages poussés aux clients connectés.

Journaux

Flux du projet, filtres par service et par niveau, suivi en direct.

Sauvegardes

Points de restauration, rétention et retour à un état antérieur.

Sandbox

Environnement jetable : essais et agents, puis promotion du schéma validé.

Clés API

Quelle clé pour quel usage, et comment réagir quand une clé fuite.

Vues, triggers et routines

Les autres objets du schéma en plus des tables, et comment les modifier sans risque.

Usage et quotas

Ce que votre projet consomme et les plafonds que votre organisation applique.

Kuunda Git (Git hébergé)

Dépôt Git hébergé avec le projet : premier push, jetons, déploiement au push.

Kuunda Sage (analyste de données)

Questions en langage clair sur votre base, réponses en lecture seule.

Statut plateforme

Disponibilité des services et incidents en cours.

Quickstart

  1. Créer une organisation puis un projet dans la console.
  2. Récupérer les clés API (anon / service) depuis les paramètres projet.
  3. Installer le SDK : npm install @kuunda/kuunda-js.
  4. Tester un premier SELECT via /rest/v1/ ou kuunda.from("table").select().
  5. CI / outils : migrations SQL avec la clé service_role : voir la page Migrations à distance.
  6. Activer Auth, Storage et Realtime selon le besoin.