2021-06-30 06:55:40 +02:00
|
|
|
![LunarVim Demo](./utils/media/lunarvim_logo_dark.png)
|
2021-05-04 23:55:45 +02:00
|
|
|
|
2021-06-30 20:28:26 +02:00
|
|
|
<div align="center"><p>
|
|
|
|
<a href="https://github.com/ChristianChiarulli/LunarVim/releases/latest">
|
|
|
|
<img alt="Latest release" src="https://img.shields.io/github/v/release/ChristianChiarulli/LunarVim" />
|
|
|
|
</a>
|
|
|
|
<a href="https://github.com/ChristianChiarulli/LunarVim/pulse">
|
|
|
|
<img alt="Last commit" src="https://img.shields.io/github/last-commit/ChristianChiarulli/LunarVim"/>
|
|
|
|
</a>
|
2021-07-06 16:02:40 +02:00
|
|
|
<a href="https://github.com/ChristianChiarulli/LunarVim/blob/main/LICENSE">
|
|
|
|
<img src="https://img.shields.io/github/license/siduck76/NvChad?style=flat-square&logo=GNU&label=License" alt="License"
|
|
|
|
/>
|
2021-06-30 20:28:26 +02:00
|
|
|
<a href="https://patreon.com/chrisatmachine" title="Donate to this project using Patreon">
|
|
|
|
<img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon donate button" />
|
|
|
|
</a>
|
|
|
|
<a href="https://twitter.com/intent/follow?screen_name=chrisatmachine">
|
|
|
|
<img src="https://img.shields.io/twitter/follow/chrisatmachine?style=social&logo=twitter" alt="follow on Twitter">
|
|
|
|
</a>
|
2021-07-06 16:02:40 +02:00
|
|
|
</p>
|
|
|
|
|
2021-06-30 20:28:26 +02:00
|
|
|
</div>
|
2021-03-27 19:32:45 +01:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
## Install In One Command!
|
2021-04-29 07:36:13 +02:00
|
|
|
|
2021-05-04 23:55:45 +02:00
|
|
|
Make sure you have the newest version of Neovim (0.5).
|
2021-04-29 07:36:13 +02:00
|
|
|
|
2021-05-04 23:55:45 +02:00
|
|
|
``` bash
|
2021-07-09 00:40:30 +02:00
|
|
|
bash <(curl -s https://raw.githubusercontent.com/ChristianChiarulli/lunarvim/master/utils/installer/install.sh)
|
2021-03-15 03:25:28 +01:00
|
|
|
```
|
2021-05-04 23:55:45 +02:00
|
|
|
|
2021-07-14 03:13:55 +02:00
|
|
|
If you help to develop Lunarvim, you can install a specific branch branch directly
|
|
|
|
``` bash
|
|
|
|
LVBRANCH=rolling bash <(curl -s https://raw.githubusercontent.com/ChristianChiarulli/lunarvim/rolling/utils/installer/install.sh)
|
|
|
|
```
|
|
|
|
|
|
|
|
If your installation is stuck on `Ok to remove? [y/N]`, it means there are some leftovers, \
|
|
|
|
you can run the script with `--overwrite` but be warned this will remove the following folder:
|
|
|
|
- `~/.config/nvim`
|
|
|
|
- `~/.cache/nvim`
|
|
|
|
- `~/.local/share/nvim/site/pack/packer`
|
|
|
|
```bash
|
|
|
|
curl -s https://raw.githubusercontent.com/ChristianChiarulli/lunarvim/rolling/utils/installer/install.sh| LVBRANCH=rolling bash -s -- --overwrite
|
|
|
|
```
|
|
|
|
|
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
## Installing LSP for your language
|
2021-04-29 07:36:13 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
Just enter `:LspInstall` followed by `<TAB>` to see your options
|
2021-05-04 23:55:45 +02:00
|
|
|
|
2021-07-09 00:40:30 +02:00
|
|
|
**NOTE** I recommend installing `lua` for autocomplete in `lv-config.lua`
|
2021-04-29 07:36:13 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
## Configuration file
|
2021-04-29 07:36:13 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
To activate other plugins and language features use the `lv-config.lua` file provided in the `nvim` folder (`~/.config/nvim/lv-config.lua`)
|
2021-04-29 07:36:13 +02:00
|
|
|
|
|
|
|
Example:
|
2021-05-04 23:55:45 +02:00
|
|
|
|
2021-06-26 20:22:50 +02:00
|
|
|
```lua
|
2021-07-03 02:58:53 +02:00
|
|
|
-- O is the global options object
|
2021-06-26 20:22:50 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
-- THESE ARE EXAMPLE CONFIGS FEEL FREE TO CHANGE TO WHATEVER YOU WANT
|
|
|
|
-- general
|
2021-07-14 03:13:55 +02:00
|
|
|
-- O.default_options.wrap = true -- wrap long lines
|
|
|
|
O.completion.autocomplete = true
|
|
|
|
O.default_options.relativenumber = true
|
2021-07-03 02:58:53 +02:00
|
|
|
O.colorscheme = 'spacegray'
|
2021-07-14 03:13:55 +02:00
|
|
|
O.default_options.timeoutlen = 100
|
2021-07-03 02:58:53 +02:00
|
|
|
O.leader_key = ' '
|
2021-04-29 19:28:10 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
-- After changing plugin config it is recommended to run :PackerCompile
|
2021-07-08 07:36:44 +02:00
|
|
|
O.plugin.dashboard.active = true
|
|
|
|
O.plugin.floatterm.active = true
|
2021-07-03 02:58:53 +02:00
|
|
|
O.plugin.zen.active = true
|
2021-06-26 20:22:50 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
-- if you don't want all the parsers change this to a table of the ones you want
|
|
|
|
O.treesitter.ensure_installed = "all"
|
|
|
|
O.treesitter.ignore_install = {"haskell"}
|
|
|
|
O.treesitter.highlight.enabled = true
|
2021-04-29 19:28:10 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
-- lua
|
|
|
|
O.lang.lua.autoformat = false
|
|
|
|
O.lang.lua.formatter = 'lua-format'
|
2021-06-26 20:22:50 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
-- javascript
|
|
|
|
O.lang.tsserver.formatter = 'prettier'
|
|
|
|
O.lang.tsserver.linter = nil
|
|
|
|
O.lang.tsserver.autoformat = true
|
2021-04-29 19:28:10 +02:00
|
|
|
|
2021-07-08 07:36:44 +02:00
|
|
|
-- python
|
|
|
|
O.lang.python.isort = true
|
|
|
|
O.lang.python.diagnostics.virtual_text = true
|
|
|
|
O.lang.python.analysis.use_library_code_types = true
|
2021-07-14 03:13:55 +02:00
|
|
|
-- to change default formatter from yapf to black
|
|
|
|
-- O.lang.python.formatter.exe = "black"
|
|
|
|
-- O.lang.python.formatter.args = {"-"}
|
|
|
|
|
|
|
|
-- go
|
|
|
|
-- to change default formatter from gofmt to goimports
|
|
|
|
-- O.lang.formatter.go.exe = "goimports"
|
2021-07-07 08:36:56 +02:00
|
|
|
|
|
|
|
-- Additional Plugins
|
2021-07-08 07:36:44 +02:00
|
|
|
-- O.user_plugins = {
|
2021-07-14 03:13:55 +02:00
|
|
|
-- {"folke/tokyonight.nvim"},
|
|
|
|
-- {
|
|
|
|
-- "ray-x/lsp_signature.nvim",
|
|
|
|
-- config = function()
|
|
|
|
-- require"lsp_signature".on_attach()
|
|
|
|
-- end,
|
|
|
|
-- event = "InsertEnter"
|
|
|
|
-- },
|
|
|
|
-- }
|
|
|
|
|
2021-07-08 07:36:44 +02:00
|
|
|
-- }
|
2021-07-07 08:36:56 +02:00
|
|
|
|
|
|
|
-- Autocommands (https://neovim.io/doc/user/autocmd.html)
|
|
|
|
-- O.user_autocommands = {{ "BufWinEnter", "*", "echo \"hi again\""}}
|
|
|
|
|
|
|
|
-- Additional Leader bindings for WhichKey
|
|
|
|
-- O.user_which_key = {
|
|
|
|
-- A = {
|
|
|
|
-- name = "+Custom Leader Keys",
|
|
|
|
-- a = { "<cmd>echo 'first custom command'<cr>", "Description for a" },
|
|
|
|
-- b = { "<cmd>echo 'second custom command'<cr>", "Description for b" },
|
|
|
|
-- },
|
|
|
|
-- }
|
2021-07-14 03:13:55 +02:00
|
|
|
|
|
|
|
-- To link your init.vim (until you find Lua replacements)
|
|
|
|
-- vim.cmd('source ' .. CONFIG_PATH .. '/lua/lv-user/init.vim')
|
2021-04-29 19:28:10 +02:00
|
|
|
```
|
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
## Updating LunarVim
|
2021-03-26 22:02:27 +01:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
In order to update you should be aware of three things `Plugins`, `LunarVim` and `Neovim`
|
2021-03-26 05:58:18 +01:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
To update plugins:
|
2021-05-04 23:55:45 +02:00
|
|
|
|
2021-05-03 02:13:09 +02:00
|
|
|
```
|
2021-07-03 02:58:53 +02:00
|
|
|
:PackerUpdate
|
2021-05-03 02:13:09 +02:00
|
|
|
```
|
2021-03-23 03:09:11 +01:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
To update LunarVim:
|
2021-05-03 02:13:09 +02:00
|
|
|
|
2021-07-08 07:36:44 +02:00
|
|
|
```bash
|
2021-07-03 02:58:53 +02:00
|
|
|
cd ~/.config/nvim && git pull
|
2021-05-03 02:14:39 +02:00
|
|
|
```
|
2021-04-29 07:36:13 +02:00
|
|
|
|
2021-07-09 00:40:30 +02:00
|
|
|
To update Neovim use your package manager
|
|
|
|
|
2021-07-14 03:13:55 +02:00
|
|
|
## Project Goals
|
|
|
|
|
|
|
|
1. Provide basic functionalities required from an IDE
|
|
|
|
- LSP
|
|
|
|
- Formatting/Linting
|
|
|
|
- Debugging
|
|
|
|
- Treesitter
|
|
|
|
- Colorschemes
|
|
|
|
2. Be as fast and lean as possible
|
|
|
|
- Lazy loading
|
|
|
|
- Not a single extra plugin
|
|
|
|
- User configurable lang/feature enable/disable
|
|
|
|
3. Provide a [simple and easy](https://github.com/LunarVim/LunarVimCommunity) way for users to share their own configuration or use others.
|
|
|
|
4. Hot reload of configurations
|
|
|
|
- Hot install of lsp/treesitter/formatter required upon openning a filetype for the first time
|
|
|
|
5. Provide a stable & maintainable error free configuration layer over neovim
|
|
|
|
- With the help of the community behind it
|
|
|
|
- Github workflow testing
|
|
|
|
- Freezing plugin versions
|
|
|
|
6. Provide detailed documentation
|
|
|
|
- Video series on how to configure LunarVim as an IDE for each lang
|
|
|
|
7. Valhalla
|
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
## Resources
|
2021-04-04 23:21:57 +02:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
- [YouTube](https://www.youtube.com/channel/UCS97tchJDq17Qms3cux8wcA)
|
2021-03-23 03:09:11 +01:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
- [Wiki](https://github.com/ChristianChiarulli/LunarVim/wiki)
|
2021-03-27 01:28:08 +01:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
- [Discord](https://discord.gg/Xb9B4Ny)
|
2021-03-22 01:59:02 +01:00
|
|
|
|
2021-07-03 02:58:53 +02:00
|
|
|
- [Twitter](https://twitter.com/chrisatmachine)
|
2021-06-30 20:28:26 +02:00
|
|
|
|
2021-07-05 21:32:45 +02:00
|
|
|
## Testimonials
|
|
|
|
|
|
|
|
> "I have the processing power of a potato with 4 gb of ram and LunarVim runs perfectly."
|
|
|
|
> - @juanCortelezzi, LunarVim user.
|
2021-06-30 20:28:26 +02:00
|
|
|
|
2021-07-14 03:13:55 +02:00
|
|
|
> "My minimal config with a good amount less code than LunarVim loads 40ms slower. Time to switch."
|
|
|
|
> - @mvllow, Potential LunarVim user.
|
|
|
|
|
|
|
|
<div align="center" id="madewithlua">
|
2021-07-06 15:50:53 +02:00
|
|
|
|
2021-07-14 03:13:55 +02:00
|
|
|
[![Lua](https://img.shields.io/badge/Made%20with%20Lua-blue.svg?style=for-the-badge&logo=lua)](#madewithlua)
|
2021-07-06 15:50:53 +02:00
|
|
|
|
|
|
|
</div>
|