|
1 | | -# kickstart.nvim |
| 1 | +# kickstart.nvim/ |
2 | 2 |
|
3 | | -## Introduction |
| 3 | +<a href="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim"><img src="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim/badges/plugins?style=flat" /></a> |
| 4 | +<a href="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim"><img src="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim/badges/leaderkey?style=flat" /></a> |
| 5 | +<a href="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim"><img src="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim/badges/plugin-manager?style=flat" /></a> |
4 | 6 |
|
5 | | -A starting point for Neovim that is: |
6 | 7 |
|
7 | | -* Small |
8 | | -* Single-file |
9 | | -* Completely Documented |
| 8 | +## Install Instructions |
10 | 9 |
|
11 | | -**NOT** a Neovim distribution, but instead a starting point for your configuration. |
| 10 | + > Install requires Neovim 0.9+. Always review the code before installing a configuration. |
12 | 11 |
|
13 | | -## Installation |
14 | | - |
15 | | -### Install Neovim |
16 | | - |
17 | | -Kickstart.nvim targets *only* the latest |
18 | | -['stable'](https://github.com/neovim/neovim/releases/tag/stable) and latest |
19 | | -['nightly'](https://github.com/neovim/neovim/releases/tag/nightly) of Neovim. |
20 | | -If you are experiencing issues, please make sure you have the latest versions. |
21 | | - |
22 | | -### Install External Dependencies |
23 | | - |
24 | | -External Requirements: |
25 | | -- Basic utils: `git`, `make`, `unzip`, C Compiler (`gcc`) |
26 | | -- [ripgrep](https://github.com/BurntSushi/ripgrep#installation) |
27 | | -- A [Nerd Font](https://www.nerdfonts.com/): optional, provides various icons |
28 | | - - if you have it set `vim.g.have_nerd_font` in `init.lua` to true |
29 | | -- Language Setup: |
30 | | - - If want to write Typescript, you need `npm` |
31 | | - - If want to write Golang, you will need `go` |
32 | | - - etc. |
33 | | - |
34 | | -> **NOTE** |
35 | | -> See [Install Recipes](#Install-Recipes) for additional Windows and Linux specific notes |
36 | | -> and quick install snippets |
37 | | -
|
38 | | -### Install Kickstart |
39 | | - |
40 | | -> **NOTE** |
41 | | -> [Backup](#FAQ) your previous configuration (if any exists) |
42 | | -
|
43 | | -Neovim's configurations are located under the following paths, depending on your OS: |
44 | | - |
45 | | -| OS | PATH | |
46 | | -| :- | :--- | |
47 | | -| Linux, MacOS | `$XDG_CONFIG_HOME/nvim`, `~/.config/nvim` | |
48 | | -| Windows (cmd)| `%userprofile%\AppData\Local\nvim\` | |
49 | | -| Windows (powershell)| `$env:USERPROFILE\AppData\Local\nvim\` | |
50 | | - |
51 | | -#### Recommended Step |
52 | | - |
53 | | -[Fork](https://docs.github.com/en/get-started/quickstart/fork-a-repo) this repo |
54 | | -so that you have your own copy that you can modify, then install by cloning the |
55 | | -fork to your machine using one of the commands below, depending on your OS. |
56 | | - |
57 | | -> **NOTE** |
58 | | -> Your fork's url will be something like this: |
59 | | -> `https://github.com/<your_github_username>/kickstart.nvim.git` |
60 | | -
|
61 | | -#### Clone kickstart.nvim |
62 | | -> **NOTE** |
63 | | -> If following the recommended step above (i.e., forking the repo), replace |
64 | | -> `nvim-lua` with `<your_github_username>` in the commands below |
65 | | -
|
66 | | -<details><summary> Linux and Mac </summary> |
| 12 | +Clone the repository and install the plugins: |
67 | 13 |
|
68 | 14 | ```sh |
69 | | -git clone https://github.com/nvim-lua/kickstart.nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim |
70 | | -``` |
71 | | - |
72 | | -</details> |
73 | | - |
74 | | -<details><summary> Windows </summary> |
75 | | - |
76 | | -If you're using `cmd.exe`: |
77 | | - |
78 | | -``` |
79 | | -git clone https://github.com/nvim-lua/kickstart.nvim.git %userprofile%\AppData\Local\nvim\ |
| 15 | +git clone [email protected]:juanmiguelRuaDev/kickstart.nvim ~/.config/juanmiguelRuaDev/kickstart.nvim |
80 | 16 | ``` |
81 | 17 |
|
82 | | -If you're using `powershell.exe` |
83 | | - |
84 | | -``` |
85 | | -git clone https://github.com/nvim-lua/kickstart.nvim.git $env:USERPROFILE\AppData\Local\nvim\ |
86 | | -``` |
87 | | - |
88 | | -</details> |
89 | | - |
90 | | -### Post Installation |
91 | | - |
92 | | -Start Neovim |
| 18 | +Open Neovim with this config: |
93 | 19 |
|
94 | 20 | ```sh |
95 | | -nvim |
| 21 | +NVIM_APPNAME=juanmiguelRuaDev/kickstart.nvim/ nvim |
96 | 22 | ``` |
97 | 23 |
|
98 | | -That's it! Lazy will install all the plugins you have. Use `:Lazy` to view |
99 | | -current plugin status. Hit `q` to close the window. |
| 24 | +## Plugins |
100 | 25 |
|
101 | | -Read through the `init.lua` file in your configuration folder for more |
102 | | -information about extending and exploring Neovim. That also includes |
103 | | -examples of adding popularly requested plugins. |
| 26 | +### colorscheme |
104 | 27 |
|
| 28 | ++ [catppuccin/nvim](https://dotfyle.com/plugins/catppuccin/nvim) |
| 29 | ++ [folke/tokyonight.nvim](https://dotfyle.com/plugins/folke/tokyonight.nvim) |
| 30 | +### comment |
105 | 31 |
|
106 | | -### Getting Started |
| 32 | ++ [numToStr/Comment.nvim](https://dotfyle.com/plugins/numToStr/Comment.nvim) |
| 33 | ++ [folke/todo-comments.nvim](https://dotfyle.com/plugins/folke/todo-comments.nvim) |
| 34 | +### completion |
107 | 35 |
|
108 | | -[The Only Video You Need to Get Started with Neovim](https://youtu.be/m8C0Cq9Uv9o) |
| 36 | ++ [hrsh7th/nvim-cmp](https://dotfyle.com/plugins/hrsh7th/nvim-cmp) |
| 37 | +### debugging |
109 | 38 |
|
110 | | -### FAQ |
| 39 | ++ [rcarriga/nvim-dap-ui](https://dotfyle.com/plugins/rcarriga/nvim-dap-ui) |
| 40 | ++ [mfussenegger/nvim-dap](https://dotfyle.com/plugins/mfussenegger/nvim-dap) |
| 41 | +### editing-support |
111 | 42 |
|
112 | | -* What should I do if I already have a pre-existing neovim configuration? |
113 | | - * You should back it up and then delete all associated files. |
114 | | - * This includes your existing init.lua and the neovim files in `~/.local` |
115 | | - which can be deleted with `rm -rf ~/.local/share/nvim/` |
116 | | -* Can I keep my existing configuration in parallel to kickstart? |
117 | | - * Yes! You can use [NVIM_APPNAME](https://neovim.io/doc/user/starting.html#%24NVIM_APPNAME)`=nvim-NAME` |
118 | | - to maintain multiple configurations. For example, you can install the kickstart |
119 | | - configuration in `~/.config/nvim-kickstart` and create an alias: |
120 | | - ``` |
121 | | - alias nvim-kickstart='NVIM_APPNAME="nvim-kickstart" nvim' |
122 | | - ``` |
123 | | - When you run Neovim using `nvim-kickstart` alias it will use the alternative |
124 | | - config directory and the matching local directory |
125 | | - `~/.local/share/nvim-kickstart`. You can apply this approach to any Neovim |
126 | | - distribution that you would like to try out. |
127 | | -* What if I want to "uninstall" this configuration: |
128 | | - * See [lazy.nvim uninstall](https://github.com/folke/lazy.nvim#-uninstalling) information |
129 | | -* Why is the kickstart `init.lua` a single file? Wouldn't it make sense to split it into multiple files? |
130 | | - * The main purpose of kickstart is to serve as a teaching tool and a reference |
131 | | - configuration that someone can easily use to `git clone` as a basis for their own. |
132 | | - As you progress in learning Neovim and Lua, you might consider splitting `init.lua` |
133 | | - into smaller parts. A fork of kickstart that does this while maintaining the |
134 | | - same functionality is available here: |
135 | | - * [kickstart-modular.nvim](https://github.com/dam9000/kickstart-modular.nvim) |
136 | | - * Discussions on this topic can be found here: |
137 | | - * [Restructure the configuration](https://github.com/nvim-lua/kickstart.nvim/issues/218) |
138 | | - * [Reorganize init.lua into a multi-file setup](https://github.com/nvim-lua/kickstart.nvim/pull/473) |
| 43 | ++ [windwp/nvim-autopairs](https://dotfyle.com/plugins/windwp/nvim-autopairs) |
| 44 | ++ [nvim-treesitter/nvim-treesitter-context](https://dotfyle.com/plugins/nvim-treesitter/nvim-treesitter-context) |
| 45 | +### file-explorer |
139 | 46 |
|
140 | | -### Install Recipes |
| 47 | ++ [stevearc/oil.nvim](https://dotfyle.com/plugins/stevearc/oil.nvim) |
| 48 | ++ [nvim-neo-tree/neo-tree.nvim](https://dotfyle.com/plugins/nvim-neo-tree/neo-tree.nvim) |
| 49 | +### formatting |
141 | 50 |
|
142 | | -Below you can find OS specific install instructions for Neovim and dependencies. |
| 51 | ++ [stevearc/conform.nvim](https://dotfyle.com/plugins/stevearc/conform.nvim) |
| 52 | +### fuzzy-finder |
143 | 53 |
|
144 | | -After installing all the dependencies continue with the [Install Kickstart](#Install-Kickstart) step. |
| 54 | ++ [nvim-telescope/telescope.nvim](https://dotfyle.com/plugins/nvim-telescope/telescope.nvim) |
| 55 | +### git |
145 | 56 |
|
146 | | -#### Windows Installation |
| 57 | ++ [lewis6991/gitsigns.nvim](https://dotfyle.com/plugins/lewis6991/gitsigns.nvim) |
| 58 | ++ [kdheepak/lazygit.nvim](https://dotfyle.com/plugins/kdheepak/lazygit.nvim) |
| 59 | +### icon |
147 | 60 |
|
148 | | -<details><summary>Windows with Microsoft C++ Build Tools and CMake</summary> |
149 | | -Installation may require installing build tools and updating the run command for `telescope-fzf-native` |
| 61 | ++ [nvim-tree/nvim-web-devicons](https://dotfyle.com/plugins/nvim-tree/nvim-web-devicons) |
| 62 | +### indent |
150 | 63 |
|
151 | | -See `telescope-fzf-native` documentation for [more details](https://github.com/nvim-telescope/telescope-fzf-native.nvim#installation) |
| 64 | ++ [lukas-reineke/indent-blankline.nvim](https://dotfyle.com/plugins/lukas-reineke/indent-blankline.nvim) |
| 65 | +### keybinding |
152 | 66 |
|
153 | | -This requires: |
| 67 | ++ [folke/which-key.nvim](https://dotfyle.com/plugins/folke/which-key.nvim) |
| 68 | +### lsp |
154 | 69 |
|
155 | | -- Install CMake and the Microsoft C++ Build Tools on Windows |
| 70 | ++ [neovim/nvim-lspconfig](https://dotfyle.com/plugins/neovim/nvim-lspconfig) |
| 71 | ++ [j-hui/fidget.nvim](https://dotfyle.com/plugins/j-hui/fidget.nvim) |
| 72 | ++ [mfussenegger/nvim-lint](https://dotfyle.com/plugins/mfussenegger/nvim-lint) |
| 73 | ++ [nvimtools/none-ls.nvim](https://dotfyle.com/plugins/nvimtools/none-ls.nvim) |
| 74 | +### lsp-installer |
156 | 75 |
|
157 | | -```lua |
158 | | -{'nvim-telescope/telescope-fzf-native.nvim', build = 'cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release && cmake --build build --config Release && cmake --install build --prefix build' } |
159 | | -``` |
160 | | -</details> |
161 | | -<details><summary>Windows with gcc/make using chocolatey</summary> |
162 | | -Alternatively, one can install gcc and make which don't require changing the config, |
163 | | -the easiest way is to use choco: |
164 | | - |
165 | | -1. install [chocolatey](https://chocolatey.org/install) |
166 | | -either follow the instructions on the page or use winget, |
167 | | -run in cmd as **admin**: |
168 | | -``` |
169 | | -winget install --accept-source-agreements chocolatey.chocolatey |
170 | | -``` |
| 76 | ++ [williamboman/mason.nvim](https://dotfyle.com/plugins/williamboman/mason.nvim) |
| 77 | +### nvim-dev |
171 | 78 |
|
172 | | -2. install all requirements using choco, exit previous cmd and |
173 | | -open a new one so that choco path is set, and run in cmd as **admin**: |
174 | | -``` |
175 | | -choco install -y neovim git ripgrep wget fd unzip gzip mingw make |
176 | | -``` |
177 | | -</details> |
178 | | -<details><summary>WSL (Windows Subsystem for Linux)</summary> |
| 79 | ++ [MunifTanjim/nui.nvim](https://dotfyle.com/plugins/MunifTanjim/nui.nvim) |
| 80 | ++ [nvim-lua/plenary.nvim](https://dotfyle.com/plugins/nvim-lua/plenary.nvim) |
| 81 | ++ [folke/neodev.nvim](https://dotfyle.com/plugins/folke/neodev.nvim) |
| 82 | +### plugin-manager |
179 | 83 |
|
180 | | -``` |
181 | | -wsl --install |
182 | | -wsl |
183 | | -sudo add-apt-repository ppa:neovim-ppa/unstable -y |
184 | | -sudo apt update |
185 | | -sudo apt install make gcc ripgrep unzip neovim |
186 | | -``` |
187 | | -</details> |
| 84 | ++ [folke/lazy.nvim](https://dotfyle.com/plugins/folke/lazy.nvim) |
| 85 | +### snippet |
188 | 86 |
|
189 | | -#### Linux Install |
190 | | -<details><summary>Ubuntu Install Steps</summary> |
| 87 | ++ [rafamadriz/friendly-snippets](https://dotfyle.com/plugins/rafamadriz/friendly-snippets) |
| 88 | ++ [L3MON4D3/LuaSnip](https://dotfyle.com/plugins/L3MON4D3/LuaSnip) |
| 89 | +### syntax |
191 | 90 |
|
192 | | -``` |
193 | | -sudo add-apt-repository ppa:neovim-ppa/unstable -y |
194 | | -sudo apt update |
195 | | -sudo apt install make gcc ripgrep unzip git neovim |
196 | | -``` |
197 | | -</details> |
198 | | -<details><summary>Debian Install Steps</summary> |
| 91 | ++ [echasnovski/mini.surround](https://dotfyle.com/plugins/echasnovski/mini.surround) |
| 92 | ++ [nvim-treesitter/nvim-treesitter-textobjects](https://dotfyle.com/plugins/nvim-treesitter/nvim-treesitter-textobjects) |
| 93 | ++ [nvim-treesitter/nvim-treesitter](https://dotfyle.com/plugins/nvim-treesitter/nvim-treesitter) |
| 94 | +### tabline |
199 | 95 |
|
200 | | -``` |
201 | | -sudo apt update |
202 | | -sudo apt install make gcc ripgrep unzip git curl |
203 | | -
|
204 | | -# Now we install nvim |
205 | | -curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux64.tar.gz |
206 | | -sudo rm -rf /opt/nvim-linux64 |
207 | | -sudo mkdir -p /opt/nvim-linux64 |
208 | | -sudo chmod a+rX /opt/nvim-linux64 |
209 | | -sudo tar -C /opt -xzf nvim-linux64.tar.gz |
210 | | -
|
211 | | -# make it available in /usr/local/bin, distro installs to /usr/bin |
212 | | -sudo ln -sf /opt/nvim-linux64/bin/nvim /usr/local/bin/ |
213 | | -``` |
214 | | -</details> |
215 | | -<details><summary>Fedora Install Steps</summary> |
| 96 | ++ [akinsho/bufferline.nvim](https://dotfyle.com/plugins/akinsho/bufferline.nvim) |
| 97 | +### utility |
216 | 98 |
|
217 | | -``` |
218 | | -sudo dnf install -y gcc make git ripgrep fd-find unzip neovim |
219 | | -``` |
220 | | -</details> |
| 99 | ++ [echasnovski/mini.nvim](https://dotfyle.com/plugins/echasnovski/mini.nvim) |
| 100 | +## Language Servers |
221 | 101 |
|
222 | | -<details><summary>Arch Install Steps</summary> |
| 102 | ++ html |
| 103 | ++ tflint |
223 | 104 |
|
224 | | -``` |
225 | | -sudo pacman -S --noconfirm --needed gcc make git ripgrep fd unzip neovim |
226 | | -``` |
227 | | -</details> |
228 | 105 |
|
| 106 | + This readme was generated by [Dotfyle](https://dotfyle.com) |
0 commit comments