mirror of https://github.com/NvChad/NvChad.git synced 2024-11-06 15:20:25 +00:00

An attempt to make neovim cli functional like an IDE while being very beautiful, blazing fast startuptime ~ 20ms to 70ms

chad charity dotfiles foss ide lua neovim neovim-config neovim-configuration neovim-dotfiles neovim-lua neovim-setup nvim nvim-configs rice ricing telescope vim vimrc vscode

Go to file

Kyle 62fc276f8c add: plugin developers to support section		2021-09-07 16:18:40 +05:30
.github	format on pushes only not PR's.	2021-08-27 14:09:02 +05:30
lua	fix lazyloading for autosave.nvim	2021-09-07 15:18:33 +05:30
.gitignore	Added .gitignore and lazy load lsp_signature more (#218 )	2021-08-07 15:24:31 +05:30
.stylua.toml	chore: stylua formatting update (#261 )	2021-08-16 13:19:09 +05:30
init.lua	Restructure config \| Move some to a packer plugin \| Lot of cleanup	2021-08-22 17:54:10 +05:30
LICENSE	Initial commit	2021-03-07 20:03:18 +05:30
README.md	add: plugin developers to support section	2021-09-07 16:18:40 +05:30

README.md

NvChad

Home • Install • Contribute • Support • Extras

Showcase

Theme Showcase (Click to expand!)

Very useful plugins used

Nvim-tree.lua

Fast file tree:

Telescope-nvim

A fuzzy file finder, picker, sorter, previewer and much more:

Indent-blankline.nvim

Adds indentline:

Feline.nvim

Highly configurable statusline plugin:

Nvim-bufferline.lua

Better tab implementation:

Nvim-web-devicons

Lua fork of Vim Devicons which offers more file icon customisability:

Nvim-treesitter

Better syntax highlighting for programming languages (NvChad by default comes with Lua/bash treesitter parsers).

Without/with Treesitter:

Credits

Elianiva helped me with NeoVim Lua related issues many times, NvChad wouldnt exist without his help at all.
@lorvethe for making the beautiful NvChad logo.

Features

Many beautiful themes to choose from.
Distraction free modes.
Fast plugin loading.
Smooth scrolling.
Autosaving.
File navigation with nvim-tree.lua.
Managing tabs, buffers with bufferline.nvim.
Beautiful and configurable icons with nvim-web-devicons.
Pretty and functional statusline with feline.nvim.
Git diffs and more with gitsigns.nvim .
NeoVim Lisp configuration with nvim-lspconfig.
Easy Lisp server installation with nvim-lspinstall.
Autocompletion with nvim-cmp.
File searching, previewing image and text files and more with telescope.nvim.
Syntax highlighting with nvim-treesitter.
Autoclosing braces and html tags with nvim-autopairs.
Formatting code with neoformat.
Indentlines with indent-blankline.nvim.
Useful snippets with LuaSnip.

Bloat

To everyone who thinks that NvChad is bloat: Bloat means different things to everyone.

NvChad has 38 plugins installed by default yet it is still very fast because it uses Packer plugin maanager. Packer.nvim allows you lets you lazy load plugins, meaning they get loaded only when absoloutely required. Furthermore, you can disable plugins you don't use in chardrc.lua.

TODO

NvChad is focusing more on improving its already existing plugins and features instead of adding more plugins. Things you can do to help currently are:

Improving base plugins configurations
Debloating the config.
Adding more themes.

Try NvChad in a Docker container

This will leave your current Neovim configuration untouched. Once you exit Neovim, the image is deleted.

  docker run -w /root -it --rm alpine:edge sh -uelic '
    apk add git nodejs neovim ripgrep alpine-sdk --update
    git clone https://github.com/NvChad/NvChad ~/.config/nvim
    nvim -c "autocmd User PackerComplete quitall" -c "PackerSync"
    nvim
    '

Chadributors

Warning

If you have an issue with a plugin in NvChad, first you should report it to NvChad to see if it's an issue with it.

💝 Support

If you want to donate, I (siduck76) would direct you to one of the donation links below, since NvChad wouldn't have been able without all of its great contributors and plugin developers, I don't feel comfortable taking donations for myself, so donate to one of these charities instead: