Neovim config for the lazy
Find a file
dunix241 600f7e03b0 feat(keymaps): allow more dynamic keymaps structure for ease of modularization
This commit is for encouraging modularization and facilitate ease of use

**Simplify Keymap Configuration**

Previously, users had to specify the entire keymap structure to modify
key mappings. For example:

```lua
{
  keymaps = {
    window = {
      window_left = "keys1",
      window_lower = "keys2"
    },
    resize_window = {
      size_increase_height = "keys3"
    }
  },
}
```

Now, users can still specify the structure for better organization, but
they can directly specify the key mappings without needing to follow the
nested structure. The new approach allows for more flexibility and
simplicity:

```lua
{
  window_left = "keys1",
  size_increase_height = "keys3"
}
```

Additionally, users can group keys into tables for better organization
if desired:

```lua
{
  {
    window_left = "keys1",
    window_lower = "keys2"
  }
}
```

This change ensures that only the `keys = "keys"` mappings matter,
making the configuration process more straightforward and user-friendly.
2024-11-01 13:43:53 +07:00
.github chore(main): release 12.43.0 (#4630) 2024-10-23 11:55:48 +02:00
doc chore(build): auto-generate docs 2024-10-24 05:59:11 +00:00
lua/lazyvim feat(keymaps): allow more dynamic keymaps structure for ease of modularization 2024-11-01 13:43:53 +07:00
queries/lua feat(lua): added LazyVim as a treesitter builtin 2024-05-15 15:31:08 +02:00
scripts chore(update): update repository (#4009) 2024-07-13 10:07:07 +02:00
tests fix(lazygit): improve git browse (#3941) 2024-07-07 21:25:45 +02:00
.editorconfig chore(update): update repository (#4054) 2024-07-15 17:09:19 +02:00
.gitignore ci: update 2024-07-06 23:45:22 +02:00
.neoconf.json build: neoconf sumneko_lua => lua_ls 2023-03-04 10:41:52 +01:00
CHANGELOG.md chore(main): release 12.43.0 (#4630) 2024-10-23 11:55:48 +02:00
CONTRIBUTING.md docs: added experience to CONTRIBUTING 2024-06-10 23:26:07 +02:00
init.lua feat(init)!: disable init.lua and show a message on how to use LazyVim 2023-01-07 11:44:40 +01:00
LICENSE docs: added LICENSE 2023-01-01 09:48:09 +01:00
NEWS.md feat(markdown): replace headlines.nvim by markdown.nvim (#4139) 2024-07-24 08:02:56 +02:00
README-CN.md docs: add link to LazyVim For Ambitious Developers to README-CN.md (#3644) 2024-06-14 18:04:53 +02:00
README-DE.md docs: readme should be unix format. Fixes #3247 2024-05-20 00:13:18 +02:00
README-JP.md docs: Added Japanese Translation of the README (#2232) 2024-06-05 15:22:50 +02:00
README-KO.md docs: add the Korean version of README (#2495) 2024-06-05 15:22:30 +02:00
README-PT.md docs(pt): add readme in portuguese (#1958) 2024-06-05 15:23:09 +02:00
README.md feat(docs): add link to LazyVim For Ambitious Developers to README (#3504) 2024-06-06 18:54:02 +02:00
selene.toml ci: update 2024-07-05 15:31:26 +02:00
stylua.toml build(format): sort requires 2023-10-09 11:34:23 +02:00
vim.toml ci: update 2024-07-05 15:31:26 +02:00


Install · Configure · Docs

LazyVim is a Neovim setup powered by 💤 lazy.nvim to make it easy to customize and extend your config. Rather than having to choose between starting from scratch or using a pre-made distro, LazyVim offers the best of both worlds - the flexibility to tweak your config as needed, along with the convenience of a pre-configured setup.

image

image

Features

  • 🔥 Transform your Neovim into a full-fledged IDE
  • 💤 Easily customize and extend your config with lazy.nvim
  • 🚀 Blazingly fast
  • 🧹 Sane default settings for options, autocmds, and keymaps
  • 📦 Comes with a wealth of plugins pre-configured and ready to use

Requirements

  • Neovim >= 0.9.0 (needs to be built with LuaJIT)
  • Git >= 2.19.0 (for partial clones support)
  • a Nerd Font (optional)
  • a C compiler for nvim-treesitter. See here

🚀 Getting Started

You can find a starter template for LazyVim here

Try it with Docker
docker run -w /root -it --rm alpine:edge sh -uelic '
  apk add git lazygit neovim ripgrep alpine-sdk --update
  git clone https://github.com/LazyVim/starter ~/.config/nvim
  cd ~/.config/nvim
  nvim
'
Install the LazyVim Starter
  • Make a backup of your current Neovim files:

    mv ~/.config/nvim ~/.config/nvim.bak
    mv ~/.local/share/nvim ~/.local/share/nvim.bak
    
  • Clone the starter

    git clone https://github.com/LazyVim/starter ~/.config/nvim
    
  • Remove the .git folder, so you can add it to your own repo later

    rm -rf ~/.config/nvim/.git
    
  • Start Neovim!

    nvim
    

    Refer to the comments in the files on how to customize LazyVim.


There's a great video created by @elijahmanor with a walkthrough to get started.

Watch the video

@dusty-phillips is working on a book called LazyVim for Ambitious Developers available for free online.

📂 File Structure

The files under config will be automatically loaded at the appropriate time, so you don't need to require those files manually. LazyVim comes with a set of default config files that will be loaded before your own. See here

You can add your custom plugin specs under lua/plugins/. All files there will be automatically loaded by lazy.nvim

~/.config/nvim
├── lua
│   ├── config
│   │   ├── autocmds.lua
│   │   ├── keymaps.lua
│   │   ├── lazy.lua
│   │   └── options.lua
│   └── plugins
│       ├── spec1.lua
│       ├── **
│       └── spec2.lua
└── init.lua

⚙️ Configuration

Refer to the docs