Getting Started

Ce contenu n'est pas encore disponible dans votre langue.

Install the package
- npm
- pnpm
- yarn
- bun
Fenêtre de terminal
npm i @capgo/capacitor-social-login
Fenêtre de terminal
pnpm add @capgo/capacitor-social-login
Fenêtre de terminal
yarn add @capgo/capacitor-social-login
Fenêtre de terminal
bun add @capgo/capacitor-social-login
Sync with native projects
- npm
- pnpm
- yarn
- bun
Fenêtre de terminal
npx cap sync
Fenêtre de terminal
pnpm cap sync
Fenêtre de terminal
yarn cap sync
Fenêtre de terminal
bunx cap sync

Initialize in app startup

import { SocialLogin } from '@capgo/capacitor-social-login';

await SocialLogin.initialize({
  google: {
    webClientId: 'your-google-web-client-id',
    iOSServerClientId: 'your-google-server-client-id',
    mode: 'online',
  },
  apple: {
    clientId: 'your-apple-service-id',
    useProperTokenExchange: true,
    useBroadcastChannel: true,
  },
  facebook: {
    appId: 'your-facebook-app-id',
  },
  twitter: {
    clientId: 'your-twitter-client-id',
    redirectUrl: 'myapp://oauth/twitter',
  },
  oauth2: {
    github: {
      appId: 'your-github-client-id',
      authorizationBaseUrl: 'https://github.com/login/oauth/authorize',
      accessTokenEndpoint: 'https://github.com/login/oauth/access_token',
      redirectUrl: 'myapp://oauth/github',
      scope: 'read:user user:email',
      pkceEnabled: true,
    },
  },
});

Core flow examples

await SocialLogin.login({
  provider: 'google',
  options: { scopes: ['profile', 'email'] },
});

await SocialLogin.login({
  provider: 'oauth2',
  options: {
    providerId: 'github',
    scope: 'read:user user:email',
  },
});

Session checks

const status = await SocialLogin.isLoggedIn({ provider: 'google' });
await SocialLogin.logout({ provider: 'google' });

Auth codes and refresh

// For providers that support this mode
const authCodeResult = await SocialLogin.getAuthorizationCode({ provider: 'google' });
await SocialLogin.refresh({ provider: 'google', options: {} as never });

Advanced helpers

const jwt = await SocialLogin.decodeIdToken({
  idToken: 'eyJhbGciOi...',
});

const { date } = await SocialLogin.getAccessTokenExpirationDate({
  accessTokenExpirationDate: Date.now() + 3600 * 1000,
});

const expired = await SocialLogin.isAccessTokenExpired({
  accessTokenExpirationDate: Date.now() + 1000,
});

const active = await SocialLogin.isRefreshTokenAvailable({ refreshToken: 'a-token' });

Provider-specific notes

Google offline mode

google.mode: 'offline' returns serverAuthCode from login. In this mode logout, isLoggedIn, getAuthorizationCode, and refresh are not available.

Apple

Set useProperTokenExchange: true for strict token handling and useBroadcastChannel: true for Android simplified setup.

OAuth2 web redirect flow

Use OAuth2LoginOptions.flow: 'redirect' for web flows that navigate away from the page.

Provider configuration in Capacitor

You can disable unused providers to reduce native binaries:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    SocialLogin: {
      providers: {
        google: true,
        facebook: true,
        apple: true,
        twitter: false,
      },
    },
  },
};