Cloud Database

Overview

Thunkable Cloud DB is the behind-the-scenes backbone that powers apps built with Thunkable AI. It handles user login and stores your app's data automatically with Supabase. When you describe the app you want to build, the AI will suggest how to organize your data, and you can approve it right in the chat. Your app will then be able to read and write data in real time as people use it. From there, anyone using your app can create an account and sign in with their email and password.

Cloud Database and Auth are only available on Accelerator plans and above.

Video Tutorial

Getting Started

Step 1: Connect Your Supabase Account

Before you can use Thunkable Cloud, you'll need a free Supabase account. Supabase is where your app's data will live.

1. Go to supabase.com and create a free account if you don't have one

2. In Thunkable AI, access your Cloud Database in your account settings or by clicking on the dropdown next to your profile, then selecting 'Cloud Database'.

1. Choose how to connect:

OAuth2 (recommended)

1. Click 'Sign in with Supabase' to navigate to the Supabase website to connect with Thunkable

2. Select the Organization to connect to, then click 'Authorize Thunkable'

Personal Access Token

1. You'll see a green status indicator when the connection is active.

Step 2: Start a Project with Cloud Database

1. Create a new project in Thunkable AI and switch to Plan Mode

2. In your prompt, include the following dependant on the feature you want to add:

Auth (Sign-in and Sign-out)

Add User Authentication with User Sign-up and Sign-in through the Cloud Database with Supabase

When prompted with such questions as 'How should people sign in?', it is recommended to select 'Email only'.

There are many other sign-in methods that Supabase offers, such as Google Auth, but they may not be functional on Thunkable or may require additional external setup.

Data Storage

The first time you use Cloud on a project, Thunkable AI sets up a dedicated database in your Supabase account. This takes about 2 minutes. A progress card in chat will keep you updated.

Review and Approve Schema Changes

When your app needs to store data, Thunkable AI will propose a database change in chat before applying anything.

1. A schema card will appear in chat describing the proposed change — for example, "Add a Habits table with Title and Streak fields"

2. Review the proposed tables, columns, and permissions

3. Click Apply to save the change to your database, or Cancel to skip it

Schema changes are permanent in V1. Once applied, they can't be removed from version history. You can always add new tables and columns, but renaming or deleting isn't supported yet.

Managing Your Connection

If Your Connection Goes Red

If your Supabase connection expires or is revoked:

1. Go to Account Settings → Supabase

2. Paste a new Personal Access Token, or click Connect via OAuth2 to re-authenticate

3. Your connection will restore automatically — no need to disconnect first

Your published apps are not affected by a disconnected Supabase connection. They continue running independently.

Disconnecting Supabase

1. Go to Account Settings → Supabase

2. Click Disconnect

3. Confirm the prompt

Disconnecting removes Thunkable AI's access to manage your databases. Your Supabase projects and all data remain in your account, untouched.