Clerk

Main entrypoint class for the Clerk SDK.

Provides access to authentication state, user information, and core functionality for managing user sessions and sign-in flows.

Properties

activeSession

val activeSession: Session?

The current session only if its status is ACTIVE.

activeUser

val activeUser: User?

The current user only if the session status is ACTIVE.

applicationName

val applicationName: String?

auth

val auth: Auth

The Auth namespace providing all authentication entry points.

client

lateinit var client: Client

The Client object representing the current device and its authentication state.

customTheme

var customTheme: ClerkTheme?

Clerk theme configuration for customizing the appearance of authentication UI components.

debugMode

var debugMode: Boolean

Enable for additional debugging signals and logging.

deleteSelfIsEnabled

val deleteSelfIsEnabled: Boolean

enabledFirstFactorAttributes

val enabledFirstFactorAttributes: List<String>

A list of enabled first factor attributes, sorted by priority.

initializationError

val initializationError: StateFlow<Throwable?>

Reactive state for initialization errors.

instanceEnvironmentType

val instanceEnvironmentType: InstanceEnvironmentType

isBranded

val isBranded: Boolean

Indicates whether Clerk branding is enabled for the application.

isFirstNameEnabled

val isFirstNameEnabled: Boolean

Indicates whether the 'First Name' field is enabled for user profiles.

isGoogleOneTapEnabled

val isGoogleOneTapEnabled: Boolean

Indicates whether Google One Tap sign-in is enabled for the application.

isInitialized

val isInitialized: StateFlow<Boolean>

Reactive state indicating whether the Clerk SDK has completed initialization.

isLastNameEnabled

val isLastNameEnabled: Boolean

Indicates whether the last name field is enabled for user profiles.

isSignedIn

val isSignedIn: Boolean

Indicates whether a user is currently signed in.

isUserNameEnabled

val isUserNameEnabled: Boolean

locale

val locale: StateFlow<String?>

The active locale for the current session.

mfaAuthenticatorAppIsEnabled

val mfaAuthenticatorAppIsEnabled: Boolean

mfaBackupCodeIsEnabled

val mfaBackupCodeIsEnabled: Boolean

Indicates whether MFA (Multi-Factor Authentication) via backup codes is enabled.

mfaIsEnabled

val mfaIsEnabled: Boolean

mfaPhoneCodeIsEnabled

val mfaPhoneCodeIsEnabled: Boolean

Indicates whether MFA (Multi-Factor Authentication) via phone code is enabled.

organizationLogoUrl

val organizationLogoUrl: String?

The image URL for the application logo used in authentication UI components.

passkeyIsEnabled

val passkeyIsEnabled: Boolean

passwordIsEnabled

val passwordIsEnabled: Boolean

privacyPolicyUrl

val privacyPolicyUrl: String?

The URL of the Privacy Policy page for the application.

proxyUrl

var proxyUrl: String?

Optional proxy URL for network requests.

publishableKey

var publishableKey: String?

The publishable key from Clerk Dashboard used for API authentication.

session

val session: Session?

The current user session, regardless of status.

sessionFlow

val sessionFlow: StateFlow<Session?>

Reactive state for the current user session.

socialProviders

val socialProviders: Map<String, UserSettings.SocialConfig>

Map of available social authentication providers configured for this application.

telemetryEnabled

var telemetryEnabled: Boolean

Whether to enable telemetry for the SDK.

termsUrl

val termsUrl: String?

The URL of the Terms of Service page for the application.

user

val user: User?

The current user, regardless of session status.

userFlow

val userFlow: StateFlow<User?>

Reactive state for the currently authenticated user.

version

val version: String

The current version of the Clerk Android SDK.

Functions

initialize

fun initialize(context: Context, publishableKey: String)

fun initialize(context: Context, publishableKey: String, options: ClerkConfigurationOptions? = null, theme: ClerkTheme? = null)

Initializes the Clerk SDK with the provided configuration.

reinitialize

fun reinitialize(): Boolean

Manually triggers a reinitialization attempt after a failed initialization.