---
title: "Supabase Flutter SDK 1.0 Developer Preview"
description: "Supabase released the Developer Preview of version 1.0 for its Flutter SDK, prioritizing improvements to developer experience across Dart applications. The new version eliminates the need for boilerplate state classes, automating authentication state persistence and deep link processing directly after initialization. To better align with Dart conventions, the SDK now throws exceptions across auth, storage, and Postgrest instead of returning error objects, while also deprecating the .execute() method for database queries. Switching to the app_links library expands deep linking support to macOS and Windows alongside existing mobile and web platforms. Supabase also introduced a companion Auth UI library for prebuilt authentication interfaces and announced plans to integrate the Multiplayer Realtime engine in the stable release."
---

# Supabase Flutter SDK 1.0 Developer Preview

[Supabase](https://yomu.fyi/company/supabase) · Tyler Shukert · Aug 2, 2022

**Type:** Announcement

## Summary

Supabase released the Developer Preview of version 1.0 for its Flutter SDK, prioritizing improvements to developer experience across Dart applications. The new version eliminates the need for boilerplate state classes, automating authentication state persistence and deep link processing directly after initialization. To better align with Dart conventions, the SDK now throws exceptions across auth, storage, and Postgrest instead of returning error objects, while also deprecating the .execute() method for database queries. Switching to the app\_links library expands deep linking support to macOS and Windows alongside existing mobile and web platforms. Supabase also introduced a companion Auth UI library for prebuilt authentication interfaces and announced plans to integrate the Multiplayer Realtime engine in the stable release.

## Context

Earlier versions of the Supabase Flutter SDK required boilerplate classes like SupabaseAuthState to handle authentication state persistence and deep links. Additionally, mirroring JavaScript error handling by returning errors caused friction due to Dart lacking object destructuring, queries required calling .execute(), and deep link library limitations restricted support to iOS, Android, and Web.

## Approach / What changed

Supabase redesigned the SDK to automate auth persistence and deep linking upon initialization while removing obsolete state classes. The SDK switched to throwing errors across auth, Postgrest, and storage, deprecated .execute(), adopted the app\_links library to add macOS and Windows deep link support, and introduced an Auth UI package to provide prebuilt authentication components.

## Takeaways

- Supabase Flutter SDK 1.0 removes SupabaseAuthState and SupabaseAuthRequiredState classes, automating auth persistence and deep link handling right after SDK initialization.
- Error handling now throws exceptions across auth, Postgrest, and storage instead of returning error objects, and Postgrest queries no longer require calling .execute().
- Migrating to the app\_links library expands deep linking support to macOS and Windows alongside iOS, Android, and Web, with Linux support currently in development.

**Tags:** [Android](https://yomu.fyi/topic/android), [Authentication](https://yomu.fyi/topic/authentication), [Developer Experience](https://yomu.fyi/topic/developer-experience), [iOS](https://yomu.fyi/topic/ios), [Open Source](https://yomu.fyi/topic/open-source)

- Source: [Supabase](https://supabase.com/blog/supabase-flutter-sdk-1-developer-preview)
- Source URL: https://supabase.com/blog/supabase-flutter-sdk-1-developer-preview
- Ingested by Yomu: 2026-08-28T04:00:57.120Z

[Read original post](https://supabase.com/blog/supabase-flutter-sdk-1-developer-preview)