Skip to content

Dusk is a blazing fast Lua config suited for Full Stack Java development.


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



52 Commits

Repository files navigation

Dusk Neovim

Dusk.nvim is a blazing fast Lua config suited for Full-stack Java development.

Optimized with Spring Boot && Angular projects in mind.





Design Philosophy

Dusk.nvim is designed to be:

  • minimal. 1700 lines of code in total and you have a full IDE.
  • performant. ~70-80ms startup time on modern hardware.
  • Out-of-the-box complete. Works with installation.
  • Not opinionated. Defaults are always preferred.
  • Extensible. The codebase is very easy to understand and extend.


  • Native LSP and autocompletion
  • Syntax highlighting via nvim-treesitter
  • Java Unit Testing
  • Java Debugging
  • Javascript client side && server side debugging
  • Sonarlint support
  • Git integration with LazyGit
  • Explore files via nvim-tree
  • Fuzzy finder via Telescope
  • Good markdown support

Project Structure

├── init.lua
└── lua
    ├── optional
    │   └── optionalfeatures.lua
    ├── pluginconfigs
    │   ├── cmp.lua
    │   ├── dadbod.lua
    │   ├── dap.lua
    │   ├── dashboard.lua
    │   ├── jdtls.lua
    │   ├── lsp.lua
    │   ├── treesitter.lua
    │   └── whichkey.lua
    └── settings
        ├── autocommands.lua
        ├── keymaps.lua
        └── options.lua

The project structure is very simple:

  • Plugins with minimal configuration are loaded in init.lua.
    Basically, go through init.lua and you have understood the whole codebase.
  • Vim options are in options.lua
  • Non-whichkey registered keymaps are in keymaps.lua. The rest are in whichkey.lua.
  • Autocommands are in autocommands.lua
  • Go through the optionalfeatures.lua and uncomment the features you want enabled in your build.
  • The more extensive configuration that some plugins require are in pluginconfigs folder.
    Pay special attention to jdtls.lua, because there you can choose your Java server options


For Dusk.nvim to perform as intended, you need to have the following dependencies installed:

  1. Neovim version >= 0.9.5
  2. Git 2.23+
  3. Ripgrep for telescope
  4. fd for telescope
  5. Nodejs
  6. Neovim node client (npm install -g neovim) - neovim/node-client
  7. "zig", "clang", or "gcc" executables to be able to compile treesitter parsers (check your package manager for one of these)
  8. Treesitter-cli nodejs module (Check your package manager for a treesitter or treesitter-cli package)
  9. Java 17+ (for Java LSP server)
  10. A font with nerdfont icons (my suggestion:
  11. LazyGit && LazyDocker if you are going to use it inside neovim.

NOTE: Run :checkhealth command to see what other dependencies you might be missing and to receive help if you have problems with installation.


Platform Supported
  1. Make sure to remove or move your current nvim directory (~/.config/nvim), if it exists.
  2. git clone
  3. Copy or Move the nvim folder from the cloned dusk.nvim project (not the dusk.nvim folder!) to your ~/.config/ folder. In the end, your folder should look like this: ~/.config/nvim. Please note, depending on your OS, neovim might search for configuration in a different folder. In this case, run the :checkhealth command inside neovim, to see where it looks for configuration and place the nvim folder inside that.
  4. Run the nvim command and wait for the plugins to be installed.
  5. If some plugins fail to install at this point, don't be alarmed. Enter the :qa! command to exit neovim.
  6. Re-run the nvim command and enter SPC p s to update the package manager (if it's not done automatically). In general, you might have to do a lot of restarts of nvim until all the packages are installed. It can take quite some time.
  7. If some packages fail to install consistently, run the :checkhealth command and check the dependencies section above to see what you might be missing.
  8. Happy editing!

State of Java experience

Dusk.nvim provides a java development experience with the following advantages:

  • Eclipse level editing and refactoring capabilities in neovim
  • Support for Sonarlint
  • Autocomplete candidates from the current buffer, which includes comments
  • Superb coding navigation - searches references in decompiled sources also
  • Execute and debug test methods and classes

Features curently not supported (these are what you will miss from your IDE - but also shows the room for improvement):

  • No option for running all tests in test resource folders
  • Referenced external libraries not available in file explorer tree

Java Multiple Runtimes

In jdtls.lua, you will find the following snippet. Here you can configure your multiple java runtimes.


            settings = {
              java = {
                configuration = {
                  runtimes = {
                      name = "JavaSE-1.8",
                      path = "/Library/Java/JavaVirtualMachines/jdk1.8.0_291.jdk/Contents/Home",
                      name = "JavaSE-11",
                      path = "/opt/homebrew/Cellar/openjdk@11/11.0.18/libexec/openjdk.jdk/Contents/Home",
                      default = true
                      name = "JavaSE-19",
                      path = "/opt/homebrew/Cellar/openjdk/19.0.2/libexec/openjdk.jdk/Contents/Home",