Creating Your First Project

This guide walks you through creating your first Supabase project with Supascale.

Create a New Project

1. Navigate to Projects

Click Projects in the sidebar, then click New Project.

2. Enter Project Details

3. Select Services

Choose which Supabase services to enable:

Core Services (Always Enabled)

• Database - PostgreSQL database
• Auth - User authentication
• REST API - PostgREST API
• Studio - Supabase Studio UI

Optional Services

• Realtime - Real-time subscriptions
• Storage - File storage
• Edge Functions - Serverless functions
• PgBouncer - Connection pooling
• Analytics - Usage analytics
• Imgproxy - Image transformation
• Inbucket - Email testing (dev only)

For development, enabling all services is recommended.

4. Create Project

Click Create Project to start the creation process.

Creation Progress

Supascale shows real-time progress as it:

1. Validates - Checks configuration
2. Generates - Creates Docker Compose file
3. Pulls - Downloads Docker images
4. Creates - Sets up containers
5. Starts - Launches services
6. Verifies - Health checks

This typically takes 2-5 minutes depending on your internet connection.

Access Your Project

Once created, you'll see project details:

Connection Info

Credentials

View project credentials by clicking Show Credentials:

• Database Password - PostgreSQL password
• JWT Secret - For authentication tokens
• Anon Key - Public API key
• Service Role Key - Admin API key

Keep your Service Role Key secret. It bypasses Row Level Security.

Start Using Your Project

Access Supabase Studio

Click the Studio link to open Supabase Studio, where you can:

• Browse and edit tables
• Write SQL queries
• Manage authentication
• Configure storage

Connect Your Application

Use the Supabase client in your application:

import { createClient } from '@supabase/supabase-js'

const supabase = createClient(
  'http://your-server:8000',
  'your-anon-key'
)

// Query data
const { data, error } = await supabase
  .from('users')
  .select('*')

Create Your First Table

1. Open Studio
2. Go to Table Editor
3. Click New Table
4. Name it todos
5. Add columns:
   • id (int8, primary key)
   • task (text)
   • done (bool, default: false)
   • created_at (timestamptz, default: now())
6. Click Save

Manage Your Project

Start/Stop

Control project state from the project card:

• Start - Launch all containers
• Stop - Gracefully stop containers
• Restart - Stop then start

View Logs

Click Logs to see container output:

• Select specific service or view all
• Tail recent logs (default 200 lines)
• Search for specific messages

Monitor Status

The project card shows:

• Status - Running, Stopped, Error
• Containers - Number running
• Uptime - Time since last start

Next Steps

With your project running:

1. Configure a custom domain
2. Set up SSL
3. Create a backup
4. Configure auth providers

Troubleshooting

Project Won't Start

1. Check Docker status: docker ps
2. View project logs in Supascale
3. Verify enough disk space
4. Check port conflicts

Can't Connect

1. Verify project is running
2. Check firewall allows the port
3. Verify connection string
4. Check credentials are correct

Studio Not Loading

1. Verify Studio container is running
2. Check Studio port is accessible
3. Clear browser cache
4. Try a different browser