neovim-confs/.github/README.md

169 lines
7.9 KiB
Markdown
Raw Normal View History

<h1 align="center">NvChad</h1>
2021-06-26 09:03:02 +02:00
<div align="center">
2021-09-26 14:45:34 +02:00
<a href="https://nvchad.github.io/">Home</a>
2021-06-26 09:03:02 +02:00
<span></span>
2021-09-26 14:45:34 +02:00
<a href="https://nvchad.github.io/getting-started/setup">Install</a>
2021-06-26 09:03:02 +02:00
<span></span>
2021-09-26 14:45:34 +02:00
<a href="https://nvchad.github.io/contribute">Contribute</a>
2021-06-26 09:03:02 +02:00
<span></span>
<a href="https://github.com/NvChad/NvChad#gift_heart-support">Support</a>
2021-06-26 09:03:02 +02:00
<span></span>
<a href="https://nvchad.github.io/Extras">Extras</a>
2021-06-26 09:03:02 +02:00
<p></p>
</div>
2021-06-26 09:03:02 +02:00
2021-07-01 17:06:57 +02:00
<div align="center">
[![Super Linter](https://img.shields.io/github/workflow/status/NvChad/NvChad/Super-Linter/main?style=flat-square&logo=github&label=Build&color=8DBBE9)]()
2021-10-30 00:58:10 +02:00
<a href="https://github.com/NvChad/NvChad/blob/main/LICENSE"
2021-06-29 05:22:28 +02:00
><img
src="https://img.shields.io/github/license/NvChad/NvChad?style=flat-square&logo=GNU&label=License&color=df967f"
2021-06-29 05:22:28 +02:00
alt="License"
/>
2022-04-29 18:02:13 +02:00
[![Neovim Minimum Version](https://img.shields.io/badge/Neovim-0.7.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)
2021-07-05 12:00:53 +02:00
</div>
2021-09-04 17:42:39 +02:00
## Showcase
2021-10-29 15:40:52 +02:00
<img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/dashboard-nvim.png"><hr>
<img src="https://cdn.discordapp.com/attachments/610012460828852229/853933487295299584/unknown.png"><hr>
2021-10-29 15:40:52 +02:00
<img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/initialNvim1.png"><hr>
<img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/initialNvim.png"><hr>
2021-03-10 10:05:16 +01:00
2021-09-07 12:34:07 +02:00
## Theme Showcase
2021-09-07 12:34:07 +02:00
<details><summary> <b>Images (Click to expand!)</b></summary>
2021-08-19 21:10:45 +02:00
![onedark](https://user-images.githubusercontent.com/59060246/130129880-59ab1ad5-9aa6-4f50-9ddd-d8dde0c16257.png)
![nord](https://user-images.githubusercontent.com/59060246/130129890-c01117df-ac3d-40dd-b95d-2681c2461bb4.png)
![gruvchad](https://user-images.githubusercontent.com/59060246/130129897-a68b1585-f42d-4325-8482-102dd2fe1e9e.png)
![everforest](https://user-images.githubusercontent.com/59060246/130129901-5e582f3e-b776-4d0c-9790-be5ae738b5a8.png)
</details>
2021-09-04 17:42:39 +02:00
## Very useful plugins used
2021-09-07 12:34:07 +02:00
<details><summary> <b>Images (Click to expand!)</b></summary>
<h3> Nvim-tree.lua </h3>
2021-09-04 17:42:39 +02:00
Fast file tree:
2021-10-29 15:40:52 +02:00
<kbd><img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/nvimtree.png"></kbd><hr>
2021-03-13 09:04:10 +01:00
2021-09-07 12:34:07 +02:00
<h3> Telescope-nvim </h3>
A fuzzy file finder, picker, sorter, previewer and much more:
2021-10-29 15:40:52 +02:00
<kbd><img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/tel.png"></kbd>
2021-09-07 12:34:07 +02:00
<h3> Indent-blankline.nvim </h3>
Adds indentline:
2021-10-29 15:40:52 +02:00
<kbd><img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/blanklineNvim.png"></kbd><hr>
2021-03-13 09:04:10 +01:00
2021-09-07 12:34:07 +02:00
<h3> Feline.nvim </h3>
2021-09-04 13:37:36 +02:00
Highly configurable statusline plugin:
2021-10-29 15:40:52 +02:00
<kbd><img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/statusline.png"></kbd><hr>
2021-09-07 12:34:07 +02:00
<h3> Nvim-bufferline.lua </h3>
Better tab implementation:
2021-10-29 15:40:52 +02:00
<kbd><img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/bufferline.png"></kbd><hr>
2021-09-07 12:34:07 +02:00
<h3> Nvim-web-devicons </h3>
2021-06-26 09:03:02 +02:00
Lua fork of Vim Devicons which offers more file icon customisability:
2021-10-29 15:40:52 +02:00
<kbd><img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/image.png"></kbd><hr>
2021-06-26 09:03:02 +02:00
2021-09-07 12:34:07 +02:00
<h3> Nvim-treesitter </h3
2021-06-26 09:03:02 +02:00
Better syntax highlighting for programming languages (NvChad by default comes with Lua/bash treesitter parsers).
Without/with Treesitter:
2021-03-13 04:05:22 +01:00
2021-10-29 15:40:52 +02:00
<kbd><img src="https://raw.githubusercontent.com/siduck/dotfiles/all/rice%20flex/woTree.png"></kbd><hr>
2021-09-07 12:34:07 +02:00
</details>
## Credits
2021-06-26 14:21:11 +02:00
2022-01-03 22:28:09 +01:00
- [Elianiva](https://github.com/elianiva) helped me with NeoVim Lua related issues many times, NvChad wouldn't exist without his help at all.
- @lorvethe for making the beautiful NvChad logo.
2021-06-26 14:21:11 +02:00
2021-09-04 17:42:39 +02:00
## Features
- Many beautiful themes to choose from.
- Fast plugin loading.
- File navigation with [nvim-tree.lua](https://github.com/kyazdani42/nvim-tree.lua).
- Managing tabs, buffers with [bufferline.nvim](https://github.com/akinsho/bufferline.nvim).
- Beautiful and configurable icons with [nvim-web-devicons](https://github.com/kyazdani42/nvim-web-devicons).
- Pretty and functional statusline with [feline.nvim](https://github.com/Famiu/feline.nvim).
- Git diffs and more with [gitsigns.nvim](https://github.com/lewis6991/gitsigns.nvim) .
2021-09-10 17:34:18 +02:00
- NeoVim Lsp configuration with [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig).
- 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 [LuaSnip](https://github.com/L3MON4D3/LuaSnip).
## Bloat
To everyone who thinks that NvChad is bloat: Bloat means different things to everyone.
2022-02-21 15:50:39 +01:00
NvChad has 38 plugins installed by default, yet it is still very fast because it uses the Packer plugin manager. Packer.nvim allows you to lazy load plugins, meaning they only get loaded when absolutely required. Furthermore, you can disable plugins you don't use in `chadrc.lua`.
2021-07-14 03:24:14 +02:00
<img src = "https://chadpaste.com/f/kdmxdabxbk.png">
# 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:
2021-06-15 20:09:40 +02:00
- 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.
```zsh
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
2021-08-14 12:42:44 +02:00
<a href="https://github.com/NvChad/NvChad/graphs/contributors">
2021-10-30 01:00:03 +02:00
<img src="https://contrib.rocks/image?repo=NvChad/NvChad"/>
2021-08-14 12:42:44 +02:00
</a>
## Warning
2021-06-15 20:09:40 +02:00
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.
## :gift_heart: Support
2022-05-04 13:52:18 +02:00
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.
[![kofi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/siduck)
[![paypal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/siduck76)
[![buymeacoffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://www.buymeacoffee.com/siduck)
[![patreon](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge&logo=patreon&logoColor=white)](https://www.patreon.com/siduck)