Flutter Sample App

This sample app demonstrates the integration of the Auth0 Flutter SDK into a Flutter app. The sample is a companion to the Auth0 Flutter Quickstart.

Requirements

• Flutter 3+
• Xcode 14.x / 15.x (for iOS/macOS)
• Android Studio 4+ (for Android)

Note

On iOS 17.4+ and macOS 14.4+ it is possible to use Universal Links as callback and logout URLs. auth0_flutter will fall back to using a custom URL scheme on older iOS / macOS versions.

This feature requires Xcode 15.3+ and a paid Apple Developer account.

If you do not have a paid Apple Developer account, skip step 3 and set the useHTTPS parameter to false in the login() and logout() calls at lib/example_app.dart.

Important

On every step, if you have a custom domain, replace the YOUR_AUTH0_DOMAIN and {yourDomain} placeholders with your custom domain instead of the value from the settings page.

1. Configure the Auth0 Application

📱 Mobile/Desktop

Go to the settings page of your Auth0 application and add the following URLs to Allowed Callback URLs and Allowed Logout URLs, depending on the platform you want to use.

Android

SCHEME://YOUR_AUTH0_DOMAIN/android/YOUR_PACKAGE_NAME/callback

iOS

https://YOUR_AUTH0_DOMAIN/ios/YOUR_BUNDLE_IDENTIFIER/callback,
YOUR_BUNDLE_IDENTIFIER://YOUR_AUTH0_DOMAIN/ios/YOUR_BUNDLE_IDENTIFIER/callback

macOS

https://YOUR_AUTH0_DOMAIN/macos/YOUR_BUNDLE_IDENTIFIER/callback,
YOUR_BUNDLE_IDENTIFIER://YOUR_AUTH0_DOMAIN/macos/YOUR_BUNDLE_IDENTIFIER/callback

Example

If your iOS bundle identifier were com.example.MyApp and your Auth0 Domain were example.us.auth0.com, then this value would be:

https://example.us.auth0.com/ios/com.example.MyApp/callback,
com.example.MyApp://example.us.auth0.com/ios/com.example.MyApp/callback

Important

Make sure that the Auth0 application type is Native. Otherwise, you might run into errors due to the different configurations of other application types.

🌐 Web

Go to the settings page of your Auth0 application and configure the following URLs:

• Allowed Callback URLs: http://localhost:3000
• Allowed Logout URLs: http://localhost:3000
• Allowed Web Origins: http://localhost:3000

2. Configure the SDK

📱🌐 Mobile/Desktop/Web

Rename .env.example to .env and replace the {yourClientId} and {yourDomain} placeholders with the Client ID and domain of your Auth0 application.

AUTH0_DOMAIN={yourDomain}
AUTH0_CLIENT_ID={yourClientId}
AUTH0_CUSTOM_SCHEME=com.auth0.sample # For Android

Android: Configure the string resources

In the sample, we are using values referenced from android/app/src/main/res/values/strings.xml. Rename strings.xml.example to strings.xml and replace the {yourDomain} placeholder with the domain of your Auth0 application.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="com_auth0_domain">{yourDomain}</string>
    <string name="com_auth0_scheme">com.auth0.sample</string>
</resources>

3. iOS/macOS: Configure the associated domain

Configure the entitlements

Open ios/Runner.xcodeproj (or macos/Runner.xcodeproj, for macOS) in Xcode and go to the settings of the Runner target. In the Signing & Capabilities tab, change the default bundle identifier from com.auth0.samples.SwiftSample to another value of your choosing. Then, ensure the Automatically manage signing box is checked, and that your Apple Team is selected.

Under Associated Domains, find the following entry:

webcredentials:YOUR_AUTH0_DOMAIN

Replace the YOUR_AUTH0_DOMAIN placeholder with the domain of your Auth0 application.

Example

If your Auth0 Domain were example.us.auth0.com, then this value would be:

webcredentials:example.us.auth0.com

Configure the Team ID and bundle identifier

Open the settings page of your Auth0 application, scroll to the end, and open Advanced Settings > Device Settings. In the iOS section, set Team ID to your Apple Team ID, and App ID to the app's bundle identifier.

This will add the app to your Auth0 tenant's apple-app-site-association file.

Note

For the associated domain to work, the app must be signed with your team certificate even when building for the iOS simulator. Make sure you are using the Apple Team whose Team ID is configured in the settings page of your Auth0 application.

4. Run the sample

Use the Flutter CLI to run the app.

📱 Mobile/Desktop

flutter run

Ensure you have at least one emulator/simulator running. If you have multiple running, the CLI will prompt you to select the one to run the app on.

🌐 Web

flutter run -d chrome --web-port 3000 --web-renderer html

Issue Reporting

For general support or usage questions, use the Auth0 Community forums or raise a support ticket. Only raise an issue if you have found a bug or want to request a feature.

Do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.

---

Auth0 is an easy-to-implement, adaptable authentication and authorization platform. To learn more check out Why Auth0?

This project is licensed under the MIT license. See the LICENSE file for more info.