Cap-go / capacitor-social-login

@capgo/capacitor-social-login ➡️ Get Instant updates for your App with Capgo Missing a feature? We’ll build the plugin for you 💪 Fork Information This plugin is a fork of @codetrix-studio/capacitor-google-auth. We created this fork because the original plugin is "virtually" archived with no way to reach the maintainer in any medium, and only one person (@reslear) has write rights but doesn't handle native code. If you're currently using , we recommend migrating to this plugin. You can follow our migration guide here. About All social logins in one plugin This plugin implements social auth for: • Google (with credential manager) • Apple (with OAuth on android) • Facebook (with latest SDK) • Twitter/X (OAuth 2.0) • Generic OAuth2 (supports multiple providers: GitHub, Azure AD, Auth0, Okta, and any OAuth2-compliant server) This plugin is the all-in-one solution for social authentication on Web, iOS, and Android. It is our official alternative to the Appflow Social Login plugin. Ionic Auth Connect compatibility This plugin is designed to be compatible with Ionic Auth Connect provider names using the built-in OAuth2 engine. Use the Auth Connect preset wrapper ( ) to log in with , , , , and . • Compatibility guide: https://github.com/Cap-go/capacitor-social-login/blob/main/docs/auth_connect_compatibility.md • Migration guide: https://github.com/Cap-go/capacitor-social-login/blob/main/MIGRATION_AUTH_CONNECT.md Documentation Best experience to read the doc here: https://capgo.app/docs/plugins/social-login/getting-started/ Compatibility | Plugin version | Capacitor compatibility | Maintained | | -------------- | ----------------------- | ---------- | | v8.\*.\* | v8.\*.\* | ✅ | | v7.\*.\* | v7.\*.\* | On demand | | v6.\*.\* | v6.\*.\* | ❌ | | v5.\*.\* | v5.\*.\* | ❌ | > **Note:** The major version of this plugin follows the major version of Capacitor. Use the version that matches your Capacitor installation (e.g., plugin v8 for Capacitor 8). Only the latest major version is actively maintained. Install Dynamic Provider Dependencies You can configure which providers to include to reduce app size. This is especially useful if you only need specific providers. Configuration Add provider configuration to your : Provider Configuration • ** ** (default): Provider is enabled - dependencies are bundled in final APK/IPA • ** **: Provider is disabled - dependencies are not bundled in final APK/IPA Notes • Changes require running to take effect • If configuration is not provided, all providers default to (enabled, backward compatible) • **Important**: Disabling a provider ( ) will make it unavailable at runtime, regardless of whether it actually adds any dependencies. The provider will be disabled even if it uses only system APIs. • This configuration only affects iOS and Android platforms; it does not affect the web platform. • **Important**: Using means the dependency won't be bundled, but the plugin code still compiles against it. Ensure the consuming app includes the dependency if needed. • Apple Sign-In on Android uses OAuth flow without external SDK dependencies • Twitter uses standard OAuth 2.0 flow without external SDK dependencies Example: Reduce App Size To only include Google Sign-In and disable others: Apple How to get the credentials How to setup redirect url Android configuration For android you need a server to get the callback from the apple login. As we use the web SDK . Call the method with the provider iOS configuration call the method with the provider Facebook Docs: How to setup facebook login 📘 **Complete Facebook Business Login Guide** - Learn how to access Instagram, Pages, and business features Facebook Business Login This plugin fully supports Facebook Business Login for accessing business-related features and permissions. Business accounts can request additional permissions beyond standard consumer login, including Instagram and Pages management. **Supported Business Permissions:** • - Access to Instagram Basic Display API • - Access to Instagram Insights • - List of Pages the person manages • - Read engagement data from Pages • - Manage posts on Pages • - Manage business assets • And many more - see Facebook Permissions Reference **Configuration Requirements:** • Your Facebook app must be configured as a Business app in the Facebook Developer Console • Business permissions may require Facebook's App Review before production use • Your app must comply with Facebook's Business Use Case policies **Example - Instagram Basic Access:** **Example - Pages Management:** **Important Notes:** • Testing: You can test business permissions with test users and development apps without App Review • Production: Most business permissions require Facebook App Review before going live • Rate Limits: Business APIs have different rate limits - review Facebook's documentation • Setup: Follow Facebook Business Integration Guide Android configuration More information can be found here: https://developers.facebook.com/docs/android/getting-started Then call the method with the provider iOS configuration In file add or replace the following: Add the following in the file inside of the outermost : More information can be found here: https://developers.facebook.com/docs/facebook-login/ios Then call the method with the provider Google How to get the credentials Complete Configuration Example For Google login to work properly across all platforms, you need different client IDs and must understand the requirements for each mode: **Important Notes:** • : Required for Android and Web platforms • : Required for iOS platform • : Required when using on iOS or when you need to verify the token on the server (should be the same value as ) • : Returns only for backend authentication, no user profile data • : Returns user profile data and access tokens (default) Android configuration The implementation use the new library of Google who use Google account at Os le…