Bij Aurabase hebben we onszelf vanaf de ontwerpfase een sterke beperking opgelegd: het SDK-oppervlak en de RLS-conventies moesten drop-in-compatibel zijn met Supabase. Hetzelfde createClient(), hetzelfde .from().select().eq(), hetzelfde SQL Postgres beleid. Het idee: als je weg wilt, ga dan weg – wij maken het triviaal. Hier vindt u het volledige speelboek.
Wat beweegt, wat blijft
Maak voordat u begint een lijst van wat er zal veranderen en wat zal blijven. Spoiler: het merendeel blijft.
| Postgres Schema | HETZELFDE | pg_dump → pg_herstel. Extensies, triggers, functies, indexen: alles kan. |
|---|---|---|
| RLS Beleid | HETZELFDE | Dezelfde syntaxis. auth.uid(), auth.role(), auth.jwt() werken zoals ze zijn. |
| JavaScript-SDK | 95% IDENTIEK | Vervang @supabase/supabase-js door @aurabase/aurabase-js. Dezelfde ketenbare API. |
| Authenticatie stroomt | HETZELFDE | signUp, signInWithPassword, signInWithOAuth, mfa - dezelfde namen, dezelfde handtekeningen. |
| Opslag-API | HETZELFDE | aura.storage.from(bucket).upload(...) · compatibel met S3 · overdraagbaar RLS beleid. |
| Realtime | HETZELFDE | channel().on("postgres_changes", ...) ongewijzigd. Aanwezigheid + uitzending hetzelfde. |
| Edge Functions | HETZELFDE | Deno.serve() geplakt zoals het is in de Studio-editor. De CLI zal functies inzetten die gericht zijn op een afzonderlijk pad (Rust gecompileerd naar WASM). |
| Dashboard | ANDERS | Studio Aurabase · wij helpen je oriënteren. |
Maak het doelproject Aurabase
Maak een nieuw Aurabase-project met de officiële CLI en koppel deze map vervolgens aan het project, zodat de volgende opdrachten er automatisch op worden toegepast.
# Aurabase account + CLI
npm i -g @aurabase/cli
aura login
# Maak het project (Postgres engine)
aura projects create my-app --engine postgres
# Koppel deze map aan het aangemaakte project
aura link --project-id <uuid-du-projet>
# Haal de API-sleutels van het gekoppelde project op
aura projects api-keys
Dump Supabase, herstel Aurabase
Een standaard pg_dump / pg_restore: Aurabase geeft een directe Postgres-verbindingsreeks weer voor elk project (Studio → Instellingen → Verbinding), er is geen tussentijdse transformatie nodig.
# Haal de Supabase-verbindingsreeks op uit hun dashboard
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Openbare schemadump (zonder Supabase systeemschema's)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Aurabase-verbindingsreeks ophalen (Studio → Instellingen → Verbinding)
# De parameter ?search_path= is VERPLICHT: deze verwijst naar het schema van uw project
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Herstel met standaard pg_restore
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# Genereer TypeScript-typen opnieuw
aura db generate > src/aurabase.types.ts
Gebruikers migreren
Een punt dat moet worden gecorrigeerd in vergelijking met wat we hier eerder hebben aangegeven: Aurabase hasht wachtwoorden met Argon2id, maar Supabase (GoTrue) hasht zijn eigen wachtwoorden standaard met bcrypt — de twee formaten zijn niet uitwisselbaar. Uw gebruikers zullen daarom, zoals bij de meeste migraties, eenmalig hun wachtwoord moeten resetten.
Aurabase biedt momenteel geen massa-importtool van Supabase. Twee opties: laat uw gebruikers zichzelf opnieuw registreren (signUp met hetzelfde e-mailadres), of maak ze één voor één opnieuw aan de beheerderskant met aura auth users create --email <email> voordat een wachtwoordreset wordt geactiveerd.
Actieve sessies aan de Supabase-kant worden niet geporteerd (technisch onmogelijk: elk platform ondertekent zijn JWT's met zijn eigen sleutel). Gebruikers moeten opnieuw inloggen met hun nieuwe wachtwoord.
Pas de klantcode aan
Een zoek/vervanging is in 95% van de gevallen voldoende.
// VOOR (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// NA (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// De rest van de code verandert niet:
await aura.from('posts').select('*').eq('author_id', userId)
Implementeer Edge Functions
Aurabase biedt twee paden voor Edge Functions: de Studio-code-editor (Deno runtime, hetzelfde als Supabase - plak uw functie zoals deze is) en de aura functions deployCLI, die streeft naar een apart pad voor functies geschreven in Rust en gecompileerd in WASM. Gebruik Studio om bestaande Deno-code te migreren zonder deze te herschrijven.
// Werkt hetzelfde, geplakt zoals het is in de Studio-editor
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
DNS-omschakeling en productielancering
Twee mogelijke strategieën. De eerste wordt voor 99% van de gevallen aanbevolen.
- Directe cutover — verander
NEXT_PUBLIC_AURABASE_URLenNEXT_PUBLIC_AURABASE_ANON_KEYin uw omgevingsvars, herimplementeer. Gebruikers maken opnieuw verbinding, alles werkt. Aanbevolen voor de meeste projecten. - Tijdelijk dubbel schrijven — schrijf Supabase + Aurabase gelijktijdig gedurende 48 uur, controleer de consistentie van kritische tabellen handmatig (rijtelling, checksums) en sluit vervolgens Supabase af. Voorkeur voor kritische apps.
Wij zijn er als er iets vastloopt
Voor grote projecten of met strikte compliance-beperkingen kan ons team u ondersteunen bij de migratie. Contacteer ons voor een offerte op maat van uw project.