Database

Bolt makes it easy to add database functionality to your app without the hassle of extra infrastructure. You get a ready-to-use database whenever your project needs one, helping you focus on building features rather than configuring servers.

​

Benefits of Bolt Database

Using a Bolt database helps you get more complicated web apps up and running quickly:

• No manual setup: Skip configuring servers or hosting, Bolt handles it for you.
• Built-in authentication management: Easily add user sign-up capabilities to your project.
• One place for monitoring: Keep track of security and logs without switching tools.
• Future-proof connections: Easily connect external tools later for advanced control.

This setup is ideal for quickly building, testing, and scaling your app.

​

Creating and Using Databases with Claude Agent

When working with Claude Agent, new Bolt databases are created automatically based on your project’s needs or when you explicitly ask the agent to create a database or a database-related feature. This makes it easy to get started without setting anything up manually. If you are using v1 Agent (legacy), you can inherit a Bolt database that was created with Claude Agent, but you cannot create new databases while working in v1 Agent.

​

Ask Bolt not to create a database

If you don’t want Bolt to provision a database, you can explicitly request this. For example, when submitting a prompt, add the instruction: Don't use a database, I want to use local storage for this app.

​

Projects with Supabase databases published prior to September 30, 2025

You can create new Bolt databases with Claude Agent and later claim them in Supabase. However, you cannot take an existing Supabase database and claim it in a Bolt project through Claude Agent. If your project already uses a Supabase database connection, we recommend continuing with that setup to avoid migrations and keep your app running smoothly. If you are using v1 Agent (legacy), you can inherit a Bolt database that was created with Claude Agent, but you would need to integrate with your own Supabase account, and you cannot create new Bolt databases while working in v1 Agent. It is technically possible to switch to Claude Agent, create a database, then switch back to v1 Agent to use that database, but this is not a supported or recommended path.

​

How Bolt provisions a database

When you create a project, Bolt can automatically create a database if your app requires one or if you explicitly request it. For example, if you create a trivia app, Bolt will set up a database to store questions and answers. Features like user authentication may not be added automatically, but you can prompt Bolt to include sign-up and log-in if your app requires them. For example: Create user accounts via email signup and login, then add account sign in/log out buttons in the top right corner of the home page.

​

Database settings

Bolt’s Project Settings include several sections that let you manage your project’s data and related features. These include:

• Database
• Authentication
• Server Functions
• Secrets
• User Management
• File Storage

Each section is explained below to help you find the information you need.

​

Database: view and manage your databases

The Database section of your Project Settings lets you work with your data in a simple table view. To open the Database section, click the Database icon in the top center of your screen. Here you’ll see all the different databases created by Bolt. Using the tabs along the top of this window, you can also:

• Review logs to debug errors and track activity in your app.
• Claim your database in Supabase under the Advanced tab.

​

Security Audit

When viewing Database information, click the Security Audit tab to check for potential issues. If any are found, click Ask Bolt to fix to have them resolved automatically.

​

Authentication settings

To view Authentication settings, click the gear icon in the top center of your screen, then click Authentication. In this window, you can:

• Toggle whether new users are allowed to sign up.
• Toggle whether or not anonymous sign-ins are allowed.
• Configure email-based login (which is currently the only available sign-in method).

​

Server functions (also known as edge functions)

When you build an app, not everything can safely or efficiently happen on the user’s device. Some tasks need extra security, reliability, or power. That is where server functions (sometimes called edge functions) come in. Server functions handle important work behind the scenes, like talking to your database, checking permissions, or processing payments. Instead of running this logic directly in a user’s browser or mobile app, where it could be slower or less secure, the function runs on a server. This keeps sensitive information safe and ensures your app behaves the same way for every user. Think of them as trusted helpers that live outside the app but make sure everything runs smoothly. By using server functions, you can build apps that are faster, safer, and easier to maintain.

​

Server functions in Project Settings

The Server Functions window displays all server-side (edge) functions currently deployed. This is helpful for debugging and tracking the backend logic that runs alongside your database. Situations where server functions may add value include:

• Authenticated or public HTTP endpoints that need low latency.
• Webhook receivers (Stripe, GitHub, etc.).
• On-demand image or Open Graph generation.
• Small AI inference tasks or orchestrating calls to external LLM APIs (like OpenAI)
• Sending transactional emails.
• Building messaging bots for Slack, Discord, etc.

To view, click the gear icon in the top center of your screen, then click Server Functions.

​

Manage secrets

Secrets are used by your server functions (also known as edge functions) to safely access sensitive information, like API keys or database passwords, without exposing them to users. When a server function runs, it can securely read the secret and complete its task, such as making a request to an external service. This helps keep your app secure and ensures that private information never ends up in your users’ browsers or devices. If you’re using Claude Agent, you’ll automatically be prompted when it is time to add these. For example, if you send a message like “Integrate OpenAI,” the agent will complete the coding and then display a message asking you to add your secret, along with a link to the Secrets tab. To view your secrets, click the gear icon in the top center of your screen, then click Secrets. Tips for good secrets security

• Rotate your keys regularly to reduce risk.
• Remove keys you no longer use.
• Never store secrets in plain text in your code.

​

Track user activity

The User Management section gives you insight into how people use your app. Here, you can:

• View a graph of sign-ups over time.
• See a list of the most recently added users.

To view your user activity, follow these steps:

1. Click the gear icon in the top center of your screen, then click All project settings.
2. Click User Management.

​

File storage

Bolt includes built-in file storage that connects seamlessly with your database. To view your stored files, follow these steps:

1. Click the gear icon in the top center of your screen, then click All project settings.
2. Click File Storage.

​

Claim your Bolt Database in Supabase

The main reason to claim 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. If you need external management tools, SQL editing, or advanced monitoring, you may prefer to use Supabase. To do so, follow these steps:

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 top center of your screen.
4. Click the Advanced tab.
5. Click Claim.