In Aurabase, ci siamo posti un forte vincolo sin dalla fase di progettazione: la superficie dell'SDK e le convenzioni RLS dovevano essere compatibili drop-in con Supabase. Stessi createClient(), stessi .from().select().eq(), stesse policy SQL Postgres. L'idea: se vuoi andartene, vattene: la rendiamo banale. Ecco il playbook completo.
Ciò che si muove, ciò che resta
Prima di iniziare, elenca cosa cambierà e cosa rimarrà. Spoiler: la maggioranza resta.
| Postgres Schema | STESSO | pg_dump → pg_restore. Estensioni, trigger, funzioni, indici: tutto va bene. |
|---|---|---|
| RLS Politiche | STESSO | Stessa sintassi. auth.uid(), auth.role(), auth.jwt() funzionano così come sono. |
| SDK JavaScript | 95% IDENTICO | Sostituisci @supabase/supabase-js con @aurabase/aurabase-js. Stessa API concatenabile. |
| Flussi di autenticazione | STESSO | signUp, signInWithPassword, signInWithOAuth, mfa: stessi nomi, stesse firme. |
| API di archiviazione | STESSO | aura.storage.from(bucket).upload(...) · compatibilità S3 · politiche trasferibili RLS. |
| In tempo reale | STESSO | channel().on("postgres_changes", ...) invariato. Presenza + trasmissione uguale. |
| Edge Functions | STESSO | Deno.serve() incollato così com'è nell'editor di Studio. La CLI avrà funzioni di distribuzione mirate a un percorso separato (Rust compilato in WASM). |
| Cruscotto | DIVERSO | Studio Aurabase · ti aiutiamo a orientarti. |
Crea il progetto di destinazione Aurabase
Crea un nuovo progetto Aurabase con la CLI ufficiale, quindi collega questa cartella al progetto in modo che i seguenti comandi si applichino automaticamente ad esso.
# account Aurabase + CLI
npm i -g @aurabase/cli
aura login
# Crea il progetto (motore Postgres)
aura projects create my-app --engine postgres
# Collega questa cartella al progetto creato
aura link --project-id <uuid-du-projet>
# Recupera le chiavi API del progetto collegato
aura projects api-keys
Scarica Supabase, ripristina Aurabase
Uno standard pg_dump / pg_restore: Aurabase espone una stringa di connessione diretta Postgres per ciascun progetto (Studio → Impostazioni → Connessione), senza necessità di trasformazione intermedia.
# Recupera la stringa di connessione Supabase dalla dashboard
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Dump dello schema pubblico (senza schemi di sistema Supabase)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Recupera la stringa di connessione Aurabase (Studio → Impostazioni → Connessione)
# Il parametro ?search_path= è OBBLIGATORIO: indirizza allo schema del tuo progetto
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Ripristina con pg_restore standard
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# Rigenera i tipi TypeScript
aura db generate > src/aurabase.types.ts
Migrare gli utenti
Un punto da correggere rispetto a quanto affermato qui in precedenza: Aurabase esegue l'hashing delle password con Argon2id, ma Supabase (GoTrue) esegue l'hashing delle proprie password per impostazione predefinita con bcrypt — i due formati non sono intercambiabili. I tuoi utenti dovranno quindi reimpostare la propria password una volta, come con la maggior parte delle migrazioni.
Aurabase attualmente non offre uno strumento di importazione di massa da Supabase. Due opzioni: consentire ai tuoi utenti di registrarsi nuovamente (signUp con lo stesso indirizzo email) o ricrearli uno per uno sul lato amministratore con aura auth users create --email <email> prima di attivare la reimpostazione della password.
Le sessioni attive sul lato Supabase non vengono trasferite (tecnicamente impossibile: ciascuna piattaforma firma i propri JWT con la propria chiave). Gli utenti dovranno effettuare nuovamente l'accesso, con la nuova password.
Adattare il codice cliente
Una ricerca/sostituzione è sufficiente nel 95% dei casi.
// PRIMA (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// DOPO (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// Il resto del codice non cambia:
await aura.from('posts').select('*').eq('author_id', userId)
Distribuisci Edge Functions
Aurabase offre due percorsi per Edge Functions: l'editor di codice di Studio (Deno runtime, uguale a Supabase — incolla la funzione così com'è) e aura functions deployCLI, che mira a un percorso separato per le funzioni scritte in Rust e compilate in WASM. Per eseguire la migrazione del codice Deno esistente senza riscriverlo, utilizzare Studio.
// Funziona allo stesso modo, incollato così com'è nell'editor di Studio
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
Switchover DNS e avvio della produzione
Due possibili strategie. Il primo è consigliato nel 99% dei casi.
- Cutover diretto — cambia
NEXT_PUBLIC_AURABASE_URLeNEXT_PUBLIC_AURABASE_ANON_KEYnelle tue variabili di ambiente, ridistribuisci. Gli utenti si riconnettono, tutto funziona. Consigliato per la maggior parte dei progetti. - Doppia scrittura temporanea: scrivi Supabase + Aurabase simultaneamente per 48 ore, controlla manualmente la coerenza delle tabelle critiche (conteggio delle righe, checksum), quindi spegni Supabase. Preferito per le app critiche.
Siamo qui se le cose si bloccano
Per progetti di grandi dimensioni o con rigidi vincoli di conformità, il nostro team può supportarti nella migrazione. Contattaci per un'offerta su misura per il tuo progetto.