appwrite · abnegate · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Change Log
 
+## 21.0.0
+
+* Add array-based enum parameters (e.g., `permissions: List<BrowserPermission>`).
+* Breaking change: `Output` enum has been removed; use `ImageFormat` instead.
+* Add `Channel` helpers for Realtime.
+
 ## 20.3.3
 
 * Fix boolean parameter not handled correctly in Client requests

diff --git a/README.md b/README.md
@@ -7,7 +7,7 @@
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
 
-**This SDK is compatible with Appwrite server version latest. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-flutter/releases).**
+**This SDK is compatible with Appwrite server version 1.8.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-flutter/releases).**
 
 Appwrite is an open-source backend as a service server that abstracts and simplifies complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
 
@@ -19,7 +19,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  appwrite: ^20.3.3
+  appwrite: ^21.0.0
 ```
 
 You can install packages from the command line:

diff --git a/docs/examples/account/create-mfa-authenticator.md b/docs/examples/account/create-mfa-authenticator.md
@@ -7,5 +7,5 @@ Client client = Client()
 Account account = Account(client);
 
 MfaType result = await account.createMFAAuthenticator(
-    type: AuthenticatorType.totp,
+    type: enums.AuthenticatorType.totp,
 );
diff --git a/docs/examples/account/create-mfa-challenge.md b/docs/examples/account/create-mfa-challenge.md
@@ -7,5 +7,5 @@ Client client = Client()
 Account account = Account(client);
 
 MfaChallenge result = await account.createMFAChallenge(
-    factor: AuthenticationFactor.email,
+    factor: enums.AuthenticationFactor.email,
 );
diff --git a/docs/examples/account/create-o-auth-2-session.md b/docs/examples/account/create-o-auth-2-session.md
@@ -7,7 +7,7 @@ Client client = Client()
 Account account = Account(client);
 
 await account.createOAuth2Session(
-    provider: OAuthProvider.amazon,
+    provider: enums.OAuthProvider.amazon,
     success: 'https://example.com', // optional
     failure: 'https://example.com', // optional
     scopes: [], // optional

diff --git a/docs/examples/account/create-o-auth-2-token.md b/docs/examples/account/create-o-auth-2-token.md
@@ -7,7 +7,7 @@ Client client = Client()
 Account account = Account(client);
 
 await account.createOAuth2Token(
-    provider: OAuthProvider.amazon,
+    provider: enums.OAuthProvider.amazon,
     success: 'https://example.com', // optional
     failure: 'https://example.com', // optional
     scopes: [], // optional

diff --git a/docs/examples/account/delete-mfa-authenticator.md b/docs/examples/account/delete-mfa-authenticator.md
@@ -7,5 +7,5 @@ Client client = Client()
 Account account = Account(client);
 
 await account.deleteMFAAuthenticator(
-    type: AuthenticatorType.totp,
+    type: enums.AuthenticatorType.totp,
 );
diff --git a/docs/examples/account/update-mfa-authenticator.md b/docs/examples/account/update-mfa-authenticator.md
@@ -7,6 +7,6 @@ Client client = Client()
 Account account = Account(client);
 
 User result = await account.updateMFAAuthenticator(
-    type: AuthenticatorType.totp,
+    type: enums.AuthenticatorType.totp,
     otp: '<OTP>',
 );
diff --git a/docs/examples/avatars/get-browser.md b/docs/examples/avatars/get-browser.md
@@ -8,7 +8,7 @@ Avatars avatars = Avatars(client);
 
 // Downloading file
 Uint8List bytes = await avatars.getBrowser(
-    code: Browser.avantBrowser,
+    code: enums.Browser.avantBrowser,
     width: 0, // optional
     height: 0, // optional
     quality: -1, // optional
@@ -20,7 +20,7 @@ file.writeAsBytesSync(bytes);
 // Displaying image preview
 FutureBuilder(
     future: avatars.getBrowser(
-    code: Browser.avantBrowser,
+    code: enums.Browser.avantBrowser,
     width:0 , // optional
     height:0 , // optional
     quality:-1 , // optional

diff --git a/docs/examples/avatars/get-credit-card.md b/docs/examples/avatars/get-credit-card.md
@@ -8,7 +8,7 @@ Avatars avatars = Avatars(client);
 
 // Downloading file
 Uint8List bytes = await avatars.getCreditCard(
-    code: CreditCard.americanExpress,
+    code: enums.CreditCard.americanExpress,
     width: 0, // optional
     height: 0, // optional
     quality: -1, // optional
@@ -20,7 +20,7 @@ file.writeAsBytesSync(bytes);
 // Displaying image preview
 FutureBuilder(
     future: avatars.getCreditCard(
-    code: CreditCard.americanExpress,
+    code: enums.CreditCard.americanExpress,
     width:0 , // optional
     height:0 , // optional
     quality:-1 , // optional

diff --git a/docs/examples/avatars/get-flag.md b/docs/examples/avatars/get-flag.md
@@ -8,7 +8,7 @@ Avatars avatars = Avatars(client);
 
 // Downloading file
 Uint8List bytes = await avatars.getFlag(
-    code: Flag.afghanistan,
+    code: enums.Flag.afghanistan,
     width: 0, // optional
     height: 0, // optional
     quality: -1, // optional
@@ -20,7 +20,7 @@ file.writeAsBytesSync(bytes);
 // Displaying image preview
 FutureBuilder(
     future: avatars.getFlag(
-    code: Flag.afghanistan,
+    code: enums.Flag.afghanistan,
     width:0 , // optional
     height:0 , // optional
     quality:-1 , // optional

diff --git a/docs/examples/avatars/get-screenshot.md b/docs/examples/avatars/get-screenshot.md
@@ -16,21 +16,21 @@ Uint8List bytes = await avatars.getScreenshot(
     viewportWidth: 1920, // optional
     viewportHeight: 1080, // optional
     scale: 2, // optional
-    theme: Theme.light, // optional
+    theme: enums.Theme.dark, // optional
     userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15', // optional
     fullpage: true, // optional
     locale: 'en-US', // optional
-    timezone: Timezone.africaAbidjan, // optional
+    timezone: enums.Timezone.americaNewYork, // optional
     latitude: 37.7749, // optional
     longitude: -122.4194, // optional
     accuracy: 100, // optional
     touch: true, // optional
-    permissions: ["geolocation","notifications"], // optional
+    permissions: [enums.BrowserPermission.geolocation, enums.BrowserPermission.notifications], // optional
     sleep: 3, // optional
     width: 800, // optional
     height: 600, // optional
     quality: 85, // optional
-    output: ImageFormat.jpg, // optional
+    output: enums.ImageFormat.jpeg, // optional
 )
 
 final file = File('path_to_file/filename.ext');
@@ -47,21 +47,21 @@ FutureBuilder(
     viewportWidth:1920 , // optional
     viewportHeight:1080 , // optional
     scale:2 , // optional
-    theme: Theme.light, // optional
+    theme: enums.Theme.dark, // optional
     userAgent:'Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15' , // optional
     fullpage:true , // optional
     locale:'en-US' , // optional
-    timezone: Timezone.africaAbidjan, // optional
+    timezone: enums.Timezone.americaNewYork, // optional
     latitude:37.7749 , // optional
     longitude:-122.4194 , // optional
     accuracy:100 , // optional
     touch:true , // optional
-    permissions:["geolocation","notifications"] , // optional
+    permissions: [enums.BrowserPermission.geolocation, enums.BrowserPermission.notifications], // optional
     sleep:3 , // optional
     width:800 , // optional
     height:600 , // optional
     quality:85 , // optional
-    output: ImageFormat.jpg, // optional
+    output: enums.ImageFormat.jpeg, // optional
 ), // Works for both public file and private file, for private files you need to be logged in
     builder: (context, snapshot) {
       return snapshot.hasData && snapshot.data != null

diff --git a/docs/examples/functions/create-execution.md b/docs/examples/functions/create-execution.md
@@ -11,7 +11,7 @@ Execution result = await functions.createExecution(
     body: '<BODY>', // optional
     xasync: false, // optional
     path: '<PATH>', // optional
-    method: ExecutionMethod.gET, // optional
+    method: enums.ExecutionMethod.gET, // optional
     headers: {}, // optional
     scheduledAt: '<SCHEDULED_AT>', // optional
 );
diff --git a/docs/examples/storage/get-file-preview.md b/docs/examples/storage/get-file-preview.md
@@ -12,15 +12,15 @@ Uint8List bytes = await storage.getFilePreview(
     fileId: '<FILE_ID>',
     width: 0, // optional
     height: 0, // optional
-    gravity: ImageGravity.center, // optional
+    gravity: enums.ImageGravity.center, // optional
     quality: -1, // optional
     borderWidth: 0, // optional
     borderColor: '', // optional
     borderRadius: 0, // optional
     opacity: 0, // optional
     rotation: -360, // optional
     background: '', // optional
-    output: ImageFormat.jpg, // optional
+    output: enums.ImageFormat.jpg, // optional
     token: '<TOKEN>', // optional
 )
 
@@ -34,15 +34,15 @@ FutureBuilder(
     fileId:'<FILE_ID>' ,
     width:0 , // optional
     height:0 , // optional
-    gravity: ImageGravity.center, // optional
+    gravity: enums.ImageGravity.center, // optional
     quality:-1 , // optional
     borderWidth:0 , // optional
     borderColor:'' , // optional
     borderRadius:0 , // optional
     opacity:0 , // optional
     rotation:-360 , // optional
     background:'' , // optional
-    output: ImageFormat.jpg, // optional
+    output: enums.ImageFormat.jpg, // optional
     token:'<TOKEN>' , // optional
 ), // Works for both public file and private file, for private files you need to be logged in
     builder: (context, snapshot) {

diff --git a/docs/examples/teams/create-membership.md b/docs/examples/teams/create-membership.md
@@ -8,7 +8,7 @@ Teams teams = Teams(client);
 
 Membership result = await teams.createMembership(
     teamId: '<TEAM_ID>',
-    roles: [],
+    roles: [enums.Roles.admin],
     email: 'email@example.com', // optional
     userId: '<USER_ID>', // optional
     phone: '+12065550100', // optional

diff --git a/docs/examples/teams/update-membership.md b/docs/examples/teams/update-membership.md
@@ -9,5 +9,5 @@ Teams teams = Teams(client);
 Membership result = await teams.updateMembership(
     teamId: '<TEAM_ID>',
     membershipId: '<MEMBERSHIP_ID>',
-    roles: [],
+    roles: [enums.Roles.admin],
 );
diff --git a/lib/appwrite.dart b/lib/appwrite.dart
@@ -30,6 +30,7 @@ part 'query.dart';
 part 'permission.dart';
 part 'role.dart';
 part 'id.dart';
+part 'channel.dart';
 part 'operator.dart';
 part 'services/account.dart';
 part 'services/avatars.dart';