Go to file

siduck 63651e90e6 Update README.md		2022-05-13 01:29:49 +05:30
.github	Update README.md	2022-05-13 01:29:49 +05:30
examples	breaking change : re-implement custom mappings \| simplify it \| add whichkey	2022-05-12 18:26:01 +05:30
lua	clean up	2022-05-12 19:27:11 +05:30
.gitignore	chore: add spell directory to gitignore	2022-01-08 07:06:04 +05:30
.stylua.toml	chore: stylua formatting update (#261 )	2021-08-16 13:19:09 +05:30
LICENSE	Initial commit	2021-03-07 20:03:18 +05:30
init.lua	breaking change : re-implement custom mappings \| simplify it \| add whichkey	2022-05-12 18:26:01 +05:30

.github/README.md

NvChad

Home • Install • Contribute • Support • Extras

Showcase

( Zoom in the screenshot )

What is it?

NvChad is a neovim config written in lua aiming to provide a base configuration with very beautiful UI and blazing fast startuptime (around 0.02 secs ~ 0.07 secs). We tweak UI plugins such as telescope, nvim-tree, bufferline etc well to provide an asethetic UI experience.
Lazy loading is done 93% of the time meaning that plugins will not be loaded by default, they will be loaded only when required also at specific commands, events etc. This lowers the startuptime and it was like 0.07~ secs tested on an old pentium machine 1.4ghz + 4gb ram & HDD.
NvChad isnt a framework! Its supposed to be used as a "base" config, so users could tweak the defaults well, can also remove the things they dont like in the default config and build their config on top of it. Users can tweak the entire default config while staying in their custom config (lua/custom dir). This is the control center of the user's config and gitignored so the users can stay update to-date with NvChad's latest config (main branch) while still controlling it with their chadrc (file that controls entire custom dir)

Theme Showcase

Images (Click to expand!)

(Note: these are just 4-5 themes, NvChad has around 27+ themes)

Images (Click to expand!)

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:

Plugins list

Many beautiful themes, theme toggler by our base46 plugin
Inbuilt terminal toggling & management with Nvterm
NvChad updater, hide & unhide terminal buffers with NvChad extensions
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 Lsp configuration with nvim-lspconfig and lsp-installer
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
Indentlines with indent-blankline.nvim
Useful snippets with friendly snippets + LuaSnip.
Popup mappings keysheet whichkey.nvim

History

I (@siduck i.e creator of NvChad) in my initial days of learning to program wanted a lightweight IDE for writing code, I had a very low end system, which was like 1.4ghz pentium + 4gb ram & HDD. I was into web dev so many suggested vscode but that thing was very heavy on my system, It took more ram than my browser! ( minimal ungoogled chromium ) so I never tried it again, sublime text was nice but the fear of using proprietary software XD for a linux user bugged me a lot. Then I tried doom-emacs which looked pretty but it was slow and emacs was kinda hard, I tried lunarvim but too lazy to read the docs which got me into vim and got into neovim lua stuff real quick. I wanted to make the config ery pretty and fast.
I'm decent at ricing i.e customizing system and making it look pretty so I posted my neovim rice on neovim subreddit, my neovim-dotfiles github repo blew up and then I had to come up with a name, I was amazed by the chad meme lol so I put NvChad as the name, the chad word in the name doesnt literally mean the chad guy but in the sense such as chad linux vs windows i.e meaning superior,best etc. NvChad was made for my personal use but it gained some popularity which inspired me to make a public config i.e config usable by many and less hassle to update, without the custom config stuff users would have to keep a track of every commit and copy paste git diffs to manually update nvchad.

💝 Support

I'm (@siduck) really very sorry to remove the previous charity links but I had to do it for various reasons. A lot has been going here regarding financial issues and I do need some support if it's possible from your end. I haven't graduated yet and it would be great to earn some stuff as that'd help me with daily minor expenses. If you like NvChad and would like to support it via donation then I'll gladly accept it. Dont worry! NvChad will still stay alive & active without your donations! I will remove the sponsor button and re-add the charity links once I get a job, probably a year or two.

Credits

Elianiva helped me with NeoVim Lua related issues many times, NvChad wouldn't exist without his help at all as he helped me in my initial neovim journey!
@lorvethe for making the beautiful NvChad logo.