Supabase for databases

​

Projects with Supabase databases published prior to September 30, 2025

If you have an existing project using Supabase databases:

• Keep using Supabase for your databases.
• Supabase databases cannot be converted into Bolt databases.
• You can switch from v1 Agent (legacy) to Claude Agent at any time. Your Supabase databases will still work. The only change you may notice is that your chat history window will reset when you switch.

If you are starting a new project:

• Claude Agent will create and use Bolt databases by default.
• You can migrate a Bolt database to Supabase later if you want.
• Projects created with v1 Agent (legacy) only support Supabase databases. These must be added after the initial build. The v1 Agent (legacy) cannot create Bolt databases.

​

New to databases and related terminology?

Databases and their features, such as server functions and authentication, are among the more technical parts of Bolt. If you are just getting started and want a simple introduction to the key concepts, see our Introduction to databases article.

​

Overview

By default, new projects created with Claude Agent use Bolt databases. Projects created before September 30, 2025, used Supabase by default, as explained in the section above. You can choose to claim Bolt databases created with Claude Agent in Supabase if you want to work there, or continue using Supabase directly to create and manage databases for projects that use Bolt’s v1 Agent (legacy). Supabase provides:

• A hosted SQL database, which you can connect your application to. You don’t need to worry about managing your database.
• Authentication services, for adding user login and user management to your application.
• Edge functions: Bolt uses these if your application needs to include an API. They’re also used for communicating with other applications, such as Stripe for payment handling.

Explore Supabase’s website and documentation for full details of Supabase’s features.

​

Connect Bolt to Supabase

To start working with Supabase, you’ll first need to connect Bolt to Supabase in the Applications section of your Personal Settings.

1. Log in to any project.
2. Click the gear icon in the top center of your screen, then click All project settings.
3. Click Applications under Personal Settings.
4. Click Connect in the Supabase row.
5. Log in with your Supabase credentials.
6. Follow the steps to authorize Bolt.

​

View Supabase data in your Bolt settings

When managing a project with Supabase in Bolt, your Supabase data appears in the database-related Bolt Project Settings. Click the database icon at the top center of your screen to view general database information. To access settings like Authentication, Server Functions, or Secrets, use the gear icon and select from the menu.

​

Version history and database restores

Restoring to an earlier project version will not change your current Supabase databases.

​

Connect a Supabase database

If you already have a Supabase database you want to use in your Bolt project, or want to create a new one, follow the steps below to connect it.

1. Ensure you have connected Bolt to your Supabase account.
2. Log in and open the project with the database you want to claim.
3. Click the Database icon in the top center of your screen.
4. Click the Advanced tab.
5. Click Connect.
6. Select an existing Supabase project or create a new one.
7. Click Connect project.

​

Claim your Bolt Database in Supabase

The primary reason for claiming a Bolt database is to unlock advanced Supabase features. For most use cases, staying with Bolt keeps things simple and gives you unlimited free databases. However, if you need external management tools, SQL editing, or advanced monitoring, you may prefer to use Supabase. To migrate your Bolt database to Supabase and start using Supabase in your project, follow these steps:

​

Use Supabase in a v1 Agent (legacy) Bolt project

To use Supabase in a Bolt project using the v1 Agent (legacy) that does not yet have a database set up, follow the steps below:

1. Ensure you have connected Bolt to your Supabase account.
2. Click the gear icon in the top center of your screen, then click Supabase.
3. Choose an existing Supabase project to connect to, or create a new one.
4. Refresh your Bolt project in your browser.

​

Disconnect Supabase

1. Log in to any project.
2. Click the gear icon in the top center of your screen, then click All project settings.
3. Click Applications under Personal Settings.
4. In the Supabase row, click Disconnect.
5. In Supabase, remove Bolt from your authorized applications:
   1. In the Supabase dashboard, make sure you’re in the organization that you connected to Bolt.
   2. In the left menu, click Organization settings.
   3. Go to the OAuth Apps tab.
   4. Next to Bolt, click Delete.

​

Using authentication

If you tell Bolt to add authentication with Supabase, users will be able to sign up for your application and log in using Supabase’s user management service. Make sure you’ve connected your Supabase account as described above. Prompt Bolt to add authentication with Supabase, including adding a signup and login screen to your application. Once everything is working in your application, you can confirm users are being added correctly in Supabase:

1. Go through the signup process in your application.
2. Supabase should send you an email to confirm your email address.
3. In Supabase, open your project.
4. In the left navigation menu, select Authentication.
5. Check the Users list to confirm that the user you just created was added there.

​

Using edge functions

Edge functions in Bolt rely on databases. Before you begin, make sure you have connected your Supabase account as described above. To get started, prompt Bolt to create the edge function you are interested in. For example: Create an edge function to handle a conversation with an AI Bot (OpenAI). From here, Bolt generates the edge function. Edge functions can be complex, as they connect up services and involve authentication steps. For help with common errors, check out Integrations issues | Supabase edge functions.

​

FAQs and troubleshooting