First Project Checklist
- Create the Supabase project and choose the region or environment.
- Save the project URL and the correct keys for frontend and backend use.
- Create one or two starter tables for the first business workflow.
- Enable the first auth method you want to use.
- Create a storage bucket only if your first workflow needs file uploads.
Set Up the Database
A good starting point is one simple table that represents a real workflow. For example, many teams begin with a task, request, ticket, or profile table.
create table tasks (
id bigint generated by default as identity primary key,
title text not null,
status text default 'open',
created_at timestamptz default now()
);
After creating the table, add a few test rows so you can confirm reads and writes from both the dashboard and the application.
insert into tasks (title, status) values ('Prepare onboarding', 'open');
insert into tasks (title, status) values ('Review first deployment', 'in_progress');
select * from tasks order by created_at desc;
Set Up Auth
For most first deployments, start with email/password or magic link auth. Keep the first flow simple, then add more advanced identity options only when they are really needed.
- Set the Site URL and redirect URLs for the app.
- Create or invite at least one admin test user.
- Test sign-up, sign-in, and password reset before announcing the environment ready.
Connect to an App
A frontend application normally connects with the project URL and the client-safe key. The backend can use a server-side key for trusted actions.
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(
process.env.NEXT_PUBLIC_SUPABASE_URL,
process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY
)
const { data, error } = await supabase.from('tasks').select('*')
console.log({ data, error })
Basic Queries and First Checks
- Read data from the starter table.
- Insert a new row and confirm it appears in the dashboard.
- Sign in as a test user and verify access works as expected.
- If you created a bucket, upload a file and verify it can be retrieved correctly.
Simple Real-World Example
A common first use case is a lightweight internal request tracker. Users sign in, create requests, upload supporting files, and view updates in the app. The frontend handles normal user actions, while a backend service performs privileged actions such as reporting, cleanup jobs, or admin-only updates.
What to Validate Before Expanding
- Can users log in without support?
- Can the app read and write the core table?
- Are access rules behaving correctly for normal users and admins?
- Does the application still work when tested from the real deployment environment, not just the local developer machine?
Shakudo SaaS-first quick start
This section is for customers using Supabase as a managed component inside Shakudo. Start from the Shakudo platform instead of installing or exposing Supabase manually.
1. Access the component in Shakudo
- Sign in to your Shakudo workspace with your organization-approved account.
- Open the workspace or environment where this component is enabled.
- Go to the Applications or component catalog area and select Supabase.
- If you cannot see the component, ask your workspace administrator to confirm that it is enabled for your role and environment.
2. Open the component UI
- Use the Shakudo-provided Open, Launch, or Access action for Supabase.
- Let Shakudo handle authentication, networking, and workspace routing. Avoid using internal service URLs unless your administrator explicitly provides them.
- Confirm that the component opens in the expected workspace before creating or changing resources.
3. Complete a first safe use case
Open Supabase Studio, create or inspect a project, create a small table or review an existing dataset, and run a simple SQL query to confirm database access.
- Use a small non-production example first, especially when testing credentials, scans, model calls, or data connections.
- Name the test clearly so other workspace users can recognize it as a first-run validation.
4. Monitor and validate the result
- Check the component UI for run status, logs, traces, scan results, job history, or project activity, depending on the component.
- Return to Shakudo if you need platform-level status, access control changes, or administrator support.
- Record any errors, missing permissions, or unexpected results before retrying with production workloads.
5. Next steps
- Review the use cases, administration, and troubleshooting pages in this knowledge base for deeper examples.
- For production usage, follow your team’s Shakudo workspace policies for credentials, data access, resource limits, and approvals.
- Previous getting-started content snapshot
- The page content below was present before this SaaS-first section was added. It is retained here as an inline snapshot so existing guidance is not lost.
- heading_1: Getting Started & Usage; paragraph: This page helps new teams get their first useful Supabase workflow running quickly. It covers the first project, a starter database table, basic auth, and connecting an application.; heading_2: First Project Checklist; numbered_list_item: Create the Supabase project and choose the region or environment.; numbered_list_item: Save the project URL and the correct keys for frontend and backend use.; numbered_list_item: Create one or two starter tables for the first business workflow.; numbered_list_item: Enable the first auth method you want to use.; numbered_list_item: Create a storage bucket only if your first workflow needs file uploads.; heading_2: Set Up the Database; paragraph: A good starting point is one simple table that represents a real workflow. For example, many teams begin with a task, request, ticket, or profile table.; code: create table tasks (id bigint generated by default as identity primary key,title text not null,status text default 'open',created_at timestamptz default now());; paragraph: After creating the table, add a few test rows so you can confirm reads and writes from both the dashboard and the application.