altogic

Description:

altogic

Altogic Dart #
Altogic Dart is a Dart client for the Altogic Client Library. It provides access to all the functionality of the Altogic Client Library.
This package includes some Flutter dependencies in addition to the altogic_dart package.
Quick start #
This altogic client library guide will show you how to use the key modules of the client library to execute commands in your backend app. For
more in-depth coverage, see the
Client API reference.
Flutter Guides / Examples

You can see the authentication basics with Quickstart Guide
You can try all methods and see the code blocks in the Example/Test Application
Also you can see the basics with the Example TO-DO Application

Additional Functionalities #
Default Local Storage #
AltogicClient needs a local storage implementation to hold sessions and user information. This package provides a
default local storage implementation that uses the shared_preferences
package.
import 'package:altogic_dart_flutter/altogic_dart_flutter.dart';

final altogic = createClient(
'your env url',
'your client key'
);
copied to clipboard
Auto Open Sign In With Provider URLs #
AltogicClient can open sign-in with provider URLs automatically. You can use the AuthManager.signInWithProvider method to open sign-in with provider URLs directly.
altogic.auth.signInWithProvider('google');
copied to clipboard
Handle Redirect URLs #
In many authentication flows/operations, Altogic redirects your user to a specific URL.
For example, oAuth2 flow after the user signed in with the provider sign-in page, Altogic redirects the user to the redirect URL you specified in the Altogic Designer > App Settings > Authentication.
You can handle redirect URLs on websites by getting which path opens the site.
You can use deep linking in mobile or desktop applications to open the application from a redirect URL.
Deep Linking Configuration
AltogicState #
If you use "AltogicState" at the root of the application, the "AltogicState" will be "mounted" throughout the application lifecycle. Thus, we can listen to the deep links when the application is resumed or launched with a deep link.
When the application opens by a deep link, AltogicState cannot synchronously inform you about the deep link. Instead, you can override methods to be called when a deep link opens the application.
Available methods to override: onEmailVerificationLink, onMagicLink, onOauthProviderLink, onEmailChangeLink, onPasswordResetLink.
AltogicState provides a getter named navigatorObserver to observe navigation events. You can use BuildContext as the parameter for deep linking methods. If you use navigatorObserver, e.g., onMagicLink called with context; otherwise, BuildContext will be null for these methods.

class AltogicAuthExampleApp extends StatefulWidget {
const AltogicAuthExampleApp({Key? key}) : super(key: key);

@override
State<AltogicAuthExampleApp> createState() => _AltogicAuthExampleAppState();
}

class _AltogicAuthExampleAppState extends AltogicState<AltogicAuthExampleApp> {
@override
void onEmailVerificationLink(BuildContext? context, EmailVerificationRedirect redirect) {
// Handle email verification link
}

@override
void onMagicLink(BuildContext? context, MagicLinkRedirect redirect) {
// Handle magic link
}

@override
void onPasswordResetLink(BuildContext? context, PasswordResetRedirect redirect) {
// Handle password reset link
}

@override
void onEmailChangeLink(BuildContext? context, ChangeEmailRedirect redirect) {
// Handle email change link
}

@override
void onOauthProviderLink(BuildContext? context, OauthRedirect redirect) {
// Handle oauth provider link
}

@override
Widget build(BuildContext context) {
return MaterialApp(
navigatorObservers: [navigatorObserver],
// ...
);
}
}

copied to clipboard
When Application Not Running #
Generally, in the first run of the application, many developers show a splash screen. In this case, the application is launched with a deep link, AuthState.onX methods are triggered, and maybe the user is navigated to another page from the triggered method. Also, the splash screen will try to navigate to another page. This case causes a conflict.
To avoid this conflict, you can use AltogicState.applicationInitialRedirect static getter:
Future<void> init() async {
// Check if the application was launched with a deep link
var launchedRedirect = await AltogicState.applicationInitialRedirect;
if (launchedRedirect != null) {
return;
}
// navigate now
}
copied to clipboard

You can use the AltogicState.applicationInitialRedirect getter instead of the AltogicState.onX methods. But you have to listen to ApplicationLifecycle events manually to handle deep links.

Restore Auth Session
AltogicClient can restore the session from local storage. To do this, you can use the AltogicClient.restoreAuthSession method.

If the application is not running and launched with a deep link, the restoreAuthSession method checks if the application launched with a deep-link. If the application opens with a deep-link, the restoreAuthSession method will not restore the session from local storage. (Necessary to avoid conflicts)

await altogic.restoreAuthSession();
copied to clipboard
Learn more #
You can use the following resources to learn more and get help

🚀 Quick start
📜 Altogic Docs
💬 Discord community
📰 Discussion forums

Bugs Report #
Think you’ve found a bug? Please, send us an email [email protected] or open issue on GitHub.
altogic_dart package repository
altogic package repository
Support / Feedback #
For issues with, questions about, feedback for the client library, or want to see a new feature please, send us an email
[email protected] or reach out to our community forums