kmp-auth
1.0.0indexedFacilitates authentication integration for Google, Apple, and Github using Firebase. Offers UI helper buttons and supports one-tap sign-in for seamless user experiences.
0
Stars
—
Used by
dependents
—
Health
/ 100
KMPAuth - Kotlin Multiplatform Authentication Library
Simple and easy to use Kotlin Multiplatform Authentication library targeting iOS and Android. Supporting Google, Apple, Github authentication integrations using Firebase.
Because I am using KMPAuth in FindTravelNow production KMP project, I'll support development of this library :).
Related blog post: Integrating Google Sign-In into Kotlin Multiplatform
You can check out for full library api information.
Sample App and Code
@Composable
fun AuthUiHelperButtonsAndFirebaseAuth(
modifier: Modifier = Modifier,
onFirebaseResult: (<?>) -> ,
) {
Column(modifier = modifier,verticalArrangement = Arrangement.spacedBy(dp)) {
GoogleButtonUiContainerFirebase(onResult = onFirebaseResult) {
GoogleSignInButton(modifier = Modifier.fillMaxWidth()) { .onClick() }
}
AppleButtonUiContainer(onResult = onFirebaseResult) {
AppleSignInButton(modifier = Modifier.fillMaxWidth()) { .onClick() }
}
GithubButtonUiContainer(onResult = onFirebaseResult) {
Button(onClick = { .onClick() }) { Text() }
}
}
}
You can check out more sample codes here.
Features
- ✅ Google One Tap Sign-In (without Firebase)
- ✅ Google Sign-In with Firebase
- ✅ Apple Sign-In with Firebase
- ✅ Github Sign-In with Firebase
- ✅ Apple and Google "Sign in with " UiHelper buttons (according to each brand's guideline)
- 🚧 Facebook Sign-In (can be implemented in future)
- 📱 Multiplatform (android and iOS)
Installation
KMPAuth is available on Maven Central. In your root project build.gradle.kts file (or settings.gradle file) add mavenCentral() to repositories.
repositories {
mavenCentral()
}
Then in your shared module add desired dependencies in commonMain. Latest version: .
sourceSets {
commonMain.dependencies {
implementation("io.github.mirzemehdi:kmpauth-google:<version>") //Google One Tap Sign-In
implementation("io.github.mirzemehdi:kmpauth-firebase:<version>") //Integrated Authentications with Firebase
implementation("io.github.mirzemehdi:kmpauth-uihelper:<version>") //UiHelper SignIn buttons (AppleSignIn, GoogleSignInButton)
}
}
You will also need to include Google Sign-In and/or FirebaseAuth library to your ios app using Swift Package Manager or Cocoapods.
Note: If in iOS you get MissingResourceException, I wrote solution in this issue's comment section.
Google Sign-In
For Google Sign-In you can either use only one-tap sign in functionality, or also implementing firebase google authentication integration to that. You need to set up OAuth 2.0 in Google Cloud Platform Console. For steps you can follow this link. Pro Easy Tip: If you use Firebase and enable Google Sign-In authentication in Firebase it will automatically generate OAuth client IDs for each platform, and one will be Web Client ID which will be needed for identifying signed-in users in backend server.
Platform Setup
Create GoogleAuthProvider instance by providing Web Client Id as a serverID on Application start.
GoogleAuthProvider.create(credentials = GoogleAuthCredentials(serverId = WebClientId))
Android
Android Setup
There is not any platform specific setup in Android side.
Usage
After configuring above steps this is how you can use:
//Google Sign-In with Custom Button (only one tap sign-in functionality)
GoogleButtonUiContainer(onGoogleSignInResult = { googleUser ->
val idToken = googleUser?.idToken // Send this idToken to your backend to verify
}) {
Button(onClick = { this.onClick() }) { Text("Google Sign-In(Custom Design)") }
}
Google Sign-In Button and authentication with Firebase. You need to implement kmpauth-uihelper dependency
GoogleButtonUiContainerFirebase(onResult = onFirebaseResult) {
GoogleSignInButton(modifier = Modifier.fillMaxWidth()) { this.onClick() }
}
Google Sign-In IconOnly Button and authentication with Firebase. You need to implement kmpauth-uihelper dependency
GoogleButtonUiContainerFirebase(onResult = onFirebaseResult) {
GoogleSignInButtonIconOnly(onClick = { this.onClick() })
}
Apple Sign-In
After enabling and configuring Apple Sign-In in Firebase, make sure you added "Sign In with Apple" capability in XCode. Then, you can use it as below in your @Composable function:
//Apple Sign-In with Custom Button and authentication with Firebase
AppleButtonUiContainer(onResult = onFirebaseResult) {
//Any View, you just need to delegate child view's click to this UI Container's click method
Button(onClick = { this.onClick() }) { Text("Apple Sign-In (Custom Design)") }
}
Apple Sign-In with AppleSignInButton. You need to implement kmpauth-uihelper dependency
AppleButtonUiContainer(onResult = onFirebaseResult) {
AppleSignInButton(modifier = Modifier.fillMaxWidth()) { this.onClick() }
}
Apple Sign-In IconOnly Button. You need to implement kmpauth-uihelper dependency
AppleButtonUiContainer(onResult = onFirebaseResult) {
AppleSignInButtonIconOnly(onClick = { this.onClick() })
}
Github Sign-In
After enabling and configuring Github Sign-In in Firebase, you can use it as below in your @Composable function:
//Github Sign-In with Custom Button and authentication with Firebase
GithubButtonUiContainer(onResult = onFirebaseResult) {
//Any View, you just need to delegate child view's click to this UI Container's click method
Button(onClick = { this.onClick() }) { Text("Github Sign-In (Custom Design)") }
}