My favorite VIM based IDE !!

Christian Chiarulli c7aa418609 Merge branch 'rolling' of github.com:LunarVim/LunarVim into rolling 3 lat temu
.github 27679f988f [Refactor]: only allow a single logger (#1405) 3 lat temu
colors 0f458a0468 onedarker colorscheme 3 lat temu
ftdetect a4073e9992 support nix language (#1347) 3 lat temu
ftplugin bc5b315e53 Setup tailwindcss language server (#1376) 3 lat temu
lua e9d8d8cd2e fix the string concat in logging (#1441) 3 lat temu
utils 465c975214 Fix typo in vscode_config 3 lat temu
.gitignore a6cf2e871a stylua is always in root 4 lat temu
.luacheckrc 213e3961fa [Feature] Rename lv-config.lua to config.lua (#1193) 4 lat temu
.pre-commit-config.yaml 1cc2452eb7 [Bugfix] ignore jdtls to fix `CI` (#1339) 3 lat temu
.stylua.toml a6cf2e871a stylua is always in root 4 lat temu
CONTRIBUTING.md 988c74ec56 feat: Add pre-commit hook for linting and formatting (#1132) 4 lat temu
LICENSE d3e94f3086 update license 4 lat temu
README.md f354012254 chore: simplify example 3 lat temu
init.lua ff4b5b19de fix runtime path (#1443) 3 lat temu

README.md

LunarVim Demo

Documentation

You can find all of the documentation for Lunarvim at lunarvim.org

Install In One Command!

Make sure you have the release version of Neovim (0.5).

bash <(curl -s https://raw.githubusercontent.com/lunarvim/lunarvim/master/utils/installer/install.sh)

Install Language support

  • Enter :LspInstall followed by <TAB> to see your options for LSP

  • Enter :TSInstall followed by <TAB> to see your options for syntax highlighting

NOTE I recommend installing lua for autocomplete in config.lua

Configuration file

To install plugins configure LunarVim use the config.lua located here: ~/.config/lvim/config.lua

Example:

-- general
lvim.format_on_save = true
lvim.colorscheme = "onedarker"

lvim.leader = "space"
-- add your own keymapping
lvim.keys.normal_mode["<C-s>"] = ":w<cr>"
-- unmap a default keymapping
-- lvim.keys.normal_mode["<C-Up>"] = ""
-- edit a default keymapping
-- lvim.keys.normal_mode["<C-q>"] = ":q<cr>"
-- set keymap with custom opts
-- lvim.keys.insert_mode["po"] = {'<ESC>', { noremap = true }}

-- Use which-key to add extra bindings with the leader-key prefix
-- lvim.builtin.which_key.mappings["P"] = { "<cmd>Telescope projects<CR>", "Projects" }

-- Configure builtin plugins
lvim.builtin.dashboard.active = true
lvim.builtin.terminal.active = true

-- Treesitter parsers change this to a table of the languages you want i.e. {"java", "python", javascript}
lvim.builtin.treesitter.ensure_installed = "maintained"
lvim.builtin.treesitter.ignore_install = { "haskell" }

-- Disable virtual text
lvim.lsp.diagnostics.virtual_text = false

-- set a formatter if you want to override the default lsp one (if it exists)
lvim.lang.python.formatters = {
  {
    exe = "black",
    args = {}
  }
}
-- set an additional linter
lvim.lang.python.linters = {
  {
    exe = "flake8",
    args = {}
  }
}


-- Additional Plugins
lvim.plugins = {
    {"lunarvim/colorschemes"},
    {"folke/tokyonight.nvim"}, {
        "ray-x/lsp_signature.nvim",
        config = function() require"lsp_signature".on_attach() end,
        event = "InsertEnter"
    }
}

Updating LunarVim

In order to update you should be aware of three things Plugins, LunarVim and Neovim

To update plugins:

:PackerUpdate

To update LunarVim:

cd ~/.local/share/lunarvim/lvim && git pull
:PackerSync

Resources

Testimonials

"I have the processing power of a potato with 4 gb of ram and LunarVim runs perfectly."

"My minimal config with a good amount less code than LunarVim loads 40ms slower. Time to switch."

  • @mvllow, Potential LunarVim user.
[![Lua](https://img.shields.io/badge/Made%20with%20Lua-blue.svg?style=for-the-badge&logo=lua)](#madewithlua)