Seu primeiro app com Flutter

No painel, crie um projeto. Abra o Editor SQL e execute:

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: crie uma chave publicável e copie-a agora; as chaves só são mostradas na criação. Nunca coloque uma chave secreta (eb_sk_…) em um app: qualquer pessoa pode abrir um app e lê-la.
• Autenticação › Configurações: adicione o link do seu app em URLs de redirecionamento permitidas, por exemplo myapp://auth/callback. Os e-mails de confirmação e o login social voltam para ele. Registre o mesmo esquema nos seus projetos Android e iOS.

O pacote Espobase funciona em todas as plataformas Flutter. Os outros pacotes mantêm a sessão segura e abrem as páginas de login:

flutter pub add espobase flutter_secure_storage flutter_web_auth_2 sign_in_with_apple

Por padrão a sessão fica na memória. Dê ao cliente um armazenamento seguro e a pessoa continua conectada quando o app reinicia. A sessão é renovada para você.

// 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));

Com a confirmação por e-mail ativada, a pessoa recebe um link que abre o seu app no endereço que você passou como redirectTo, com o token depois de um #. Confirme-o com espobase.auth.verifyEmail(token: …).

Ative em Autenticação › Provedores › Apple com a sua própria conta Apple Developer e adicione lá o bundle ID do seu app. Dê à Apple o nonce com hash e ao Espobase o original:

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);
}

Ative primeiro o provedor em Autenticação › Provedores. O app abre o provedor no navegador do sistema e traz a pessoa de volta pelo link do seu app; exchangeCodeForSession conclui o login. Só este app pode concluí-lo: o segredo de uso único fica no telefone.

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']);

Cada requisição leva a pessoa conectada, e o banco de dados aplica a sua regra. Quem não está conectado recebe uma lista vazia, e ninguém consegue ler ou alterar as tarefas de outra pessoa, nem chamando a API diretamente.

Crie um bucket em Storage e adicione uma política para que cada pessoa possa gravar na própria pasta (veja o guia de envio de arquivos). Passe os bytes do arquivo para upload: Envio de arquivos

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');

• Os erros são EspobaseException com um code (por exemplo invalid_credentials) e uma message que você pode mostrar.
• O tempo real ainda não está neste pacote: por enquanto use a API REST.
• O mesmo pacote funciona em Dart no servidor.