droidperf

Android Gradle performance auditor and auto-fixer.

Audit and safely fix common Gradle build-time misconfigurations in Android projects.

What's new in 2.1

• 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.

What's new in 2.0

• 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.md for team sharing

It’s designed to be boring in the best way: conservative fixes, transparent diffs, and easy rollback.

Design Philosophy

• Prefer safe, reversible fixes over aggressive optimizations
• Avoid modifying build scripts directly (only gradle.properties)
• Focus on high-impact, low-risk improvements first

Demo

1. Analyze your build

npx droidperf analyze --build-log ./build.log

2. Preview fixes before applying

npx droidperf analyze --build-log ./build.log --apply --dry-run

3. Apply fixes automatically

npx droidperf analyze --build-log ./build.log --apply

Quickstart

npx droidperf audit /path/to/your/android/project
npx droidperf fix /path/to/your/android/project --dry-run
npx droidperf fix /path/to/your/android/project

Flutter repo? Point at the repo root — droidperf will auto-detect and audit the android/ Gradle subproject.

One-pager

If you want a short “why/what/how” you can share, see docs/ONE_PAGER.md.

Example output

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.

What the community found

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-run output now shows full-file diffs of what will be written.
• Added support for kotlin.incremental.useClasspathSnapshot=true.

What it checks

• 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* and gradle/libs.versions.toml)

Usage

• Audit:

npx droidperf audit /path/to/your/android/project

• Config (optional): add .droidperfrc.json (or droidperf.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 --json

Safety

Before writing, droidperf fix saves a timestamped backup to .droidperf-backup/.

Example restore:

cp .droidperf-backup/gradle.properties.<timestamp>.bak gradle.properties

What it changes

droidperf fix only applies safe edits to gradle.properties:

• org.gradle.configuration-cache=true
• org.gradle.caching=true
• org.gradle.parallel=true
• kotlin.incremental=true
• kotlin.incremental.useClasspathSnapshot=true
• org.gradle.configureondemand=true
• org.gradle.daemon=true
• org.gradle.jvmargs: updates/sets -Xmx (4096m) and ensures -Dfile.encoding=UTF-8 without deleting your existing JVM args flags

Dynamic dependency versions are reported but not auto-fixed.

Notes

• Supported: Android Gradle projects (Groovy + Kotlin DSL), KMP (Gradle-based), version catalogs, composite builds (includeBuild(...) best-effort), and Flutter’s Android module (auto-detects android/).
• Guardrails: very large files are skipped to keep scans fast and predictable.

Output formats

• --no-color: disable ANSI colors (CI-friendly)
• --json: machine-readable output for audits/fixes

Changelog

See CHANGELOG.md.

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.

Roadmap

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.gradle files to suggest modularization.

Maintainer

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: [email protected]
• Updates: https://www.linkedin.com/in/rudradave/

Local development

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