Android-GuideBlocks

This is a shared open source repository for GuideBlocks that can be used in Android Apps. You can use any of these GuideBlocks here in your App in Conjunction with the Contextual Android SDK and an account at https://dashboard.contextu.al

Using GuideBlocks

GuideBlocks save developer time by giving engagement components back to your Product Team and not creating jobs on the product roadmap. This allows you to Code Once, Run Anywhere, Anytime and for Any Users. and then let your Product Team launch, target, customize the appearance of the widget. When would you do this?

• onboarding and feature announcements
• promotions, offers or inApp marketing
• system announcements
• running different surveys

There are two ways to use GuideBlocks:

1. Make use of these public GuideBlocks

0. you have an account on the Contextual Dashboard and you've added the Android SDK, you've added the app_key into your App and tested a simple Guide in your App.

1. In your build.gradle add:

GuideBlock current version:

implementation 'com.github.GuideBlocks-org:Android-GuideBlocks:<LATEST_VERSION>', {
        exclude group: 'com.google.android.material'
        exclude group: 'com.github.bumptech.glide'
    }

2. In your activities where you want to use GuideBlocks add (for example):

import com.contextu.al.confetti.ConfettiGuideBlocks
import com.contextu.al.core.CtxEventObserver

for the GuideBlock you wish to use, then add

        val confettiGuideBlocks = "confetti"

        Contextual.registerGuideBlock(confettiGuideBlocks).observe(this){ contextualContainer ->
            if(contextualContainer.guidePayload.guide.guideBlock.contentEquals(confettiGuideBlocks)){
                ConfettiGuideBlocks(this@MainActivity).show()
            }
        }

4. build and run!

2. Make your own App elements into private GuideBlocks

Simply wrap your existing code elements into a GuideBlock, even if they are deeply embedded your product team can launch from the Contextual Dashboard.

See the following examples:

Contributing Guideblocks to this repo

You can contribute to https://guideblocks.org by wrapping a code element that would be useful for others to use. The process is:

1. Get an account at https://dashboard.contextu.al, you will need this to test your new GuideBlock.
2. Clone this repo
3. Create a new branch with your GuideBlock name
4. Add your code: maybe it is yours or maybe it is some public available source on the internet. Isolate the functional elements.
5. Wrap your code following these instructions
6. Test it out with a sample add and the Contextual Dashboard. Push this sammple app to a public repo or use the FavDish Sample
7. Create a GuideBlock.yaml in the root directory - see the template below. Be sure to add the sample app repo/branch that you have used into the GuideBlock.yaml
8. Create a README.md in the root directory to tell users how to use the GuideBlock (mapping parameters and adding to the extensibility section of the Dashboard)
9. Commit, Push and create a PR.
10. Sit back, relax, have a bubble tea and wait for approval!

Sample GuideBlock.yaml

Title: Confetti
Author: Daniel Quah
Email: support@contextu.al
TestApp: https://github.com/contextu-al/FavDish
TestAppBranch: confetti
Description: Launch confetti to targeted users at any time with this low-code GuideBlock
Acknowledgements: https://github.com/DanielMartinus/Konfetti
Screenshot: 
Video: https://vimeo.com/manage/videos/909526616/8efaae6607
Extensibility: {
  "guideBlockKey": "Confetti"
}