Architecture Intelligence for Android & Kotlin Multiplatform
Gradle Lighthouse analyzes your Gradle project, detects architectural risks, evaluates build health, and generates actionable recommendations to improve maintainability, scalability, and developer productivity.
Most teams know they have technical debt. What they don't know is:
- Which modules are slowing down incremental builds?
- Where are architectural boundaries leaking?
- Which technical debt deserves attention first?
- How has our architecture evolved over the last 30 builds?
Gradle Lighthouse answers these questions with a single audit.
./gradlew lighthouseAudit lighthouseAggregateA transparent health model that evaluates Security, Build Performance, Dependency Hygiene, Modernization, and more. Uses a Square Root Deduction Model to ensure fair scoring across massive projects.
An interactive module dependency map with:
- Cycle Detection: Glowing red edges highlight circular dependencies.
- Refactoring Sandbox: Simulate refactors by "cutting" links to see instant score impacts.
- Layer Visualization: Modules grouped by App, Feature, Domain, Data, and Core.
Go beyond diagnosis. Lighthouse can surgically refactor your build scripts:
- KAPT to KSP: Automatic migration of annotation processors.
- Version Catalogs: Bootstrap your
libs.versions.tomlautomatically.
Estimate the architectural footprint of an SDK before merging it. See binary size, method count, and startup impact based on community data.
| Feature | Supported Versions |
|---|---|
| Gradle | 8.0 - 9.x+ |
| Java | 17, 21+ |
| Android (AGP) | 7.4 - 8.x+ |
| Kotlin | 1.9.x, 2.x |
Automated PR comments showing score deltas, new cycles, and regressions. Full integration with GitHub Actions, SARIF, and JUnit.
Apply to your root project:
plugins {
id("io.github.dev-vikas-soni.lighthouse") version "2.3.2"
}./gradlew lighthouseAudit lighthouseAggregate- Global Dashboard:
build/reports/lighthouse/project-dashboard.html - Module Audit:
module/build/reports/lighthouse/index.html
Want to see Gradle Lighthouse in action on a real project? Explore our Showcase Repository which contains complete audit reports, architectural health scores, and dependency visualizations for a complex Android project.
👉 Lighthouse Showcase Repository
We welcome contributions! See the Contributing Guide and Developer Docs to get started.
MIT License.
If you find Gradle Lighthouse useful, you might also like:
- LeakLens: An advanced Android memory leak detector for IntelliJ IDEA and Android Studio with an integrated AI fix assistant.