Simplifies creation of onboarding experiences with pre-built UI components and utilities, offering customization, cross-platform support, and enhanced user engagement for mobile applications.
OnBoardingKit is a library designed to simplify the creation of onboarding experiences in your Android and iOS applications. It provides a set of pre-built UI components and utilities that allow you to quickly implement common onboarding flows, such as feature highlights, guided tours, and permission requests. The library is built with flexibility and customization in mind, allowing you to tailor the onboarding experience to your specific app's needs.
Add the dependency:
Add the following dependency to your module's build.gradle.kts file:
{
("io.github.::$version)
}
In this example, OnBoardingManager is initialized with the activity context, and a list of Step objects is created. Each step defines the title, description, and the target view to highlight. The start() method then initiates the onboarding flow.
We welcome contributions to OnBoardingKit! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request on our GitHub repository.
This project is licensed under the [Your License] License - see the LICENSE.md file for details.
Basic Usage:
Here's a basic example of how to use OnBoardingKit in your Android app:
private const val TAG = "MainActivity"
class MainActivity : ComponentActivity() {
private val onBoardingKit = OnBoardingKit.create(
factory = AndroidOnBoardingDependencyFactory(this)
)
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
onBoardingKit.configure(AndroidOnBoardingLauncher(this)) {
addPages(
OnBoardingPage(
title = "Find and Book Doctors with Ease",
body = "Search for specialists near you, view their profiles, and book appointments in just a few taps. No waiting, no hassle.",
illustrationImage = com.hopcape.onboarding.R.drawable.undraw_love,
textColor = 0L,
bodyColor = 0L
)
)
addPages(
OnBoardingPage(
title = "Order Medicines, Anytime",
body = "Shop for prescriptions and over-the-counter medicines from trusted pharmacies, and get them delivered to your doorstep.",
illustrationImage = com.hopcape.onboarding.R.drawable.undraw_love,
textColor = 0L,
bodyColor = 0L
)
)
addPages(
OnBoardingPage(
title = "We're Here for You",
body = "Need help? Our support team is available around the clock to assist you with your healthcare needs.",
illustrationImage = com.hopcape.onboarding.R.drawable.undraw_love,
textColor = 0L,
bodyColor = 0L
)
)
addTheme {
setPrimaryColor(Color(0XFF2893e1))
setSecondaryColor(Color(0XFFBEE2fD))
build()
}
build()
}
onBoardingKit.start(
onComplete = {
// Navigate to destination here
}
)
}
}
}
Add the dependency:
If you are using Swift Package Manager, add the library as a dependency in your Package.swift file:
Basic Usage:
Here's a basic example of how to use OnBoardingKit in your iOS app:
struct SplashView: View {
var body: some View {
VStack{
Text("Splash View")
.onAppear{
if let rootWindow = UIApplication.shared. windows.first {
let onBoardingLauncher = IOSOnBoardingLauncher(window: rootWindow)
let factory = IOSOnBoardingDependencyFactory()
let onBoardingKit: OnBoardingKit = OnBoardingKitCompanion().create(factory: factory)
let onBoardingConfig: (OnBoardingConfigBuilder) -> OnBoardingConfig = { builder in
let theme: (OnBoardingThemeBuilder) -> OnBoardingTheme = { themeBuilder in
themeBuilder.setPrimaryColorArgb(color: 0xFF2893E1)
return themeBuilder.build()
}
builder.addTheme(themeBuilder: theme)
if let imageUrl = Bundle.main.url(forResource: "undraw_love", withExtension: "svg") {
let page1 = OnBoardingPage(title: "Find and Book Doctors with Ease", textColor: 0, body: "Search for specialists near you, view their profiles, and book appointments in just a few taps. No waiting, no hassle.", bodyColor: 0, illustrationImage: "\(imageUrl)")
let page2 = OnBoardingPage(title: "Order Medicines, Anytime", textColor: 0, body: "Shop for prescriptions and over-the-counter medicines from trusted pharmacies, and get them delivered to your doorstep.", bodyColor: 0, illustrationImage: "\(imageUrl)")
let page3 = OnBoardingPage(title: "We're Here for You", textColor: 0, body: "Need help? Our support team is available around the clock to assist you with your healthcare needs.", bodyColor: 0, illustrationImage: "\(imageUrl)")
print("Image URL: \(imageUrl)")
let allPages = [page1]
let obBoardingPages = allPages
builder.addPages(pages: page1)
builder.addPages(pages: page2)
builder.addPages(pages: page3)
}
return builder.build()
}
onBoardingKit.configure(onBoardingLauncher: onBoardingLauncher,configBuilder: onBoardingConfig)
onBoardingKit.start(
onComplete: onCompleteOnBoarding
)
}
}
.safeAreaPadding()
.padding()
.background(.blue)
}
}
In this example, OnBoardingManager is initialized with the view controller, and a list of Step objects is created. Each step defines the title, description, and the target view to highlight. The start() method then initiates the onboarding flow.
Surfaced from shared tags and platforms — no rankings paid for.