Update to oauth2 package README for Flutter Web info (#1961)

AbgarSim · mosuem · sigurdm · web-flow · commit 81588f32d4f7 · 2025-10-14T09:58:52.000+02:00
Co-authored-by: Moritz &lt;mosum@google.com&gt;
Co-authored-by: Sigurd Meldgaard &lt;sigurdm@google.com&gt;
diff --git a/pkgs/oauth2/CHANGELOG.md b/pkgs/oauth2/CHANGELOG.md
@@ -1,4 +1,7 @@
-## 2.0.4-wip
+## 2.0.4
+
+* Updated README with example for Flutter Web.
+
 
 * Require Dart 3.4
 
diff --git a/pkgs/oauth2/README.md b/pkgs/oauth2/README.md
@@ -128,15 +128,16 @@ because different options exist for each platform.
 For Flutter apps, there's two popular approaches:
 
 1.  Launch a browser using [url_launcher][] and listen for a redirect using
-    [uni_links][].
+    [app_links][].
 
     ```dart
       if (await canLaunch(authorizationUrl.toString())) {
         await launch(authorizationUrl.toString()); }
 
       // ------- 8< -------
 
-      final linksStream = getLinksStream().listen((Uri uri) async {
+      final appLinks = AppLinks();
+      final linksStream = appLinks.uriLinkStream.listen((Uri uri) async {
        if (uri.toString().startsWith(redirectUrl)) {
          responseUrl = uri;
        }
@@ -161,6 +162,46 @@ For Flutter apps, there's two popular approaches:
       );
     ```
 
+
+1.  To handle redirect on Flutter Web you would need to add an html file to the web folder with some  
+additional JS code to handle the redirect back to the app (in this example the code will be saved 
+and passed through localStorage).
+
+    ```html
+        <!DOCTYPE html>
+        <html>
+        <head>
+            <meta charset="UTF-8" />
+            <title>OAuth Callback</title>
+        </head>
+        <body>
+        <script>
+            const urlParams = new URLSearchParams(window.location.search);
+            const code = urlParams.get('code');
+        
+            // Store them in localStorage (or sessionStorage).
+            if (code) {
+              localStorage.setItem('oauth_code', code);
+            }
+            
+            // Redirect back to app
+            window.location.replace('/#/');
+        </script>
+        </body>
+        </html>
+    ```
+
+    After redirect to the application the code can be extracted and processed using the dart.html 
+    package
+
+    ```dart
+       import 'dart:html' as html;
+       ...
+       if(html.window.localStorage.containsKey('oauth_code')
+          code = html.window.localStorage.remove('oauth_code')
+       ...
+    ```
+
 For Dart apps, the best approach depends on the available options for accessing
 a browser. In general, you'll need to launch the authorization URL through the
 client's browser and listen for the redirect URL.
@@ -255,6 +296,6 @@ File('~/.myapp/credentials.json').writeAsString(client.credentials.toJson());
 [resourceOwnerPasswordGrantDocs]: https://oauth.net/2/grant-types/password/
 [resourceOwnerPasswordGrantMethod]: https://pub.dev/documentation/oauth2/latest/oauth2/resourceOwnerPasswordGrant.html
 [resourceOwnerPasswordGrantSection]: #resource-owner-password-grant
-[uni_links]: https://pub.dev/packages/uni_links
+[app_links]: https://pub.dev/packages/app_links
 [url_launcher]: https://pub.dev/packages/url_launcher
 [webview_flutter]: https://pub.dev/packages/webview_flutter
diff --git a/pkgs/oauth2/pubspec.yaml b/pkgs/oauth2/pubspec.yaml
@@ -1,5 +1,5 @@
 name: oauth2
-version: 2.0.4-wip
+version: 2.0.4
 description: >-
   A client library for authenticating with a remote service via OAuth2 on
   behalf of a user, and making authorized HTTP requests with the user's
