Bei Aurabase haben wir uns bereits in der Entwurfsphase eine starke Einschränkung auferlegt: Die SDK-Oberfläche und die RLS-Konventionen mussten Drop-in-kompatibel mit Supabase sein. Gleiche createClient(), gleiche .from().select().eq(), gleiche SQL-Richtlinien Postgres. Die Idee: Wenn du gehen willst, geh weg – wir machen es trivial. Hier ist das vollständige Playbook.
Was bewegt sich, was bleibt
Bevor Sie beginnen, listen Sie auf, was sich ändern wird und was bleiben wird. Spoiler: Die Mehrheit bleibt.
| Postgres Schema | GLEICH | pg_dump → pg_restore. Erweiterungen, Trigger, Funktionen, Indizes – alles ist möglich. |
|---|---|---|
| RLS Richtlinien | GLEICH | Gleiche Syntax. auth.uid(), auth.role(), auth.jwt() funktionieren wie sie sind. |
| JavaScript-SDK | 95 % IDENTISCH | Ersetzen Sie @supabase/supabase-js durch @aurabase/aurabase-js. Gleiche verkettbare API. |
| Authentifizierungsflüsse | GLEICH | signUp, signInWithPassword, signInWithOAuth, mfa – gleiche Namen, gleiche Signaturen. |
| Speicher-API | GLEICH | aura.storage.from(bucket).upload(...) · kompatibel S3 · übertragbare RLS Richtlinien. |
| Echtzeit | GLEICH | channel().on("postgres_changes", ...) unverändert. Präsenz + Übertragung gleich. |
| Edge Functions | GLEICH | Deno.serve() unverändert in den Studio-Editor eingefügt. In der CLI werden Funktionen bereitgestellt, die auf einen separaten Pfad ausgerichtet sind (Rust kompiliert zu WASM). |
| Armaturenbrett | ANDERS | Studio Aurabase · wir helfen Ihnen bei der Orientierung. |
Erstellen Sie das Zielprojekt Aurabase
Erstellen Sie mit der offiziellen CLI ein neues Aurabase-Projekt und verknüpfen Sie dann diesen Ordner mit dem Projekt, sodass die folgenden Befehle automatisch darauf angewendet werden.
# Aurabase-Konto + CLI
npm i -g @aurabase/cli
aura login
# Erstellen Sie das Projekt (Postgres-Engine)
aura projects create my-app --engine postgres
# Verknüpfen Sie diesen Ordner mit dem erstellten Projekt
aura link --project-id <uuid-du-projet>
# Rufen Sie die API-Schlüssel des verknüpften Projekts ab
aura projects api-keys
Supabase sichern, Aurabase wiederherstellen
Ein Standard pg_dump / pg_restore: Aurabase stellt eine direkte Postgres-Verbindungszeichenfolge für jedes Projekt bereit (Studio → Einstellungen → Verbindung), eine Zwischentransformation ist nicht erforderlich.
# Rufen Sie die Verbindungszeichenfolge Supabase aus ihrem Dashboard ab
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Öffentlicher Schema-Dump (ohne Supabase-Systemschemata)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Rufen Sie die Verbindungszeichenfolge Aurabase ab (Studio → Einstellungen → Verbindung).
# Der Parameter ?search_path= ist OBLIGATORISCH: Er leitet zum Schema Ihres Projekts weiter
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Wiederherstellung mit Standard-pg_restore
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# Generieren Sie TypeScript-Typen neu
aura db generate > src/aurabase.types.ts
Benutzer migrieren
Ein zu korrigierender Punkt im Vergleich zu dem, was wir zuvor hier angegeben haben: Aurabase hasht Passwörter mit Argon2id, aber Supabase (GoTrue) hasht seine eigenen Passwörter standardmäßig mit bcrypt – die beiden Formate sind nicht austauschbar. Ihre Benutzer müssen daher, wie bei den meisten Migrationen, einmalig ihr Passwort zurücksetzen.
Aurabase bietet derzeit kein Massenimport-Tool von Supabase an. Zwei Möglichkeiten: Lassen Sie Ihre Benutzer sich neu registrieren (signUp mit derselben E-Mail-Adresse) oder erstellen Sie sie einzeln auf der Administratorseite mit aura auth users create --email <email> neu, bevor Sie ein Passwort-Reset auslösen.
Aktive Sitzungen auf der Supabase-Seite werden nicht portiert (technisch unmöglich – jede Plattform signiert ihre JWTs mit ihrem eigenen Schlüssel). Benutzer müssen sich erneut mit ihrem neuen Passwort anmelden.
Passen Sie den Client-Code an
In 95 % der Fälle reicht ein Suchen/Ersetzen aus.
// VORHER (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// NACH (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// Der Rest des Codes ändert sich nicht:
await aura.from('posts').select('*').eq('author_id', userId)
Bereitstellen von Edge Functions
Aurabase bietet zwei Pfade für Edge Functions: den Studio-Code-Editor (Deno Laufzeit, dasselbe wie Supabase – fügen Sie Ihre Funktion unverändert ein) und die aura functions deployCLI, die einen separaten Pfad für in Rust geschriebene und in WASM kompilierte Funktionen anstrebt. Um vorhandenen Deno-Code ohne Neuschreiben zu migrieren, verwenden Sie Studio.
// Funktioniert genauso, wenn es so wie es ist in den Studio-Editor eingefügt wird
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
DNS-Umstellung und Produktionsstart
Zwei mögliche Strategien. Ersteres wird in 99 % der Fälle empfohlen.
- Direkte Umstellung – Ändern Sie
NEXT_PUBLIC_AURABASE_URLundNEXT_PUBLIC_AURABASE_ANON_KEYin Ihren Umgebungsvariablen und stellen Sie sie erneut bereit. Benutzer verbinden sich wieder, alles funktioniert. Empfohlen für die meisten Projekte. - Temporärer Dual-Write – 48 Stunden lang gleichzeitig in Supabase + Aurabase schreiben, die Konsistenz kritischer Tabellen manuell überprüfen (Zeilenzählung, Prüfsummen) und dann Supabase herunterfahren. Bevorzugt für kritische Apps.
Wir sind für Sie da, wenn es mal klemmt
Bei großen Projekten oder mit strengen Compliance-Auflagen unterstützt Sie unser Team bei der Migration. Kontaktieren Sie uns für ein auf Ihr Projekt zugeschnittenes Angebot.