Initialize Supabase

Set up the Supabase directory structure and configuration files in your project.

Initialize

Run the init command from your project root:

supabase init

This creates a supabase directory with:

Directory Structure

supabase/
├── config.toml      # Supabase configuration
├── migrations/      # Database migrations
├── functions/       # Edge functions
└── seed.sql         # Seed data (optional)

Already Initialized?

If your project already has a supabase directory (from cloning the template), you can skip this step and proceed to linking.

Configuration Overview

The config.toml file contains settings for your local Supabase development environment:

supabase/config.toml

[api]
enabled = true
port = 54321
schemas = ["public", "storage", "graphql_public"]

[db]
port = 54322
major_version = 15

[studio]
enabled = true
port = 54323

[auth]
site_url = "http://localhost:3000"
additional_redirect_urls = ["http://localhost:3000"]

You typically don't need to modify these settings for development. The template comes pre-configured with sensible defaults.

What's Next

With the Supabase directory initialized, you're ready to link your local project to your remote Supabase instance.

Supabase Login Next: Link Project