https://github.com/musleh0001/neo-vim-config

Last synced: 3 months ago
JSON representation

Host: GitHub
URL: https://github.com/musleh0001/neo-vim-config
Owner: musleh0001
License: gpl-3.0
Created: 2024-12-30T16:42:19.000Z (9 months ago)
Default Branch: main
Last Pushed: 2025-02-07T15:43:22.000Z (8 months ago)
Last Synced: 2025-02-22T10:52:01.043Z (8 months ago)
Language: Lua
Size: 46.9 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: .github/README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

          
NvChad




	Home

   • 

    	Install

   • 

       	Contribute

   • 

	Support

   • 

        Features

  

 



 

[![Neovim Minimum Version](https://img.shields.io/badge/Neovim-0.9.0-blueviolet.svg?style=flat-square&logo=Neovim&color=90E59A&logoColor=white)](https://github.com/neovim/neovim)

[![GitHub Issues](https://img.shields.io/github/issues/NvChad/NvChad.svg?style=flat-square&label=Issues&color=d77982)](https://github.com/NvChad/NvChad/issues)

[![Discord](https://img.shields.io/discord/869557815780470834?color=738adb&label=Discord&logo=discord&logoColor=white&style=flat-square)](https://discord.gg/gADmkJb9Fb)

[![Matrix](https://img.shields.io/badge/Matrix-40aa8b.svg?style=flat-square&logo=Matrix&logoColor=white)](https://matrix.to/#/#nvchad:matrix.org)

[![Telegram](https://img.shields.io/badge/Telegram-blue.svg?style=flat-square&logo=Telegram&logoColor=white)](https://t.me/DE_WM)

  


## Showcase









## 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 aesthetic 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 isn't a framework! It's supposed to be used as a "base" config, so users can tweak the defaults well, and also remove the things they don't 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 up-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!)

![4 themes](https://nvchad.com/screenshots/four_Themes.webp)

![radium 1](https://nvchad.com/screenshots/radium1.webp)

![radium 2](https://nvchad.com/screenshots/radium2.webp)

![radium 3](https://nvchad.com/screenshots/radium3.webp)

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

## UI related plugins used

 Images (Click to expand!)

 Nvim-tree.lua 


Fast file tree:



 Telescope-nvim 


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



 Our own statusline written from scratch  


[NvChad UI](https://github.com/NvChad/ui)



 Tabufline (our own pertab bufferline) 




- Here's a [video](https://www.youtube.com/watch?v=V_9iJ96U_k8&ab_channel=siduck) that showcases it.

 NvCheatsheet ( our UI Plugin ) 

 

## Plugins list

- Many beautiful themes, theme toggler by our [base46 plugin](https://github.com/NvChad/base46)

- Inbuilt terminal toggling & management with [Nvterm](https://github.com/NvChad/nvterm)

- Lightweight & performant ui plugin with [NvChad UI](https://github.com/NvChad/ui) It provides statusline modules, tabufline ( tabs + buffer manager) , beautiful cheatsheets, NvChad updater, hide & unhide terminal buffers, theme switcher and much more!

- File navigation with [nvim-tree.lua](https://github.com/kyazdani42/nvim-tree.lua)

- Beautiful and configurable icons with [nvim-web-devicons](https://github.com/kyazdani42/nvim-web-devicons)

- Git diffs and more with [gitsigns.nvim](https://github.com/lewis6991/gitsigns.nvim) 

- NeoVim Lsp configuration with [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig) and [mason.nvim](https://github.com/williamboman/mason.nvim)

- Autocompletion with [nvim-cmp](https://github.com/hrsh7th/nvim-cmp)

- File searching, previewing image and text files and more with [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim).

- Syntax highlighting with [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter)

- Autoclosing braces and html tags with [nvim-autopairs](https://github.com/windwp/nvim-autopairs)

- Indentlines with [indent-blankline.nvim](https://github.com/lukas-reineke/indent-blankline.nvim)

- Useful snippets with [friendly snippets](https://github.com/rafamadriz/friendly-snippets) + [LuaSnip](https://github.com/L3MON4D3/LuaSnip).

- Popup mappings keysheet [whichkey.nvim](https://github.com/folke/which-key.nvim)