Supabase
The Postgres database, authentication, storage, and realtime backend your app runs on.
Why we need this
Supabase is the backend your app runs on: a managed Postgres database, authentication, file storage, and realtime updates, all in one place. Calda connects to it through the Supabase client libraries and REST/Postgres APIs so the app can store data, sign users in, and serve files reliably.
Like all other accounts, this one should be owned by you. Your data, database backups, and user records are tied to the account, so keeping it under your company means everything your app stores belongs to you, not us.
Do I need a credit card?
No. Supabase's free tier needs no credit card and is enough to get started and run early development and beta. It includes a Postgres database, authentication, and storage with limits that comfortably cover the build phase.
Heads up before launch
Free-tier projects are paused after a period of inactivity and have lower resource and storage limits. Before going to production you'll likely need the Pro plan (which does require a credit card) so the project stays always-on and has room to grow.
A note on organizations vs. projects
This part is worth getting right. In Supabase, an Organization holds your billing and team members, and it contains one or more Projects — each Project being a separate database with its own auth, storage, and API keys.
Team members are invited at the Organization level, not per project, so adding us once on the organization gives us access to the projects inside it. If a separate organization is ever created, we'll need to be invited to that one too.
Invite from organization settings
Make sure the invite happens from your Organization's team settings rather than from a personal sharing link, so we actually get access to the projects inside it.
Step-by-step setup
Create your Supabase account
Sign up at supabase.com using the company email that should own the account. You can sign up with email or with a provider like GitHub.
Create your organization
When prompted, create a new Organization named after your company. This is the container that holds billing and team members for all of your projects.
Create a project
Create a new Project inside the organization. You'll choose a project name, set a database password, and pick a region — choose one close to most of your users. Keep the database password somewhere safe; you'll only be shown it once.
Not sure which region?
If you're unsure, let us know your main user base in Slack and we'll recommend a region — it can't be changed after the project is created.
Invite Calda
Open Organization Settings → Team (Members), click to invite a member, enter the Calda email we share with you, and assign the Owner or Administrator role so we can manage projects and generate the API keys we need.
Confirm in Slack
Don't forget to notify us in Slack so we can accept the invitation and confirm that we can sign in.
Conclusion
That is it — with an organization and project in place and access granted, we can wire up the database, authentication, and storage your app needs. Once you've added us and confirmed in Slack, we'll handle the rest of the integration on our side.
How is this guide?