# Bubbl Android SDK Integration Guide

This guide explains how to integrate the Bubbl Android SDK into a clean Android app and why each decision is made. It is intentionally over-explained so a brand‑new developer can copy, paste, and understand every step.

You will find:

1. A quick start guide with minimal steps.
2. A full integration walkthrough with code snippets, tooltips, and explanations.
3. A clear list of differences between the Bubbl host app and a vanilla Android app.
4. Troubleshooting and a checklist.


## Who this is for

- Android devs with little to no SDK integration experience.
- Anyone who wants to understand why each line exists, not just what it does.


## What Bubbl adds to a vanilla app

- Location awareness and geofence refresh.
- Push notifications and in‑app modal experiences.
- Optional surveys with structured answer collection.
- Logging utilities and diagnostics.


## SDK requirements (from Bubbl docs)

- `minSdk` 26 or higher.
- `targetSdk` 34 or higher.
- Kotlin 1.8+ and Java 11+.
- Firebase BOM and FCM messaging for push notifications.


## Local reference

This guide references the internal host app in:

- `/Users/jackwright/Projects/Bubbl/bubbl-internal-android-host-app`


The host app includes extra screens and helper code for debugging and demos that are not required for basic integration. We call those out explicitly.