Getting Started
February 6, 2026 ยท View on GitHub
Purpose
Get to a successful first run quickly, then branch into the right workflow guide.
Prerequisites
| Area | Requirement |
|---|---|
| Neovim | 0.9+ with Lua support |
| Android | Android SDK tools and adb |
| iOS (optional) | Xcode tools |
| Picker UI | Telescope optional, vim.ui fallback is supported |
Setup
- Add this
lazy.nvimplugin spec:
{
"iamironz/android-nvim-plugin",
lazy = false,
config = function()
require("android").setup()
end,
}
- Run
:Lazy sync. - Restart Neovim.
If you use another plugin manager, see install.md.
First Successful Run
- Open a project root.
- Run
:AndroidMenu. - Select a section using
[1],[2], or<CR>. - Use
/for search,<Left>to go back, and<Right>to open selection.
Validate Environment
If setup fails, run :checkhealth android first.
Common issue path: support/troubleshooting.md#sdk-not-found
Next Steps
- Build and deploy: guides/build-and-deploy.md
- Logcat: guides/logcat.md
- Devices and ADB: guides/devices-and-adb.md
- Run configs: guides/run-configs.md
- Configuration reference: reference/configuration.md