How to Migrate from Firebase to Supabase

Map Your Firebase Services

Identify which Firebase services you use: Firestore/RTDB, Auth, Storage, Functions, Hosting. Map each to Supabase equivalents: PostgreSQL, Auth, Storage, Edge Functions, and external hosting.

Set Up Supabase Project

Create a project at supabase.com. Note your project URL and API keys. Enable Row Level Security on all tables from the start: this is Supabase's security foundation.

Design Your PostgreSQL Schema

Convert your Firestore document structure to relational tables. Normalize data that was denormalized for Firestore. Use Supabase's SQL editor or migrations to create tables.

Migrate Authentication

Export Firebase Auth users using the Firebase Admin SDK. Import them into Supabase Auth. Supabase supports email/password, OAuth, and magic links just like Firebase.

Transfer Data

Export Firestore data to JSON. Write a migration script to transform document structure to relational rows and insert into Supabase via the client library or direct SQL import.

Migrate Storage Files

Download Firebase Storage files. Upload to Supabase Storage buckets. Update all file reference URLs in your database. Set up storage policies for access control.

Update Client Code

Replace Firebase SDK imports with @supabase/supabase-js. Rewrite queries from Firestore's document model to Supabase's PostgREST API. Real-time subscriptions use a similar pattern.

Test and Deploy

Run your full test suite against Supabase. Verify auth flows, data queries, real-time subscriptions, and file uploads. Deploy incrementally: use feature flags if possible.