android-nvim-plugin

Neovim plugin for Android and mobile development workflows: build, run, logcat, device management, and Gradle tasks.

I built this after one too many Android Studio updates traded stability for a fresh pile of features I did not ask for. Open a few projects and the laptop turns into a space heater while memory keeps climbing. Every release ships more panels and more prompts while the basics keep wobbling. Big tech loves the feature treadmill, even when it makes the IDE heavier than the app.

Now that AI coding is everywhere, a full featured IDE feels like a spaceship for a grocery run, so I wanted something smaller and mine. This plugin keeps the essentials close and the workflow honest inside Neovim. It is also buggy and probably leaks memory in its own charming way. Think of it as a lighter bag of problems with a better keyboard.

Compatibility

Area	Support	Notes
Neovim	0.9+	Lua support required
Android	Android SDK tools and adb	Required for Android actions
iOS	Xcode tools	Required for iOS actions
KMP	Kotlin Multiplatform plugin	Enables KMP target detection
UI picker	Telescope or vim.ui	Telescope is optional

Quick Start

1. Add this lazy.nvim plugin spec:

{
  "iamironz/android-nvim-plugin",
  lazy = false,
  config = function()
    require("android").setup()
  end,
}

1. Run :Lazy sync.
2. Open a project and run :AndroidMenu.
3. Use [1], [2], and <CR> to enter sections. Use / to search.

If you use another plugin manager, see docs/install.md.

Full first-run walkthrough: docs/getting-started.md

Features

Commands and Keymaps

• Command surface: 13 zero-arg user commands.
• Default shortcuts (unchanged): :AndroidMenu, :AndroidTargets, :AndroidTools, :AndroidActions, and :AndroidBuild on <leader>am/at/ao/aa/ab.
• Direct commands (no default shortcut): :AndroidRun, :AndroidRunStop, :AndroidLogcat, :AndroidBuildPrompt, :AndroidBuildAssemble, :AndroidGradleTasks, :AndroidIOSBuild, :AndroidIOSDeploy.
• Custom mapping support: every command has a matching <Plug> mapping. See docs/reference/keymaps.md.

Navigation and UX

• Hub menus with summary panel. Section shortcuts ([1]...[9]), search (/ or any letter), back navigation. Menu adapts to project type: Android, iOS, KMP, and JVM items show or hide automatically. See docs/guides/navigation.md.
• Picker flexibility. Telescope with automatic vim.ui fallback.

Build and Deploy

• One-key build and deploy. :AndroidBuild resolves module/variant from saved defaults, builds, installs, launches, and opens logcat.
• Prompt-driven builds. :AndroidBuildPrompt picks module/variant for one run.
• Assemble-only mode. :AndroidBuildAssemble builds without deploying.
• Default variant detection. Reads isDefault markers from buildTypes and productFlavors in build.gradle to auto-select the right variant.
• APK discovery. Resolves by variant, scans flavor subdirectories, supports path overrides and full-scan fallback.
• Gradle task browser. Browse and run any task via :AndroidGradleTasks.
• Build output dock. Bottom panel with real-time streaming, text filter with history, and quickfix-ready error highlighting.
• Quickfix integration. Kotlin and Java errors parsed into quickfix list on build failure. See docs/guides/build-and-deploy.md.

iOS Build and Deploy

• xcodebuild integration. :AndroidIOSBuild builds with auto-discovered schemes.
• Simulator and physical device deploy. :AndroidIOSDeploy discovers booted simulator or paired device, installs, and launches.

Logcat

• Direct command. :AndroidLogcat opens the dock panel on demand.
• Dock panel. Fixed control header (package/filter/level) and scrolling output with syntax highlighting by log level.
• Package filtering. Auto-detects from APK, manifest, or build.gradle.
• Text and regex filtering. Space-separated terms, /pattern/ for regex. Filter history with Telescope completion.
• Log level filtering. V, D, I, W, E.
• Pause/resume, restart, clear, reset. Single-key controls.
• Stack trace navigation. <CR> on (File.kt:42) jumps to source.
• Auto-reconnect. Keeps logcat alive across device disconnects.
• Multi-session. Independent state per run config. See docs/guides/logcat.md.

Device Manager and ADB

• Device selection. Pick target device, auto-selects first connected.
• AVD selection and creation. Pick or create AVDs with device profile and system image selection.
• Emulator start/stop. Launch by AVD name with boot wait, or stop running.
• ADB actions. Install APK, clear app data, uninstall. See docs/guides/devices-and-adb.md.

Run Configurations

• Multi-target. Android, iOS, JVM, Gradle task, and shell configs auto-discovered from a single menu.
• Direct run controls. :AndroidRun starts the selected run config and :AndroidRunStop stops active jobs.
• Run All. Parallel execution across target types. Ordering and preferred modules configurable via run.run_all.
• JSON shell configs. Custom commands in .android.nvim.json with real-time output.
• Stop running jobs from the menu. See docs/guides/run-configs.md.

Workspace and SDK

• Project detection. Auto-detects Gradle root, Android modules, KMP targets, and iOS workspaces.
• SDK discovery. Finds Android SDK from config, local.properties, env vars, or OS defaults. Resolves adb, aapt2, emulator, and other tools automatically.
• Gradle caching. Tasks, variants, and modules cached and prefetched in the background so menu actions stay fast.
• Persistent selections. Module, variant, device, AVD, run config, and logcat state saved per workspace across sessions.
• Health checks. :checkhealth android validates SDK, tools, Gradle, and iOS. See docs/reference/configuration.md and docs/support/troubleshooting.md.

Editor Integration

• Auto-save. Saves modified buffers before you switch context.
• File watcher. Detects external changes and prompts to reload or diff.
• Read-only output. Logcat and build panels are non-editable.
• Transparent roadmap. Tracked in docs/roadmap.md.

Documentation

Docs home: docs/README.md

Goal	Doc
Install and first run	docs/getting-started.md, docs/install.md
Menu navigation and workflows	docs/guides/navigation.md
Build and deploy	docs/guides/build-and-deploy.md
Logcat usage	docs/guides/logcat.md
Devices and ADB	docs/guides/devices-and-adb.md
Run configuration model	docs/guides/run-configs.md
Command/config/keymap reference	docs/reference/commands.md, docs/reference/configuration.md, docs/reference/keymaps.md
Troubleshooting	docs/support/troubleshooting.md
Maintainer workflows	docs/maintainers/development.md, docs/maintainers/release.md, docs/maintainers/triage.md
Roadmap and change log	docs/roadmap.md, CHANGELOG.md

Contributing

See CONTRIBUTING.md.

License

MIT