🎯 Type-Safe: Strongly-typed user models with C# generics
📱 MAUI Hybrid Support: Full .NET MAUI Blazor Hybrid support with deep link OAuth flows
🆕 What's New - Mobile Platform Support
All social providers now support MAUI Blazor Hybrid! Configure platform-specific OAuth redirect URIs for seamless authentication across Web (Blazor Server/WASM), iOS (MAUI), and Android (MAUI).
Supported Platforms & Providers
Provider
Blazor Server
Blazor WASM
MAUI iOS
MAUI Android
PKCE Support
Microsoft
✅
✅
✅
✅
✅
Google
✅
✅
✅
✅
-
More providers coming soon for Blazor
How It Works
Auto-Detection: Library automatically detects platform (Web/iOS/Android) via JSInterop and compile-time symbols
Platform-Specific URIs: Configure custom redirect URIs per platform (e.g., msauth:// for iOS, myapp:// for Android)
Deep Links: All buttons support mobile deep link OAuth callbacks through MAUI's
AppActions
No Breaking Changes: Existing Blazor Server/WASM apps work without modification
Quick Example
// Program.cs or MauiProgram.cs
builder.Services.AddSocialLoginUI(x =>
{
x.ApiUrl = "https://api.yourdomain.com";
// Platform configuration (auto-detects if not specified)
x.Platform = new PlatformConfig
{
Type = PlatformType.Auto, // Auto-detect Web/iOS/Android
// Smart redirect path detection:
// - Contains "://" -> Complete URI (mobile deep links: msauth://, myapp://)
// - Starts with "/" -> Relative path (web, auto-detects domain)
// - Empty/null -> Default "/account/login"
#if IOS
RedirectPath = "msauth://com.yourapp.bundle/auth", // Complete URI for iOS
#elif ANDROID
RedirectPath = "myapp://oauth/callback", // Complete URI for Android
#else
RedirectPath = "/account/login", // Relative path for web
#endif
LoginMode = LoginMode.Redirect
};
x.Microsoft.ClientId = builder.Configuration["Microsoft:ClientId"];
x.Google.ClientId = builder.Configuration["Google:ClientId"];
});
iOS Deep Link Configuration (Platforms/iOS/Info.plist):
builder.Services.AddSingleton<IDeepLinkHandler, DeepLinkHandler>();
// DeepLinkHandler.cs
public class DeepLinkHandler : IDeepLinkHandler
{
private readonly NavigationManager _navigationManager;
public DeepLinkHandler(NavigationManager navigationManager)
{
_navigationManager = navigationManager;
}
public void HandleDeepLink(string uri)
{
// OAuth callback from mobile OAuth flow
if (uri.Contains("code=") && uri.Contains("state="))
{
// Extract query parameters and navigate to callback page
var parsedUri = new Uri(uri);
var code = HttpUtility.ParseQueryString(parsedUri.Query).Get("code");
var state = HttpUtility.ParseQueryString(parsedUri.Query).Get("state");
_navigationManager.NavigateTo($"/account/login?code={code}&state={state}");
}
}
}
Platform Detection Utilities
Use built-in utilities for platform detection:
@inject IJSRuntime JSRuntime
@code {
private PlatformType _currentPlatform;
protected override async Task OnInitializedAsync()
{
// Async platform detection
_currentPlatform = await PlatformDetector.DetectPlatformAsync(JSRuntime);
// Or synchronous (compile-time detection)
_currentPlatform = PlatformDetector.DetectPlatformSync();
// Check if mobile
if (PlatformDetector.IsMobilePlatform(_currentPlatform))
{
// Configure mobile-specific behavior
}
// Check if Blazor Hybrid (MAUI)
if (PlatformDetector.IsBlazorHybrid())
{
// MAUI-specific initialization
}
}
}
Login Mode (Redirect)
Currently, only Redirect mode is supported in Blazor:
x.LoginMode = LoginMode.Redirect; // Default
Note: Popup mode will be added in a future release. For now, all OAuth flows use redirect navigation.
Complete MAUI Setup Example
// MauiProgram.cs
public static class MauiProgram
{
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
.ConfigureFonts(fonts =>
{
fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
});
// Blazor components
builder.Services.AddMauiBlazorWebView();
// Detect platform at startup
var currentPlatform = PlatformDetector.DetectPlatformSync();
// Social authentication with platform detection
builder.Services.AddSocialLoginUI(x =>
{
x.ApiUrl = "https://api.fantasoccer.com";
x.Platform = new PlatformConfig
{
Type = currentPlatform,
RedirectUri = currentPlatform switch
{
PlatformType.iOS => "msauth://com.keyserdsoze.fantasoccer/auth",
PlatformType.Android => "fantasoccer://oauth/callback",
_ => null // Web: use NavigationManager.BaseUri
},
RedirectPath = "/account/login",
LoginMode = LoginMode.Redirect
};
// Read from configuration
x.Microsoft.ClientId = builder.Configuration["Microsoft:ClientId"];
x.Google.ClientId = builder.Configuration["Google:ClientId"];
});
// Repository with automatic authorization
builder.Services.AddRepository<User, Guid>(repositoryBuilder =>
{
repositoryBuilder.WithApiClient(apiBuilder =>
{
apiBuilder.WithHttpClient("https://api.fantasoccer.com")
.WithDefaultRetryPolicy();
});
});
builder.Services.AddDefaultAuthorizationInterceptorForApiHttpClient();
return builder.Build();
}
}
📱 Mobile OAuth Configuration (MAUI)
Microsoft Entra ID (Azure AD) for MAUI
Go to Azure Portal → App registrations → Your app
Under Authentication, add Mobile and desktop applications platform