Android Gradle performance auditor and auto-fixer.
Audit and safely fix common Gradle build-time misconfigurations in Android projects.
- Smart Log Pre-processing: Extracts the slowest tasks and key metrics to fit any build size into the LLM context.
- Expert Knowledge Base (RAG): Automatically injects relevant Gradle performance patterns into the AI prompt for deeper insights.
- Improved Accuracy: More structured, data-driven analysis with lower token usage.
- AI-powered build analysis via LLM (
npx droidperf analyze) - Auto-apply fixes with
--apply - Dry-run preview for AI fixes with
--dry-run - Save report to
droidperf-report.mdfor team sharing
It’s designed to be boring in the best way: conservative fixes, transparent diffs, and easy rollback.
- Prefer safe, reversible fixes over aggressive optimizations
- Avoid modifying build scripts directly (only gradle.properties)
- Focus on high-impact, low-risk improvements first
npx droidperf analyze --build-log ./build.lognpx droidperf analyze --build-log ./build.log --apply --dry-runnpx droidperf analyze --build-log ./build.log --applynpx droidperf audit /path/to/your/android/project
npx droidperf fix /path/to/your/android/project --dry-run
npx droidperf fix /path/to/your/android/projectFlutter repo? Point at the repo root — droidperf will auto-detect and audit the android/ Gradle subproject.
If you want a short “why/what/how” you can share, see docs/ONE_PAGER.md.
Scanning your Android project...
Found 7 issues costing you ~3.0 minutes per build:
[CRITICAL] Configuration cache disabled — +45s per build
[CRITICAL] Build cache disabled — +32s per build
[HIGH] Parallel execution disabled — +38s per build
[HIGH] Kotlin incremental disabled — +28s per build
[MEDIUM] JVM heap too low — 2048mb — recommend 4096mb
[MEDIUM] Configure on demand disabled — +12s per build
[LOW] Gradle daemon disabled — +8s per build
Estimated waste: 3.0 min/build × 20 builds/day = 61 min/day
Run 'droidperf fix' to apply all fixes automatically.
Preview changes safely first:
npx droidperf fix /path/to/your/android/project --dry-run--dry-run prints a full-file unified diff for every changed file, so you can see exactly what would be written.
Real results shared by people running droidperf:
- Rudra Dave (maintainer): 1.3 min/build saved on a real project run.
Community-driven latest updates:
- Exact
--dry-runoutput now shows full-file diffs of what will be written. - Added support for
kotlin.incremental.useClasspathSnapshot=true.
- Configuration cache disabled (CRITICAL)
- Build cache disabled (CRITICAL)
- Parallel execution disabled (HIGH)
- Kotlin incremental disabled (HIGH)
- JVM heap too low (MEDIUM)
- Configure on demand disabled (MEDIUM)
- Gradle daemon disabled (LOW)
- Dynamic dependency versions (LOW, audit-only; scans
build.gradle*andgradle/libs.versions.toml)
- Audit:
npx droidperf audit /path/to/your/android/project- Config (optional): add
.droidperfrc.json(ordroidperf.config.json) at the project root.
{
"buildsPerDay": 20,
"recommend": { "jvmXmxMb": 4096 },
"rules": {
"enabled": {
"configure-on-demand": false
}
}
}You can also pass it explicitly:
npx droidperf audit /path/to/project --config /path/to/.droidperfrc.json- List rules (IDs, severity, estimated savings, autofix availability):
npx droidperf audit --list-rules- Apply fixes:
npx droidperf fix /path/to/your/android/project- Preview changes (recommended first):
npx droidperf fix /path/to/your/android/project --dry-run- Apply only some rules:
npx droidperf fix /path/to/your/android/project --only configuration-cache,build-cache --dry-run
npx droidperf fix /path/to/your/android/project --exclude jvm-heap- LLM Build Analysis (Beta): Analyze a Gradle build log to find bottlenecks using an LLM.
# Set key once
npx droidperf config --set-key your-key
# Run analysis (auto-detects build.log)
npx droidperf analyze
# Run analysis and apply recommended fixes automatically
npx droidperf analyze --apply
# Use a specific model
npx droidperf analyze --model openai/gpt-4o- Machine-readable output (CI):
npx droidperf audit /path/to/your/android/project --json
npx droidperf fix /path/to/your/android/project --dry-run --jsonBefore writing, droidperf fix saves a timestamped backup to .droidperf-backup/.
Example restore:
cp .droidperf-backup/gradle.properties.<timestamp>.bak gradle.propertiesdroidperf fix only applies safe edits to gradle.properties:
org.gradle.configuration-cache=trueorg.gradle.caching=trueorg.gradle.parallel=truekotlin.incremental=truekotlin.incremental.useClasspathSnapshot=trueorg.gradle.configureondemand=trueorg.gradle.daemon=trueorg.gradle.jvmargs: updates/sets-Xmx(4096m) and ensures-Dfile.encoding=UTF-8without deleting your existing JVM args flags
Dynamic dependency versions are reported but not auto-fixed.
- Supported: Android Gradle projects (Groovy + Kotlin DSL), KMP (Gradle-based), version catalogs, composite builds (
includeBuild(...)best-effort), and Flutter’s Android module (auto-detectsandroid/). - Guardrails: very large files are skipped to keep scans fast and predictable.
--no-color: disable ANSI colors (CI-friendly)--json: machine-readable output for audits/fixes
See CHANGELOG.md.
See CONTRIBUTING.md.
See SECURITY.md.
See the upcoming features:
- Local LLM Support: Integration with Ollama for offline analysis.
- Visual Timelines: Mermaid.js charts generated from build logs.
- Project Structure Analysis: Deep scan of
build.gradlefiles to suggest modularization.
Maintained by Rudra Dave.
Built by a senior Android/KMP engineer. Open to remote roles → github.com/rudradave1
- Issues: use GitHub Issues for bugs/features
- Security: see
SECURITY.md - Contact:
rudramordan@gmail.com - Updates:
https://www.linkedin.com/in/rudradave/
npm install
node bin/droidperf.js audit --path /path/to/android/project --no-color
node bin/droidperf.js fix --path /path/to/android/project --dry-run --no-color