Kuunda Docs
Documentation
This documentation is separate from the marketing site so it can ship on its own cycle, with technical guides focused on building product.
Kuunda Vibe guide
Create a project, talk to the assistant and publish, without being a developer.
Google sign-in (OAuth)
OAuth flow, Kuunda URLs, SDK alias vs HTTP identifier (Google, GitHub, Apple, …).
First account
Create an account and initialise a first project.
API root (JSON probe)
Public host: https://api.kuunda-cloud.com. This is not a web page: the root returns a JSON probe; the REST API lives under /rest/v1/. Explanation and useful links.
PostgreSQL extensions
CORE catalogue, PostGIS, citext: shared vs dedicated pool, search_path and Database → Extensions in the console.
Kuunda Cloud Managed
BaaS + Management API for Lovable, CI and agents: PAT, discovery, SQL DDL, @kuunda/kuunda-js.
Platform API
Accounts, projects, Auth, providers, storage and REST: which key reads and writes, without opening the console.
Supabase migration
pg_dump export, Auth / Storage / SQL import, @kuunda/kuunda-js adaptation and production cutover.
Neon migration
Neon URI (sslmode=require), “Neon” card in the wizard, schema pg_dump.
Migrate from Firebase
Auth / Storage / SQL equivalents. No Firestore or Firebase Auth JSON import.
Data import
Source credentials, pg_dump schema.sql + data.sql, Auth / Storage / SQL wizard.
Remote migrations
DDL/DML on the tenant schema via POST on the console, service_role key, SQL body: for CI and automation (not the REST API).
Users
Project accounts: invitation, data profiles, orphan repair.
Policies (RLS)
The row-level security model, applied by default and checkable on one screen.
Tables and REST API
Shape the schema, edit data and query every table over HTTP.
File storage
Buckets, file upload and object access control.
Edge Functions
Server-side TypeScript: handler, secrets, tests and logs.
Realtime
Database changes and messages pushed to connected clients.
Logs
Project stream, filters by service and level, live tailing.
Backups
Restore points, retention and going back to an earlier state.
Sandbox
Disposable environment: experiments and agents, then schema promotion.
API keys
Which key for which use, and what to do when a key leaks.
Views, triggers and routines
The other schema objects besides tables, and how to change them safely.
Usage and quotas
What your project consumes and the caps your organisation applies.
Kuunda Git (hosted Git)
Git repository hosted with the project: first push, tokens, deploy on push.
Kuunda Sage (data analyst)
Plain-language questions about your database, read-only answers.
Platform status
Service availability and ongoing incidents.
Quickstart
- Create an organisation then a project in the console.
- Get API keys (anon / service) from project settings.
- Install the SDK: npm install @kuunda/kuunda-js.
- Try a first SELECT via /rest/v1/ or kuunda.from("table").select().
- CI / tools: SQL migrations with the service_role key — see Remote migrations.
- Enable Auth, Storage and Realtime as needed.