A launch point for your personal nvim configuration
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Tsanko Tsanev 6127fa2432 Fix typo "documention" into "documentation" (#209) 2 years ago
.github/ISSUE_TEMPLATE minor modifications on the issue template (#244) 2 years ago
doc
lua mason nvim dap 2.0 removed setup_handlers() (#258) 2 years ago
.gitignore
.stylua.toml
LICENSE.md
README.md Fix typo "documention" into "documentation" (#209) 2 years ago
init.lua fix: move the Mason setup time forward from before (#210) 2 years ago

README.md

kickstart.nvim

Introduction

A starting point for Neovim that is:

  • Small
  • Single-file (with examples of moving to multi-file)
  • Documented
  • Modular

This repo is meant to be used as by YOU to begin your Neovim journey; remove the things you don't use and add what you miss.

Distribution Alternatives:

  • LazyVim: A delightful distribution maintained by @folke (the author of lazy.nvim, the package manager used here)

Installation

Kickstart.nvim targets only the latest 'stable' and latest 'nightly' of Neovim. If you are experiencing issues, please make sure you have the latest versions.

  • Backup your previous configuration
  • (Recommended) Fork this repo (so that you have your own copy that you can modify).
  • Clone the kickstart repo into $HOME/.config/nvim/ (Linux/Mac) or ~/AppData/Local/nvim/ (Windows)
    • If you don't want to include it as a git repo, you can just clone it and then move the files to this location
  • Start Neovim (nvim) and allow lazy.nvim to complete installation.
  • Restart Neovim
  • You're ready to go!

Additional system requirements:

  • Make sure to review the readmes of the plugins if you are experiencing errors. In particular:
  • See as well Windows Installation

Configuration And Extension

  • Inside of your fork, feel free to modify any file you like! It's your fork!
  • Then there are two primary configuration options available:
    • Include the lua/kickstart/plugins/* files in your configuration.
    • Add new configuration in lua/custom/plugins/* files, which will be auto sourced using lazy.nvim
      • NOTE: To enable this, you need to uncomment { import = 'custom.plugins' } in your init.lua

You can also merge updates/changes from the repo back into your fork, to keep up-to-date with any changes for the default configuration

Example: Adding an autopairs plugin

In the file: lua/custom/plugins/autopairs.lua, add:

-- File: lua/custom/plugins/autopairs.lua

return {
  "windwp/nvim-autopairs",
  config = function()
    require("nvim-autopairs").setup {}
  end,
}

This will automatically install nvim-autopairs and enable it on startup. For more information, see documentation for lazy.nvim.

Example: Adding a file tree plugin

In the file: lua/custom/plugins/filetree.lua, add:

-- Unless you are still migrating, remove the deprecated commands from v1.x
vim.cmd([[ let g:neo_tree_remove_legacy_commands = 1 ]])

return {
  "nvim-neo-tree/neo-tree.nvim",
  version = "*",
  dependencies = {
    "nvim-lua/plenary.nvim",
    "nvim-tree/nvim-web-devicons", -- not strictly required, but recommended
    "MunifTanjim/nui.nvim",
  },
  config = function ()
    require('neo-tree').setup {}
  end,
}

This will install the tree plugin and add the command :Neotree for you. You can explore the documentation at neo-tree.nvim for more information.

Example: Adding a file to change default options

To change default options, you can add a file in the /after/plugin/ folder (see :help load-plugins) to include your own options, keymaps, autogroups, and more. The following is an example defaults.lua file (located at $HOME/.config/nvim/after/plugin/defaults.lua).

vim.opt.relativenumber = true

vim.keymap.set('n', '<leader>sr', require('telescope.builtin').resume, { desc = '[S]earch [R]esume' })

Contribution

Pull-requests are welcome. The goal of this repo is not to create a Neovim configuration framework, but to offer a starting template that shows, by example, available features in Neovim. Some things that will not be included:

  • Custom language server configuration (null-ls templates)
  • Theming beyond a default colorscheme necessary for LSP highlight groups

Each PR, especially those which increase the line count, should have a description as to why the PR is necessary.

FAQ

  • What should I do if I already have a pre-existing neovim configuration?
    • You should back it up, then delete all files associated with it.
    • This includes your existing init.lua and the neovim files in ~/.local which can be deleted with rm -rf ~/.local/share/nvim/
    • You may also want to look at the migration guide for lazy.nvim
  • What if I want to "uninstall" this configuration:
  • Are there any cool videos about this plugin?

Windows Installation

Installation may require installing build tools, and updating the run command for telescope-fzf-native

See telescope-fzf-native documentation for more details

This requires:

  • Install CMake, and the Microsoft C++ Build Tools on Windows
{'nvim-telescope/telescope-fzf-native.nvim', build = 'cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release && cmake --build build --config Release && cmake --install build --prefix build' }