Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bilt.me/docs/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through connecting your Bilt app to Supabase — giving your app user authentication, a PostgreSQL database, and real-time data.

​
Prerequisites

​
Step 1: Create a Supabase project

If you don’t have one:
  1. Go to supabase.com and sign up
  2. Create a new project — pick a name, set a database password, choose a region
  3. Wait for the project to finish provisioning (about 1 minute)

​
Step 2: Connect from Bilt

1

Open your Bilt project

Go to your project’s chat interface
2

Start the connection

Click the Supabase option in the project interface, or tell the AI:
Connect this project to Supabase
3

Authenticate

Sign in with your Supabase account. Bilt uses OAuth (PKCE) — you authorize Bilt to access your Supabase projects.
4

Select your project

Choose the Supabase organization and project to connect.
Once connected, you’ll see a confirmation in the chat. The AI now has access to your Supabase project.

​
Step 3: Build features with Supabase

Now tell the AI what you want. It will generate the code that connects to your Supabase backend.

​
Add authentication

Add sign up and log in screens using Supabase auth.
After login, redirect to the home screen.

​
Create and use a database table

Create a "posts" table with title, content, and author fields.
Show all posts on the home screen in a card layout.
Add a form to create new posts.

​
Add real-time updates

When a new post is created by any user, show it on the home screen
in real time without refreshing.

​
Step 4: Verify data

Use Bilt’s built-in database inspector to check that everything is working:
  • Browse tables and see stored data
  • Check that auth users are being created
  • Run SQL queries to debug issues
You can also check your Supabase dashboard for a full view of your database, auth users, and API logs.

​
Tips

  • Start with auth — Get sign up and login working first, then add data features
  • Use Supabase’s row-level security — Ask the AI: “Enable row-level security on the posts table so users can only edit their own posts”
  • Check the Supabase dashboard if something isn’t working — the API logs show every request your app makes

​
Further reading