_..._                             
 .'   (_`.    _                         __     ___           
:  .      :  | |   _   _ _ __   __ _ _ _\ \   / (_)_ __ ___  
:)    ()  :  | |  | | | | '_ \ / _` | '__\ \ / /| | '_ ` _ \ 
`.   .   .'  | |__| |_| | | | | (_| | |   \ V / | | | | | | |
  `-...-'    |_____\__,_|_| |_|\__,_|_|    \_/  |_|_| |_| |_|

• Project Goals
• What's included?
  • Why do I want tree-sitter and LSP?
• Install In One Command!
  • Get the latest version of Neovim
• Getting started
  • Home screen
  • Leader and Whichkey
  • Important Configuration files
• Clipboard Support
• LSP
• Useful Programs
• EFM server
• Formatters and Linters
• De-bugging
• VSCodium
• Useful commands for troubleshooting
• TODO

• This project aims to help one transition away from VSCode, and into a superior text editing experience. (Just making this clear)

• This is also a community project, if you would like to see support for a feature or language consider making a PR.

• This project will do it's best to include core features you would expect from a modern IDE, while making it easy to add or remove what the user wants.

LunarVim provides neovim configuration files that take advantage of tree-sitter and language server protocol. The configuration is written in lua.

• Normally, an editor uses regular expression parsing for things like highlighting and checking the syntax of your file. Each time you make a change, the editor must re-parse the entire file. Tree-sitter, on the other hand, transforms text into a syntax tree. Each time you make a change, only the parts of the code that change need to be parsed. This greatly improves the speed of parsing. This can make a huge difference when editing large files.

• Neovim 0.5 including language server protocol means your editor can provide: code actions, completions, formatting, navigating to definitions, renaming, etc. The language server only has to be written once and will work on any editor that supports LSP. Any improvements made to the language server will immediately be used by all editors that support LSP.

Make sure you have the newest version of Neovim.

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

After installation run nvim and then :PackerInstall

Some operating systems package versions of Neovim 0.5. You can install those or you can follow the steps below to compile from source. Compiling from source is the recommended method.

First, get the dependencies. For distributions other than Ubuntu or Arch go here

#Ubuntu
sudo apt-get install gettext libtool libtool-bin autoconf automake cmake g++ pkg-config unzip build-essential
#Arch
sudo pacman -S base-devel cmake unzip ninja tree-sitter

Download and compile Neovim

cd ~
sudo rm -r neovim
git clone https://github.com/neovim/neovim
cd neovim
sudo make CMAKE_BUILD_TYPE=Release install
cd ~
sudo rm -r neovim

or if you are on Arch you can get it from the AUR

yay -S neovim-git

The home screen is a plugin called dashboard. It uses the Telescope plugin to find files or find words within files. The home screen provides a link to load saved Sessions. The home screen links to the settings file located at this path: ~/.config/nvim/lv-settings.lua

The default leader key is set to <Space>. Pressing it will also open up whichkey. Whichkey will help you easily access many of the default keybindings.

Other key bindings can be found in ~/.config/nvim/lua/keymappings.lua

If you already have a set of keybindings in vimscript that you prefer, source your vimscript file from ~/.config/nvim/init.lua

Example:

vim.cmd('source ~/.config/nvim/vimscript/keymappings.vim')

Or you can translate your old bindings to lua and keep them in the provided keymappings file. Follow the lua guide available here

• On Mac pbcopy should be built-in

• Ubuntu

  sudo apt install xclip

• Arch

  sudo pacman -S xclip

• WSL2

  Make sure ~/bin is in your path in this case.

  curl -sLo/tmp/win32yank.zip https://github.com/equalsraf/win32yank/releases/download/v0.0.4/win32yank-x64.zip
  unzip -p /tmp/win32yank.zip win32yank.exe > /tmp/win32yank.exe
  chmod +x /tmp/win32yank.exe
  mv /tmp/win32yank.exe ~/bin

To install a supported language server:

  :LspInstall <your_language_server>

Most common languages should be supported out of the box, if yours is not I would welcome a PR

For a more in depth LSP support: link

LunarVim depends on the following:

ranger
ueberzug
ripgrep
pynvim
neovim-remote

In order for linters and formatters to work you will need to install efm-langserver

:LspInstall efm

Python

pip3 install --user flake8
pip3 install --user yapf

Lua

luarocks install --server=https://luarocks.org/dev luaformatter

Yaml, Json, Javascript, HTML, CSS

npm install -g prettier

Markdown

pandoc

To set up your particular debugger, look here: link

I recommend you support Free/Libre versions if you plan to use VSCode:

• VSCodium

• Article to get you set up with VSCodium: link

After installing the Neovim extension in VSCode

I recommend using this alongside the VSCode which-key extension

You will also need settings.json and keybindings.json which can be found in utils/vscode_config

Point the nvim path to your nvim binary

Point your init.vim path to:

$HOME/.config/nvim/vimscript/lv-vscode/init.vim

Whether you plan on using LunarVim as is or as a base to configure your own neovim, the following commands may be useful. Any command that includes the symbol ':' is meant to be typed as a command in neovim. Make sure you're in normal mode not insert mode.

HIGH PRIORITY

• Move user config into config.lua ts-comment string for react
• From here I will update for bug fixes and implement low priority features when I have time
• different key to advance through snippets

LOW PRIORITY

• vim vsnips dir should be co-located with config
• list all binaries needed for formatters and linters (one day add in wiki)
• Implement what I can from this java config: link
  • better ui for code actions - formatting
  • setup junit tests for java
• look into emmet-ls
• vim ult test
• which-key all in lua
• what is fzy
• https://github.com/pwntester/octo.nvim
• configure surround
• Implement this for typescript https://github.com/jose-elias-alvarez/nvim-lsp-ts-utils
• look into tabnine

PLUGIN BUGS

REACT COMMENTING IS A NIGHTMARE (the filetype is just not recognized idk why)