huburt-hu/newbieguide

NewbieGuide is an Android library for adding a first time user tutorial overlay to an app, the kind of highlighted spotlight that points at a button or icon and explains what it does when someone opens the app for the first time. The whole thing is built with a chained, fluent Java API, so showing a guide layer over your activity or fragment typically takes just a few lines of code. You start by calling NewbieGuide.with on an activity or fragment, give the guide a label so the library can tell different guides apart and remember which ones have already been shown, then add one or more guide pages. Each guide page can highlight a specific view, choosing its shape (rectangle, rounded rectangle, oval, or a raw region defined by coordinates), padding, and rounding, and you attach your own custom layout as the explanation content shown alongside the highlight. Because the explanation layout is just your own XML, you have full control over where the text, images, or dialogs appear relative to the highlighted view, instead of being limited to fixed positions above or below it like many similar libraries. By default a guide only shows once per label, but you can change how many times it repeats with setShowCounts, or force it to always appear during testing with alwaysShow. Newer versions add relative positioning helpers so guide layouts align consistently around a highlighted view across different screen sizes, a listener that fires once your custom layout has finished inflating so you can wire up its buttons, and click listeners on the highlighted region itself so the guide can respond when the user taps the spotlighted area rather than just dismissing it. The library is distributed through JitPack, so integrating it means adding the JitPack repository to your project's Gradle file and then declaring the dependency in your module. It requires the AndroidX or support library appcompat component already present in your project. This is a focused tool for Android developers who want an onboarding walkthrough without writing custom overlay and positioning logic themselves.