Home

Awesome

<div align="center"> <img src="https://user-images.githubusercontent.com/292349/213446185-2db63fd5-8c84-459c-9f04-e286382d6e80.png"> </div> <hr> <h4 align="center"> <a href="https://lazyvim.github.io/installation">Install</a> ยท <a href="https://lazyvim.github.io/configuration">Configure</a> ยท <a href="https://lazyvim.github.io">Docs</a> </h4> <div align="center"><p> <a href="https://github.com/LazyVim/LazyVim/releases/latest"> <img alt="Latest release" src="https://img.shields.io/github/v/release/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=C9CBFF&logoColor=D9E0EE&labelColor=302D41&include_prerelease&sort=semver" /> </a> <a href="https://github.com/LazyVim/LazyVim/pulse"> <img alt="Last commit" src="https://img.shields.io/github/last-commit/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=8bd5ca&logoColor=D9E0EE&labelColor=302D41"/> </a> <a href="https://github.com/LazyVim/LazyVim/blob/main/LICENSE"> <img alt="License" src="https://img.shields.io/github/license/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=ee999f&logoColor=D9E0EE&labelColor=302D41" /> </a> <a href="https://github.com/LazyVim/LazyVim/stargazers"> <img alt="Stars" src="https://img.shields.io/github/stars/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=c69ff5&logoColor=D9E0EE&labelColor=302D41" /> </a> <a href="https://github.com/LazyVim/LazyVim/issues"> <img alt="Issues" src="https://img.shields.io/github/issues/LazyVim/LazyVim?style=for-the-badge&logo=bilibili&color=F5E0DC&logoColor=D9E0EE&labelColor=302D41" /> </a> <a href="https://github.com/LazyVim/LazyVim"> <img alt="Repo Size" src="https://img.shields.io/github/repo-size/LazyVim/LazyVim?color=%23DDB6F2&label=SIZE&logo=codesandbox&style=for-the-badge&logoColor=D9E0EE&labelColor=302D41" /> </a> <a href="https://twitter.com/intent/follow?screen_name=folke"> <img alt="follow on Twitter" src="https://img.shields.io/twitter/follow/folke?style=for-the-badge&logo=twitter&color=8aadf3&logoColor=D9E0EE&labelColor=302D41" /> </a> </div>

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

โšก๏ธ Requirements

๐Ÿš€ Getting Started

You can find a starter template for LazyVim here

<details><summary>Try it with Docker</summary>
docker run -w /root -it --rm alpine:edge sh -uelic '
  apk add git lazygit fzf curl neovim ripgrep alpine-sdk --update
  git clone https://github.com/LazyVim/starter ~/.config/nvim
  cd ~/.config/nvim
  nvim
'
</details> <details><summary>Install the <a href="https://github.com/LazyVim/starter">LazyVim Starter</a></summary> </details>

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

Watch the video

@dusty-phillips wrote a comprehensive 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

<pre> ~/.config/nvim โ”œโ”€โ”€ lua โ”‚ย ย  โ”œโ”€โ”€ config โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ autocmds.lua โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ keymaps.lua โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ lazy.lua โ”‚ย ย  โ”‚ย ย  โ””โ”€โ”€ options.lua โ”‚ย ย  โ””โ”€โ”€ plugins โ”‚ย ย  โ”œโ”€โ”€ spec1.lua โ”‚ย ย  โ”œโ”€โ”€ ** โ”‚ย ย  โ””โ”€โ”€ spec2.lua โ””โ”€โ”€ init.lua </pre>

โš™๏ธ Configuration

Refer to the docs