La tua prima app con Flutter

Nella dashboard crea un progetto. Apri Editor SQL ed esegui:

create table todos (
  id bigint generated by default as identity primary key,
  owner_id uuid not null default espobase.user_id(),
  title text not null,
  done boolean not null default false,
  created_at timestamptz not null default now()
);

-- Row level security is already on. Each signed-in user sees and changes only their own todos:
create policy "Users manage their own todos" on todos
  for all
  using (owner_id = espobase.user_id())
  with check (owner_id = espobase.user_id());

• API: crea una chiave pubblicabile e copiala subito; le chiavi vengono mostrate solo alla creazione. Non mettere mai una chiave segreta (eb_sk_…) in un'app: chiunque può aprire un'app e leggerla.
• Autenticazione › Impostazioni: aggiungi il link della tua app in URL di reindirizzamento consentiti, per esempio myapp://auth/callback. Le email di conferma e l'accesso social tornano lì. Registra lo stesso schema nei tuoi progetti Android e iOS.

Il pacchetto Espobase funziona su tutte le piattaforme Flutter. Gli altri pacchetti proteggono la sessione e aprono le pagine di accesso:

flutter pub add espobase flutter_secure_storage flutter_web_auth_2 sign_in_with_apple

Per impostazione predefinita la sessione resta in memoria. Dai al client un archivio sicuro e la persona resta connessa quando l'app si riavvia. La sessione viene rinnovata per te.

// lib/espobase.dart
import 'package:espobase/espobase.dart';
import 'package:flutter_secure_storage/flutter_secure_storage.dart';

class SecureSessionStorage implements SessionStorage {
  final _store = const FlutterSecureStorage();
  @override Future<String?> get(String key) => _store.read(key: key);
  @override Future<void> set(String key, String value) => _store.write(key: key, value: value);
  @override Future<void> remove(String key) => _store.delete(key: key);
}

final espobase = EspobaseClient(
  const String.fromEnvironment('ESPOBASE_URL'), // https://api.espobase.com/project/<your project ref>
  const String.fromEnvironment('ESPOBASE_KEY'), // the PUBLISHABLE key (eb_pk_…): safe in an app
  options: ClientOptions(sessionStorage: SecureSessionStorage()),
);

// myapp://auth/callback (the scheme is in your Android and iOS projects). Add it under Authentication › Settings.
const redirectTo = 'myapp://auth/callback';

await espobase.auth.signUp(email: email, password: password, redirectTo: redirectTo);
await espobase.auth.signInWithPassword(email: email, password: password);

// The confirmation email opens the app at redirectTo#type=signup&token=…
await espobase.auth.verifyEmail(token: token);

// Re-render when the user signs in or out.
espobase.auth.onAuthStateChange.listen((change) => setState(() => session = change.session));

Con la conferma via email attiva, la persona riceve un link che apre la tua app all'indirizzo che hai passato come redirectTo, con il token dopo un #. Confermalo con espobase.auth.verifyEmail(token: …).

Attivalo in Autenticazione › Provider › Apple con il tuo account Apple Developer e aggiungi lì il bundle ID della tua app. Dai ad Apple il nonce con hash e a Espobase quello originale:

import 'package:sign_in_with_apple/sign_in_with_apple.dart';

Future<void> signInWithApple() async {
  final nonce = AppleNonce();
  final credential = await SignInWithApple.getAppleIDCredential(
    scopes: [AppleIDAuthorizationScopes.email],
    nonce: nonce.hashed, // Apple gets the hash …
  );
  await espobase.auth.signInWithIdToken(
    token: credential.identityToken!,
    nonce: nonce.raw, // … Espobase gets the raw value
  );
}

import 'package:flutter_web_auth_2/flutter_web_auth_2.dart';

Future<void> signInWithGoogle() async {
  final url = await espobase.auth.signInWithOAuth(
    provider: OAuthProvider.google,
    redirectTo: 'myapp://auth/callback',
  );
  final result = await FlutterWebAuth2.authenticate(url: url.toString(), callbackUrlScheme: 'myapp');
  final code = Uri.parse(result).queryParameters['code'];
  if (code != null) await espobase.auth.exchangeCodeForSession(code);
}

Attiva prima il provider in Autenticazione › Provider. L'app apre il provider nel browser di sistema e riporta la persona indietro tramite il link della tua app; exchangeCodeForSession completa l'accesso. Solo questa app può completarlo: il segreto monouso resta sul telefono.

final todos = await espobase.from('todos').select().order('created_at'); // List<Map<String, dynamic>>

// owner_id fills itself in (its default is espobase.user_id()).
await espobase.from('todos').insert({'title': 'Buy milk'});
await espobase.from('todos').update({'done': true}).eq('id', todo['id']);
await espobase.from('todos').delete().eq('id', todo['id']);

Ogni richiesta porta con sé la persona connessa e il database applica la tua regola. Chi non ha effettuato l'accesso riceve una lista vuota e nessuno può leggere o modificare le attività di un altro, nemmeno chiamando direttamente l'API.

Crea un bucket in Storage e aggiungi una policy in modo che ogni persona possa scrivere nella propria cartella (vedi la guida al caricamento dei file). Passa i byte del file a upload: Caricamento di file

final bytes = await pickedFile.readAsBytes();
final userId = (await espobase.auth.currentUser())!.id;
await espobase.storage.from('photos').upload('$userId/photo.jpg', bytes, contentType: 'image/jpeg');

• Gli errori sono EspobaseException con un code (per esempio invalid_credentials) e un message che puoi mostrare.
• Il realtime non è ancora in questo pacchetto: per ora usa l'API REST.
• Lo stesso pacchetto funziona in Dart lato server.