One declarative product truth.
Every platform projected from it.

# supabase.yaml — the single source of truth
data_model:
  public:
    things:
      ownership: workspace
      primary_key: id
      fields:
        id: uuid
        workspace_id: uuid
        name: text
        category: thing_category
        notes: text
      nullable_fields: [notes]
      enum_values:
        thing_category: [device, document, other]
      client_access:
        select: member_of_workspace
        insert: member_of_workspace

rpc_functions:
  add_thing_note:
    args: { p_thing_id: uuid, p_note: text }
    returns: uuid

// GENERATED by supabase_client_gen — do not edit
final repo = ThingRepository(supabase.client);

// Typed, workspace-scoped, null-safe:
final things = await repo.select(workspaceId: wsId);
final created = await repo.insert(
  {'workspace_id': wsId, 'name': 'Drill'});

// Realtime stream from the publication:
repo.stream(workspaceId: wsId)
    .listen((things) => render(things));

// RPC as a typed top-level function:
final noteId = await addThingNote(
  pThingId: thing.id, pNote: 'inspected');

// thing.category is a real Dart enum:
if (thing.category == ThingCategory.device) { ... }