SmartIsland

Architecture

flowchart LR
    A[Android notifications] --> B[SmartIslandNotificationListenerService]
    B --> Repo[SmartIslandNotificationRepository]
    E[DataStore settings] --> Repo
    Repo --> D[SmartIslandOverlayService]
    D --> F[WindowManager overlay]
    F --> G[Jetpack Compose island UI]
    G --> H[Open, dismiss, expand, or launch floating window]

Tech Stack

Requirements

• Android Studio with Android SDK 36 installed
• JDK 17
• Android device or emulator running Android 8.0+ (minSdk 26)
• Overlay permission enabled on the test device
• Notification listener access enabled for Smart Island

Getting Started

Clone the repository:

git clone https://github.com/agupta07505/SmartIsland.git
cd SmartIsland

Build a debug APK on Windows:

.\gradlew.bat assembleDebug

Build a debug APK on macOS or Linux:

./gradlew assembleDebug

Install the debug build on a connected device:

./gradlew installDebug

Then open Smart Island and complete the runtime setup:

1. Grant overlay permission.
2. Enable notification listener access.
3. Turn on Smart Island from the app.
4. Use the demo buttons or trigger real notifications to test the island.

Privacy And Permissions

Smart Island needs powerful Android permissions because it is an overlay and notification experience. The project keeps that behavior visible and local.

At the time of this README, the app does not request INTERNET, does not include analytics, and does not send notification content to a remote server. See PRIVACY.md for the full privacy note.

Project Structure

SmartIsland/
|-- app/
|   `-- src/main/
|       |-- AndroidManifest.xml
|       |-- java/com/agupta07505/smartisland/
|       |   |-- data/       # Settings model and DataStore repository
|       |   |-- model/      # Island notification and mode models
|       |   |-- service/    # Overlay and notification listener services
|       |   |-- ui/         # Compose screens and island components
|       |   `-- MainActivity.kt
|       `-- res/
|-- gradle/
|-- build.gradle.kts
|-- settings.gradle.kts
`-- README.md

Development Notes

• Use the Gradle Wrapper committed in this repository.
• Keep secrets, keystores, local SDK paths, generated APKs, and personal notification screenshots out of git.
• Test overlay behavior on a physical device when possible; OEM Android builds can handle overlay and background-service rules differently.
• Some floating-window behavior depends on Android version and device support.
• The pass-through touch region and freeform "open in floating window" gesture rely on best-effort platform APIs and may be unavailable on some devices/OEM Android builds.
• For signed GitHub Actions releases, see docs/RELEASE_SIGNING.md.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request, and use the issue templates for bug reports or feature ideas.

By contributing, you agree that your contribution will be licensed under the same GNU General Public License v3.0 terms as the project.

Security

Please report suspected vulnerabilities responsibly. See SECURITY.md for the reporting process and what information to include.

License

Smart Island is licensed under the GNU General Public License v3.0.

Copyright (C) 2026 Animesh Gupta.