AppIntro alternatives and similar packages
Based on the "Other Widget" category.
Alternatively, view AppIntro alternatives based on common mentions on social networks and blogs.
-
AndroidSlidingUpPanel
This library provides a simple way to add a draggable sliding up panel (popularized by Google Music and Google Maps) to your Android application. Brought to you by Umano. -
BottomBar
(Deprecated) A custom view component that mimics the new Material Design Bottom Navigation pattern. -
ShortcutBadger
An Android library supports badge notification like iOS in Samsung, LG, Sony and HTC launchers. -
SystemBarTint
[DEPRECATED] Apply background tinting to the Android system UI when using KitKat translucent modes -
TapTargetView
An implementation of tap targets from the Material Design guidelines for feature discovery. -
android-viewbadger
[DEPRECATED] A simple way to "badge" any given Android view at runtime without having to cater for it in layout -
android-stackblur
Android StackBlur is a library that can perform a blurry effect on a Bitmap based on a gradient or radius, and return the result. The library is based on the code of Mario Klingemann. -
android-iconify
Android integration of multiple icon providers such as FontAwesome, Entypo, Typicons,... -
DraggablePanel
DISCONTINUED. Android library used to create an awesome Android UI based on a draggable element similar to the last YouTube graphic component. -
aFileChooser
DISCONTINUED. [DEPRECATED] Android library that provides a file explorer to let users select files on external storage. -
Swipecards
A Tinder-like Android library to create the swipe cards effect. You can swipe left or right to like or dislike the content. -
TourGuide
TourGuide is an Android library that aims to provide an easy way to add pointers with animations over a desired Android View -
StickyGridHeaders
DISCONTINUED. An Android Library that makes it easy to make grid views with sectioned data and headers that stick to the top. -
FloatingView
FloatingView can make the target view floating above the anchor view with cool animation -
TileView
TileView is a subclass of android.view.ViewGroup that asynchronously displays, pans and zooms tile-based images. Plugins are available for features like markers, hotspots, and path drawing. -
Bubbles for Android
Bubbles for Android is an Android library to provide chat heads capabilities on your apps. With a fast way to integrate with your development. -
RippleView
View that imitates Ripple Effect on click which was introduced in Android L (for Android 2.3+) -
Android-ActionItemBadge
This library offers a simple method to add a small badge icon to your ActionBar-MenuItem -
android-sliding-layer-lib
DISCONTINUED. Highly customizable SlidingLayer as you have seen in Wunderlist -
SortableTableView
An Android library containing a simple TableView and an advanced SortableTableView providing a lot of customisation possibilities to fit all needs. -
ScratchView
ScratchView repo is UX Design involving scratch cards like views which are scratched to reveal the information they conceal. -
android-FlipView
A small, easy to use android library for implementing flipping between views as seen in the popular Flipboard application -
FabricView
A new canvas drawing library for Android. Aims to be the Fabric.js for Android. Supports text, images, and hand/stylus drawing input. The library has a website and API docs, check it out
SaaSHub - Software Alternatives and Reviews
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of AppIntro or a related project?
README
AppIntro
AppIntro is an Android Library that helps you build a cool carousel intro for your App. AppIntro has support for requesting permissions and helps you create a great onboarding experience in just a couple of minutes.
- Getting Started ๐ฃ
- Migrating ๐
- Features ๐งฐ
- Creating Slides ๐ฉโ๐จ
- Configure ๐จ
- Permission ๐
- Example App ๐ก
- Translating ๐
- Snapshots ๐ฆ
- Contributing ๐ค
- Acknowledgments ๐ธ
- License ๐
- Apps using AppIntro ๐ฑ
Getting Started ๐ฃ
AppIntro is distributed through JitPack.
Adding a dependency
To use it you need to add the following gradle dependency to your build.gradle
file of the module where you want to use AppIntro (NOT the root file).
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
// AndroidX Capable version
implementation 'com.github.AppIntro:AppIntro:6.2.0'
// *** OR ***
// Latest version compatible with the old Support Library
implementation 'com.github.AppIntro:AppIntro:4.2.3'
}
Please note that since AppIntro 5.x, the library supports Android X. If you haven't migrated yet, you probably want to use a previous version of the library that uses the old Support Library packages (or try Jetifier Reverse mode).
Basic usage
To use AppIntro, you simply have to create a new Activity that extends AppIntro like the following:
class MyCustomAppIntro : AppIntro() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Make sure you don't call setContentView!
// Call addSlide passing your Fragments.
// You can use AppIntroFragment to use a pre-built fragment
addSlide(AppIntroFragment.createInstance(
title = "Welcome...",
description = "This is the first slide of the example"
))
addSlide(AppIntroFragment.createInstance(
title = "...Let's get started!",
description = "This is the last slide, I won't annoy you more :)"
))
}
override fun onSkipPressed(currentFragment: Fragment?) {
super.onSkipPressed(currentFragment)
// Decide what to do when the user clicks on "Skip"
finish()
}
override fun onDonePressed(currentFragment: Fragment?) {
super.onDonePressed(currentFragment)
// Decide what to do when the user clicks on "Done"
finish()
}
}
Please note that you must NOT call setContentView. The AppIntro
superclass is taking care of it for you.
Also confirm that you're overriding onCreate
with a single parameter (Bundle
) and you're not using another override (like onCreate(Bundle, PersistableBundle)
) instead.
Finally, declare the activity in your Manifest like so:
<activity android:name="com.example.MyCustomAppIntro"
android:label="My Custom AppIntro" />
We suggest to don't declare MyCustomAppIntro
as your first Activity unless you want the intro to launch every time your app starts. Ideally you should show the AppIntro activity only once to the user, and you should hide it once completed (you can use a flag in the SharedPreferences
).
Java users
You can find many examples in java language in the [examples directory](example/src/main/java/com/github/appintro/example/ui/java/JavaIntro.java)
Migrating ๐
If you're migrating from AppIntro v5.x to v6.x, please expect multiple breaking changes. You can find documentation on how to update your code on this other migration guide.
Features ๐งฐ
Don't forget to check the [changelog](CHANGELOG.md) to have a look at all the changes in the latest version of AppIntro.
- API >= 14 compatible.
- 100% Kotlin Library.
- AndroidX Compatible.
- Support for runtime permissions.
- Dependent only on AndroidX AppCompat/Annotations, ConstraintLayout and Kotlin JDK.
- Full RTL support.
Creating Slides ๐ฉโ๐จ
The entry point to add a new slide is the addSlide(fragment: Fragment)
function on the AppIntro
class.
You can easily use it to add a new Fragment
to the carousel.
The library comes with several util classes to help you create your Slide with just a couple lines:
AppIntroFragment
You can use the AppIntroFragment
if you just want to customize title, description, image and colors.
That's the suggested approach if you want to create a quick intro:
addSlide(AppIntroFragment.createInstance(
title = "The title of your slide",
description = "A description that will be shown on the bottom",
imageDrawable = R.drawable.the_central_icon,
backgroundDrawable = R.drawable.the_background_image,
titleColorRes = R.color.yellow,
descriptionColorRes = R.color.red,
backgroundColorRes = R.color.blue,
titleTypefaceFontRes = R.font.opensans_regular,
descriptionTypefaceFontRes = R.font.opensans_regular,
))
All the parameters are optional, so you're free to customize your slide as you wish.
If you need to programmatically create several slides you can also use the SliderPage
class.
This class can be passed to AppIntroFragment.createInstance(sliderPage: SliderPage)
that will create
a new slide starting from that instance.
AppIntroCustomLayoutFragment
If you need further control on the customization of your slide, you can use the AppIntroCustomLayoutFragment
.
This will allow you pass your custom Layout Resource file:
AppIntroCustomLayoutFragment.newInstance(R.layout.intro_custom_layout1)
This allows you to achieve complex layout and include your custom logic in the Intro (see also Slide Policy):
Configure ๐จ
AppIntro offers several configuration option to help you customize your onboarding experience.
Slide Transformer
AppIntro comes with a set of Slide Transformer that you can use out of the box to animate your Slide transition.
Slide Transformers | Slide Transformers |
---|---|
Fade | Zoom |
Flow | Slide Over |
Depth | Parallax |
You can simply call setTransformer()
and pass one of the subclass of the sealed class AppIntroPageTransformerType
:
setTransformer(AppIntroPageTransformerType.Fade)
setTransformer(AppIntroPageTransformerType.Zoom)
setTransformer(AppIntroPageTransformerType.Flow)
setTransformer(AppIntroPageTransformerType.SlideOver)
setTransformer(AppIntroPageTransformerType.Depth)
// You can customize your parallax parameters in the constructors.
setTransformer(AppIntroPageTransformerType.Parallax(
titleParallaxFactor = 1.0,
imageParallaxFactor = -1.0,
descriptionParallaxFactor = 2.0
))
Custom Slide Transformer
You can also provide your custom Slide Transformer (implementing the ViewPager.PageTransformer
interface) with:
setCustomTransformer(ViewPager.PageTransformer)
Color Transition
AppIntro offers the possibility to animate the color transition between two slides background. This feature is disabled by default, and you need to enable it on your AppIntro with:
isColorTransitionsEnabled = true
Once you enable it, the color will be animated between slides with a gradient.
Make sure you provide a backgroundColor
parameter in your slides.
If you're providing custom Fragments, you can let them support the color transition by implementing
the SlideBackgroundColorHolder
interface.
Multiple Windows Layout
AppIntro is shipped with two top-level layouts that you can use.
The default layout (AppIntro
) has textual buttons, while the alternative
layout has buttons with icons.
To change the Window layout, you can simply change your superclass to AppIntro2
.
The methods to add and customize the AppIntro are unchanged.
class MyCustomAppIntro : AppIntro2() {
// Same code as displayed in the `Basic Usage` section of this README
}
Page | AppIntro |
AppIntro2 |
---|---|---|
standard page | ||
last page |
Indicators
AppIntro supports two indicators out of the box to show the progress of the Intro experience to the user:
DotIndicatorController
represented with a list of Dot (the default)ProgressIndicatorController
represented with a progress bar.
DotIndicator |
ProgressIndicator |
---|---|
[dotted indicator](assets/dotted-indicator.gif) | [progress indicator](assets/progress-indicator.gif) |
Moreover, you can supply your own indicator by providing an implementation of the IndicatorController
interface.
You can customize the indicator with the following API on the AppIntro
class:
// Toggle Indicator Visibility
isIndicatorEnabled = true
// Change Indicator Color
setIndicatorColor(
selectedIndicatorColor = getColor(R.color.red),
unselectedIndicatorColor = getColor(R.color.blue)
)
// Switch from Dotted Indicator to Progress Indicator
setProgressIndicator()
// Supply your custom `IndicatorController` implementation
indicatorController = MyCustomIndicator(/* initialize me */)
If you don't specify any customization, a DotIndicatorController
will be shown.
Vibration
AppIntro supports providing haptic vibration feedback on button clicks. Please note that you need to specify the Vibration permission in your app Manifest (the library is not doing it). If you forget to specify the permission, the app will experience a crash.
<uses-permission android:name="android.permission.VIBRATE" />
You can enable and customize the vibration with:
// Enable vibration and set duration in ms
isVibrate = true
vibrateDuration = 50L
Wizard Mode
AppIntro supports a wizards mode where the Skip button will be replaced with the back arrow. This comes handy if you're presenting a Wizard to your user with a set of skip they need to do, and they might frequently go back and forth.
You can enable it with:
isWizardMode = true
Immersive Mode
If you want to display your Intro with a fullscreen experience, you can enable the Immersive mode. This will hide both the Status Bar and the Navigation bar and the user will have to scroll from the top of the screen to show them again.
This allows you to have more space for your Intro content and graphics.
You can enable it with:
setImmersiveMode()
System Back button
You can lock the System Back button if you don't want your user to go back from intro. This could be useful if you need to request permission and the Intro experience is not optional.
If this is the case, please set to true the following flag:
isSystemBackButtonLocked = true
System UI (Status Bar and Navigation Bar)
You can customize the Status Bar, and the Navigation Bar visibility & color with the following methods:
// Hide/Show the status Bar
showStatusBar(true)
// Control the status bar color
setStatusBarColor(Color.GREEN)
setStatusBarColorRes(R.color.green)
// Control the navigation bar color
setNavBarColor(Color.RED)
setNavBarColorRes(R.color.red)
Permission ๐
AppIntro simplifies the process of requesting runtime permissions to your user.
You can integrate one or more permission request inside a slide with the askForPermissions
method inside your activity.
Please note that:
slideNumber
is in a One-based numbering (it starts from 1)- You can specify more than one permission if needed
- You can specify if the permission is required. If so, users can't proceed if he denies the permission.
// Ask for required CAMERA permission on the second slide.
askForPermissions(
permissions = arrayOf(Manifest.permission.CAMERA),
slideNumber = 2,
required = true)
// Ask for both optional ACCESS_FINE_LOCATION and WRITE_EXTERNAL_STORAGE
// permission on the third slide.
askForPermissions(
permissions = arrayOf(
Manifest.permission.ACCESS_FINE_LOCATION,
Manifest.permission.WRITE_EXTERNAL_STORAGE
),
slideNumber = 3,
required = false)
Should you need further control on the permission request, you can override those two methods on the AppIntro
class:
override fun onUserDeniedPermission(permissionName: String) {
// User pressed "Deny" on the permission dialog
}
override fun onUserDisabledPermission(permissionName: String) {
// User pressed "Deny" + "Don't ask again" on the permission dialog
}
Slide Policy
If you want to restrict navigation between your slides (i.e. the user has to toggle a checkbox in order to continue),
the SlidePolicy
feature might help you.
All you have to do is implement SlidePolicy
in your slides.
This interface contains the isPolicyRespected
property and the onUserIllegallyRequestedNextPage
method
that you must implement with your custom logic
class MyFragment : Fragment(), SlidePolicy {
// If user should be allowed to leave this slide
override val isPolicyRespected: Boolean
get() = false // Your custom logic here.
override fun onUserIllegallyRequestedNextPage() {
// User illegally requested next slide.
// Show a toast or an informative message to the user.
}
}
You can find a full working example of SlidePolicy
in the [example app - CustomSlidePolicyFragment.kt](example/src/main/java/com/github/appintro/example/ui/custom/fragments/CustomSlidePolicyFragment.kt)
Example App ๐ก
AppIntro comes with a sample app full of examples and use case that you can use as inspiration for your project. You can find it inside the /example folder.
You can get a debug APK of the sample app from the Pre Merge GitHub Actions job as an output artifact here.
Translating ๐
Do you want to help AppIntro becoming international ๐? We are more than happy! AppIntro currently supports [the following languages](appintro/src/main/res).
To add a new translation just add a pull request with a new strings.xml
file inside a values-xx
folder (where xx
is a two-letter ISO 639-1 language code).
In order to provide the translation, your file needs to contain the following strings:
<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools">
<string name="app_intro_skip_button">[Translation for SKIP]</string>
<string name="app_intro_next_button">[Translation for NEXT]</string>
<string name="app_intro_back_button">[Translation for BACK]</string>
<string name="app_intro_done_button">[Translation for DONE]</string>
<string name="app_intro_image_content_description">[Translation for "graphics"]</string>
</resources>
An updated version of the English version translation is [available here](appintro/src/main/res/values/strings.xml).
If a translation in your language is already available, please check it and eventually fix it (all the strings should be listed, not just a subset).
Snapshots ๐ฆ
Development of AppIntro happens on the main branch. You can get SNAPSHOT
versions directly from JitPack if needed.
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
implementation "com.github.AppIntro:AppIntro:main-SNAPSHOT"
}
โ ๏ธ Please note that the latest snapshot might be unstable. Use it at your own risk โ ๏ธ
Contributing ๐ค
We're offering support for AppIntro on the #appintro channel on KotlinLang Slack. Come and join the conversation over there. If you don't have access to KotlinLang Slack, you can request access here.
We're looking for contributors! Don't be shy. ๐ Feel free to open issues/pull requests to help me improve this project.
- When reporting a new Issue, make sure to attach Screenshots, Videos or GIFs of the problem you are reporting.
- When submitting a new PR, make sure tests are all green. Write new tests if necessary.
Acknowledgments ๐ธ
Maintainers
AppIntro is currently developed and maintained by the AppIntro GitHub Org. When submitting a new PR, please ping one of:
Libraries
AppIntro is not relying on any third party library other than those from AndroidX:
androidx.appcompat:appcompat
androidx.annotation:annotation
androidx.constraintlayout:constraintlayout
License ๐
Copyright (C) 2015-2020 AppIntro Developers
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Apps using AppIntro ๐ฑ
If you are using AppIntro in your app and would like to be listed here, please open a pull request and we will be more than happy to include you:
List of Apps using AppIntro
- PDF Me
- Smoothie Recipes
- neutriNote
- Handwriting Note
- Friends Roulette
- ChineseDictionary (็ฒต้ปๆผขๅ ธ้ข็ท็ฒต่ชๆฎ้่ฉฑ็ผ่ฒไธญๆๅญๅ ธ)
- Sifter
- Service Notes
- Salary Barometer
- Best Business Idea!
- Wi-Fi password reminder
- Xpaper - Moto X Wallpapers
- Find My Parked Car
- Vape Tool Pro
- Schematiskt Skolschema
- Third Eye
- Web Video Cast
- SchoolBox
- Fitness Challenge
- Crunch (ICE)
- Filmy - Your Movie Guide
- HEBF Optimizer โช Root
- IIFYM
- Ampwifi Winamp Remote
- Hugetwit
- Boo Music Player
- BeatPrompter
- BlueWords
- Best Quotes & Status 2019 (99000+ Collection)
- Orbot
- PhotoGuard Photo Vault
- Ride My Park - Best Spots, Skateparks Map
- Shopping list and Shopping list pro
- PZPIC - Pan & Zoom Effect Video from Still Picture
- PrezziBenzina
- LogViewer for openHAB
- Firmo con CIE
- iC-YOURLS
- Secure File Manager
- Noon Happen
- Alcapote
- Weather Forecast
- Zoned Pomodoro Timer
- PCAPdroid Network Monitor
*Note that all licence references and agreements mentioned in the AppIntro README section above
are relevant to that project's source code only.