Something went wrong. Try again.
User-specific application configuration is traditionally stored in so called dotfiles, these are my own.
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941-- https://github.com/nvim-lua/kickstart.nvim
-- ============================================================-- SECTION 1: OPTIONS-- Core Neovim settings, leaders, options-- ============================================================do -- Enable faster startup by caching compiled Lua modules vim.loader.enable()
-- Set <space> as the leader key -- See `:help mapleader` -- NOTE: Must happen before plugins are loaded (otherwise wrong leader will be used) vim.g.mapleader = ' ' vim.g.maplocalleader = ' '
-- Ghostty bundles Nerd Font icons as fallbacks, regardless of configured font vim.g.have_nerd_font = true
-- Make line numbers default vim.o.number = true -- You can also add relative line numbers, to help with jumping. vim.o.relativenumber = true
-- Enable mouse mode, can be useful for resizing splits for example! vim.o.mouse = 'a'
-- Don't show the mode, since it's already in the status line vim.o.showmode = false
-- Sync clipboard between OS and Neovim. -- Schedule the setting after `UiEnter` because it can increase startup-time. -- Remove this option if you want your OS clipboard to remain independent. -- See `:help 'clipboard'` vim.schedule(function() vim.o.clipboard = 'unnamedplus' end)
-- Enable break indent vim.o.breakindent = true
-- Enable undo/redo changes even after closing and reopening a file vim.o.undofile = true
-- Case-insensitive searching UNLESS \C or one or more capital letters in the search term vim.o.ignorecase = true vim.o.smartcase = true
-- Keep signcolumn on by default vim.o.signcolumn = 'yes'
-- Decrease update time vim.o.updatetime = 250
-- Decrease mapped sequence wait time vim.o.timeoutlen = 300
-- Configure how new splits should be opened vim.o.splitright = true vim.o.splitbelow = true
-- Sets how neovim will display certain whitespace characters in the editor. -- See `:help 'list'` -- and `:help 'listchars'` -- -- Notice listchars is set using `vim.opt` instead of `vim.o`. -- It is very similar to `vim.o` but offers an interface for conveniently interacting with tables. -- See `:help lua-options` -- and `:help lua-guide-options` vim.o.list = true vim.opt.listchars = { tab = '» ', trail = '·', nbsp = '␣' }
-- Preview substitutions live, as you type! vim.o.inccommand = 'split'
-- Show which line your cursor is on vim.o.cursorline = true
-- Minimal number of screen lines to keep above and below the cursor. vim.o.scrolloff = 10
-- if performing an operation that would fail due to unsaved changes in the buffer (like `:q`), -- instead raise a dialog asking if you wish to save the current file(s) -- See `:help 'confirm'` vim.o.confirm = trueend
-- ============================================================-- SECTION 2: KEYMAPS & AUTOCMDS-- basic keymaps, basic autocmds-- ============================================================do -- [[ Basic Keymaps ]] -- See `:help vim.keymap.set()`
-- Clear highlights on search when pressing <Esc> in normal mode -- See `:help hlsearch` vim.keymap.set('n', '<Esc>', '<cmd>nohlsearch<CR>')
-- Diagnostic Config & Keymaps -- See `:help vim.diagnostic.Opts` vim.diagnostic.config { update_in_insert = false, severity_sort = true, float = { border = 'rounded', source = 'if_many' }, underline = { severity = { min = vim.diagnostic.severity.WARN } },
-- Can switch between these as you prefer virtual_text = true, -- Text shows up at the end of the line virtual_lines = false, -- Text shows up underneath the line, with virtual lines
-- Auto open the float, so you can easily read the errors when jumping with `[d` and `]d` jump = { on_jump = function(_, bufnr) vim.diagnostic.open_float { bufnr = bufnr, scope = 'cursor', focus = false, } end, }, }
vim.keymap.set('n', '<leader>q', vim.diagnostic.setloclist, { desc = 'Open diagnostic [Q]uickfix list' })
-- Exit terminal mode in the builtin terminal with a shortcut that is a bit easier -- for people to discover. Otherwise, you normally need to press <C-\><C-n>, which -- is not what someone will guess without a bit more experience. -- -- NOTE: This won't work in all terminal emulators/tmux/etc. Try your own mapping -- or just use <C-\><C-n> to exit terminal mode vim.keymap.set('t', '<Esc><Esc>', '<C-\\><C-n>', { desc = 'Exit terminal mode' })
-- TIP: Disable arrow keys in normal mode -- vim.keymap.set('n', '<left>', '<cmd>echo "Use h to move!!"<CR>') -- vim.keymap.set('n', '<right>', '<cmd>echo "Use l to move!!"<CR>') -- vim.keymap.set('n', '<up>', '<cmd>echo "Use k to move!!"<CR>') -- vim.keymap.set('n', '<down>', '<cmd>echo "Use j to move!!"<CR>')
-- Keybinds to make split navigation easier. -- Use CTRL+<hjkl> to switch between windows -- -- See `:help wincmd` for a list of all window commands vim.keymap.set('n', '<C-h>', '<C-w><C-h>', { desc = 'Move focus to the left window' }) vim.keymap.set('n', '<C-l>', '<C-w><C-l>', { desc = 'Move focus to the right window' }) vim.keymap.set('n', '<C-j>', '<C-w><C-j>', { desc = 'Move focus to the lower window' }) vim.keymap.set('n', '<C-k>', '<C-w><C-k>', { desc = 'Move focus to the upper window' })
-- NOTE: Some terminals have colliding keymaps or are not able to send distinct keycodes -- vim.keymap.set("n", "<C-S-h>", "<C-w>H", { desc = "Move window to the left" }) -- vim.keymap.set("n", "<C-S-l>", "<C-w>L", { desc = "Move window to the right" }) -- vim.keymap.set("n", "<C-S-j>", "<C-w>J", { desc = "Move window to the lower" }) -- vim.keymap.set("n", "<C-S-k>", "<C-w>K", { desc = "Move window to the upper" })
-- [[ Basic Autocommands ]] -- See `:help lua-guide-autocommands`
-- Highlight when yanking (copying) text -- Try it with `yap` in normal mode -- See `:help vim.hl.on_yank()` vim.api.nvim_create_autocmd('TextYankPost', { desc = 'Highlight when yanking (copying) text', group = vim.api.nvim_create_augroup('kickstart-highlight-yank', { clear = true }), callback = function() vim.hl.on_yank() end, })end
-- ============================================================-- SECTION 3: PLUGIN MANAGER INTRO-- vim.pack intro, build hooks-- ============================================================do -- [[ Intro to `vim.pack` ]] -- `vim.pack` is a new plugin manager built into Neovim, -- which provides a Lua interface for installing and managing plugins. -- -- See `:help vim.pack`, `:help vim.pack-examples` or the -- excellent blog post from the creator of vim.pack and mini.nvim: -- https://echasnovski.com/blog/2026-03-13-a-guide-to-vim-pack -- -- To inspect plugin state and pending updates, run -- :lua vim.pack.update(nil, { offline = true }) -- -- To update plugins, run -- :lua vim.pack.update() -- -- -- Throughout the rest of the config there will be examples -- of how to install and configure plugins using `vim.pack`. -- -- In this section we set up some autocommands to run build -- steps for certain plugins after they are installed or updated.
local function run_build(name, cmd, cwd) local result = vim.system(cmd, { cwd = cwd }):wait() if result.code ~= 0 then local stderr = result.stderr or '' local stdout = result.stdout or '' local output = stderr ~= '' and stderr or stdout if output == '' then output = 'No output from build command.' end vim.notify(('Build failed for %s:\n%s'):format(name, output), vim.log.levels.ERROR) end end
-- This autocommand runs after a plugin is installed or updated and -- runs the appropriate build command for that plugin if necessary. -- -- See `:help vim.pack-events` vim.api.nvim_create_autocmd('PackChanged', { callback = function(ev) local name = ev.data.spec.name local kind = ev.data.kind if kind ~= 'install' and kind ~= 'update' then return end
if name == 'telescope-fzf-native.nvim' and vim.fn.executable 'make' == 1 then run_build(name, { 'make' }, ev.data.path) return end
if name == 'LuaSnip' then if vim.fn.has 'win32' ~= 1 and vim.fn.executable 'make' == 1 then run_build(name, { 'make', 'install_jsregexp' }, ev.data.path) end return end
if name == 'nvim-treesitter' then if not ev.data.active then vim.cmd.packadd 'nvim-treesitter' end vim.cmd 'TSUpdate' return end end, })end
--- Because most plugins are hosted on GitHub, you can use the helper--- function to have less repetition in the following sections.---@param repo string---@return stringlocal function gh(repo) return 'https://github.com/' .. repo end
-- ============================================================-- SECTION 4: UI / CORE UX PLUGINS-- guess-indent, gitsigns, which-key, colorscheme, todo-comments, mini modules-- ============================================================do -- [[ Installing and Configuring Plugins ]] -- -- To install a plugin simply call `vim.pack.add` with its git url. -- This will download the default branch of the plugin, which will usually be `main` or `master` -- You can also have more advanced specs, which we will talk about later. -- -- For most plugins its not enough to install them, you also need to call their `.setup()` to start them. -- -- For example, lets say we want to install `guess-indent.nvim` - a plugin for -- automatically detecting and setting the indentation. -- -- We first install it from https://github.com/NMAC427/guess-indent.nvim -- and then call its `setup()` function to start it with default settings. vim.pack.add { gh 'NMAC427/guess-indent.nvim' } require('guess-indent').setup {}
-- Here is a more advanced configuration example that passes options to `gitsigns.nvim` -- -- See `:help gitsigns` to understand what each configuration key does. -- Adds git related signs to the gutter, as well as utilities for managing changes vim.pack.add { gh 'lewis6991/gitsigns.nvim' } local gitsigns = require 'gitsigns' gitsigns.setup { signs = { add = { text = '+' }, ---@diagnostic disable-line: missing-fields change = { text = '~' }, ---@diagnostic disable-line: missing-fields delete = { text = '_' }, ---@diagnostic disable-line: missing-fields topdelete = { text = '‾' }, ---@diagnostic disable-line: missing-fields changedelete = { text = '~' }, ---@diagnostic disable-line: missing-fields }, -- gitsigns.nvim's recommended keymaps: on_attach = function(bufnr) -- Navigation vim.keymap.set('n', ']c', function() if vim.wo.diff then vim.cmd.normal { ']c', bang = true } else gitsigns.nav_hunk 'next' end end, { desc = 'Jump to next git [c]hange', buf = bufnr })
vim.keymap.set('n', '[c', function() if vim.wo.diff then vim.cmd.normal { '[c', bang = true } else gitsigns.nav_hunk 'prev' end end, { desc = 'Jump to previous git [c]hange', buf = bufnr })
-- Visual mode actions vim.keymap.set('v', '<leader>hs', function() gitsigns.stage_hunk { vim.fn.line '.', vim.fn.line 'v' } end, { desc = 'git [s]tage hunk', buf = bufnr }) vim.keymap.set('v', '<leader>hr', function() gitsigns.reset_hunk { vim.fn.line '.', vim.fn.line 'v' } end, { desc = 'git [r]eset hunk', buf = bufnr }) -- Normal mode actions vim.keymap.set('n', '<leader>hs', gitsigns.stage_hunk, { desc = 'git [s]tage hunk', buf = bufnr }) vim.keymap.set('n', '<leader>hr', gitsigns.reset_hunk, { desc = 'git [r]eset hunk', buf = bufnr }) vim.keymap.set('n', '<leader>hS', gitsigns.stage_buffer, { desc = 'git [S]tage buffer', buf = bufnr }) vim.keymap.set('n', '<leader>hR', gitsigns.reset_buffer, { desc = 'git [R]eset buffer', buf = bufnr }) vim.keymap.set('n', '<leader>hp', gitsigns.preview_hunk, { desc = 'git [p]review hunk', buf = bufnr }) vim.keymap.set('n', '<leader>hi', gitsigns.preview_hunk_inline, { desc = 'git preview hunk [i]nline', buf = bufnr }) vim.keymap.set('n', '<leader>hb', function() gitsigns.blame_line { full = true } end, { desc = 'git [b]lame line', buf = bufnr }) vim.keymap.set('n', '<leader>hd', gitsigns.diffthis, { desc = 'git [d]iff against index', buf = bufnr }) vim.keymap.set('n', '<leader>hD', function() gitsigns.diffthis '~' end, { desc = 'git [D]iff against last commit', buf = bufnr }) vim.keymap.set('n', '<leader>hQ', function() gitsigns.setqflist 'all' end, { desc = 'git hunk [Q]uickfix list (all files in repo)', buf = bufnr }) vim.keymap.set('n', '<leader>hq', gitsigns.setqflist, { desc = 'git hunk [q]uickfix list (all changes in this file)', buf = bufnr }) -- Toggles vim.keymap.set('n', '<leader>tb', gitsigns.toggle_current_line_blame, { desc = '[T]oggle git show [b]lame line', buf = bufnr }) vim.keymap.set('n', '<leader>tw', gitsigns.toggle_word_diff, { desc = '[T]oggle git intra-line [w]ord diff', buf = bufnr }) -- Text object vim.keymap.set({ 'o', 'x' }, 'ih', gitsigns.select_hunk, { desc = 'text object [i]nside [h]unk', buf = bufnr }) end, }
-- Useful plugin to show you pending keybinds. vim.pack.add { gh 'folke/which-key.nvim' } require('which-key').setup { -- Delay between pressing a key and opening which-key (milliseconds) delay = 0, icons = { mappings = vim.g.have_nerd_font }, -- Document existing key chains spec = { { '<leader>s', group = '[S]earch', mode = { 'n', 'v' } }, { '<leader>t', group = '[T]oggle' }, { '<leader>h', group = 'Git [H]unk', mode = { 'n', 'v' } }, -- Enable gitsigns recommended keymaps first { 'gr', group = 'LSP Actions', mode = { 'n' } }, }, }
-- If you want to see what colorschemes are already installed, you can use `:Telescope colorscheme`. vim.pack.add { { src = gh 'catppuccin/nvim', name = 'catppuccin' } } vim.cmd.colorscheme 'catppuccin-frappe'
-- Highlight todo, notes, etc in comments vim.pack.add { gh 'folke/todo-comments.nvim' } require('todo-comments').setup { signs = false }
-- [[ mini.nvim ]] -- A collection of various small independent plugins/modules vim.pack.add { gh 'nvim-mini/mini.nvim' }
-- If a nerd font is available, load the icons module for pretty icons in various plugins. if vim.g.have_nerd_font then require('mini.icons').setup() -- Used for backwards compatibility with plugins that require `nvim-web-devicons` (e.g. telescope.nvim) MiniIcons.mock_nvim_web_devicons() end
-- Better Around/Inside textobjects -- -- Examples: -- - va) - [V]isually select [A]round [)]paren -- - yiiq - [Y]ank [I]nside [I]+1 [Q]uote -- - ci' - [C]hange [I]nside [']quote require('mini.ai').setup { -- NOTE: Avoid conflicts with the built-in incremental selection mappings on Neovim>=0.12 (see `:help treesitter-incremental-selection`) mappings = { around_next = 'aa', inside_next = 'ii', }, n_lines = 500, }
-- Add/delete/replace surroundings (brackets, quotes, etc.) -- -- - saiw) - [S]urround [A]dd [I]nner [W]ord [)]Paren -- - sd' - [S]urround [D]elete [']quotes -- - sr)' - [S]urround [R]eplace [)] ['] require('mini.surround').setup()
-- Simple and easy statusline. -- You could remove this setup call if you don't like it, -- and try some other statusline plugin local statusline = require 'mini.statusline' -- Set `use_icons` to true if you have a Nerd Font statusline.setup { use_icons = vim.g.have_nerd_font }
-- You can configure sections in the statusline by overriding their -- default behavior. For example, here we set the section for -- cursor location to LINE:COLUMN ---@diagnostic disable-next-line: duplicate-set-field statusline.section_location = function() return '%2l:%-2v' end
-- ... and there is more! -- Check out: https://github.com/nvim-mini/mini.nvimend
-- ============================================================-- SECTION 5: SEARCH & NAVIGATION-- Telescope setup, keymaps, LSP picker mappings-- ============================================================do -- [[ Fuzzy Finder (files, lsp, etc) ]] -- -- Telescope is a fuzzy finder that comes with a lot of different things that -- it can fuzzy find! It's more than just a "file finder", it can search -- many different aspects of Neovim, your workspace, LSP, and more! -- -- There are lots of other alternative pickers (like snacks.picker, or fzf-lua) -- so feel free to experiment and see what you like! -- -- The easiest way to use Telescope, is to start by doing something like: -- :Telescope help_tags -- -- After running this command, a window will open up and you're able to -- type in the prompt window. You'll see a list of `help_tags` options and -- a corresponding preview of the help. -- -- Two important keymaps to use while in Telescope are: -- - Insert mode: <c-/> -- - Normal mode: ? -- -- This opens a window that shows you all of the keymaps for the current -- Telescope picker. This is really useful to discover what Telescope can -- do as well as how to actually do it!
---@type (string | vim.pack.Spec)[] local telescope_plugins = { gh 'nvim-lua/plenary.nvim', gh 'nvim-telescope/telescope.nvim', gh 'nvim-telescope/telescope-ui-select.nvim', } if vim.fn.executable 'make' == 1 then table.insert(telescope_plugins, gh 'nvim-telescope/telescope-fzf-native.nvim') end
-- NOTE: You can install multiple plugins at once vim.pack.add(telescope_plugins)
-- See `:help telescope` and `:help telescope.setup()` require('telescope').setup { -- You can put your default mappings / updates / etc. in here -- All the info you're looking for is in `:help telescope.setup()` -- -- defaults = { -- mappings = { -- i = { ['<c-enter>'] = 'to_fuzzy_refine' }, -- }, -- }, -- pickers = {} extensions = { ['ui-select'] = { require('telescope.themes').get_dropdown() }, }, }
-- Enable Telescope extensions if they are installed pcall(require('telescope').load_extension, 'fzf') pcall(require('telescope').load_extension, 'ui-select')
-- See `:help telescope.builtin` local builtin = require 'telescope.builtin' vim.keymap.set('n', '<leader>sh', builtin.help_tags, { desc = '[S]earch [H]elp' }) vim.keymap.set('n', '<leader>sk', builtin.keymaps, { desc = '[S]earch [K]eymaps' }) vim.keymap.set('n', '<leader>sf', builtin.find_files, { desc = '[S]earch [F]iles' }) vim.keymap.set('n', '<leader>ss', builtin.builtin, { desc = '[S]earch [S]elect Telescope' }) vim.keymap.set({ 'n', 'v' }, '<leader>sw', builtin.grep_string, { desc = '[S]earch current [W]ord' }) vim.keymap.set('n', '<leader>sg', builtin.live_grep, { desc = '[S]earch by [G]rep' }) vim.keymap.set('n', '<leader>sd', builtin.diagnostics, { desc = '[S]earch [D]iagnostics' }) vim.keymap.set('n', '<leader>sr', builtin.resume, { desc = '[S]earch [R]esume' }) vim.keymap.set('n', '<leader>s.', builtin.oldfiles, { desc = '[S]earch Recent Files ("." for repeat)' }) vim.keymap.set('n', '<leader>sc', builtin.commands, { desc = '[S]earch [C]ommands' }) vim.keymap.set('n', '<leader><leader>', builtin.buffers, { desc = '[ ] Find existing buffers' })
-- Add Telescope-based LSP pickers when an LSP attaches to a buffer. -- If you later switch picker plugins, this is where to update these mappings. -- -- TODO: merge this into the `kickstart-lsp-attach` handler in the LSP section -- so that all buffer-local LSP keymaps are defined in one place. vim.api.nvim_create_autocmd('LspAttach', { group = vim.api.nvim_create_augroup('telescope-lsp-attach', { clear = true }), callback = function(event) local buf = event.buf
-- Find references for the word under your cursor. vim.keymap.set('n', 'grr', builtin.lsp_references, { buffer = buf, desc = '[G]oto [R]eferences' })
-- Jump to the implementation of the word under your cursor. -- Useful when your language has ways of declaring types without an actual implementation. vim.keymap.set('n', 'gri', builtin.lsp_implementations, { buffer = buf, desc = '[G]oto [I]mplementation' })
-- Jump to the definition of the word under your cursor. -- This is where a variable was first declared, or where a function is defined, etc. -- To jump back, press <C-t>. vim.keymap.set('n', 'grd', builtin.lsp_definitions, { buffer = buf, desc = '[G]oto [D]efinition' })
-- Fuzzy find all the symbols in your current document. -- Symbols are things like variables, functions, types, etc. vim.keymap.set('n', 'gO', builtin.lsp_document_symbols, { buffer = buf, desc = 'Open Document Symbols' })
-- Fuzzy find all the symbols in your current workspace. -- Similar to document symbols, except searches over your entire project. vim.keymap.set('n', 'gW', builtin.lsp_dynamic_workspace_symbols, { buffer = buf, desc = 'Open Workspace Symbols' })
-- Jump to the type of the word under your cursor. -- Useful when you're not sure what type a variable is and you want to see -- the definition of its *type*, not where it was *defined*. vim.keymap.set('n', 'grt', builtin.lsp_type_definitions, { buffer = buf, desc = '[G]oto [T]ype Definition' }) end, })
-- Override default behavior and theme when searching vim.keymap.set('n', '<leader>/', function() -- You can pass additional configuration to Telescope to change the theme, layout, etc. builtin.current_buffer_fuzzy_find(require('telescope.themes').get_dropdown { winblend = 10, previewer = false, }) end, { desc = '[/] Fuzzily search in current buffer' })
-- It's also possible to pass additional configuration options. -- See `:help telescope.builtin.live_grep()` for information about particular keys vim.keymap.set( 'n', '<leader>s/', function() builtin.live_grep { grep_open_files = true, prompt_title = 'Live Grep in Open Files', } end, { desc = '[S]earch [/] in Open Files' } )
-- Shortcut for searching your Neovim configuration files vim.keymap.set('n', '<leader>sn', function() builtin.find_files { cwd = vim.fn.stdpath 'config', follow = true } end, { desc = '[S]earch [N]eovim files' })end
-- ============================================================-- SECTION 6: LSP-- LSP keymaps, server configuration (binaries managed via mise)-- ============================================================do -- [[ LSP Configuration ]] -- Brief aside: **What is LSP?** -- -- LSP is an initialism you've probably heard, but might not understand what it is. -- -- LSP stands for Language Server Protocol. It's a protocol that helps editors -- and language tooling communicate in a standardized fashion. -- -- In general, you have a "server" which is some tool built to understand a particular -- language (such as `gopls`, `lua_ls`, `rust_analyzer`, etc.). These Language Servers -- (sometimes called LSP servers, but that's kind of like ATM Machine) are standalone -- processes that communicate with some "client" - in this case, Neovim! -- -- LSP provides Neovim with features like: -- - Go to definition -- - Find references -- - Autocompletion -- - Symbol Search -- - and more! -- -- Thus, Language Servers are external tools that must be installed separately from -- Neovim. Language server binaries are installed and managed via mise (see .mise/config.toml). -- -- If you're wondering about lsp vs treesitter, you can check out the wonderfully -- and elegantly composed help section, `:help lsp-vs-treesitter`
-- Useful status updates for LSP. vim.pack.add { gh 'j-hui/fidget.nvim' } require('fidget').setup {}
-- This function gets run when an LSP attaches to a particular buffer. -- That is to say, every time a new file is opened that is associated with -- an lsp (for example, opening `main.rs` is associated with `rust_analyzer`) this -- function will be executed to configure the current buffer vim.api.nvim_create_autocmd('LspAttach', { group = vim.api.nvim_create_augroup('kickstart-lsp-attach', { clear = true }), callback = function(event) -- NOTE: Remember that Lua is a real programming language, and as such it is possible -- to define small helper and utility functions so you don't have to repeat yourself. -- -- In this case, we create a function that lets us more easily define mappings specific -- for LSP related items. It sets the mode, buffer and description for us each time. local map = function(keys, func, desc, mode) mode = mode or 'n' vim.keymap.set(mode, keys, func, { buffer = event.buf, desc = 'LSP: ' .. desc }) end
-- Rename the variable under your cursor. -- Most Language Servers support renaming across files, etc. map('grn', vim.lsp.buf.rename, '[R]e[n]ame')
-- Execute a code action, usually your cursor needs to be on top of an error -- or a suggestion from your LSP for this to activate. map('gra', vim.lsp.buf.code_action, '[G]oto Code [A]ction', { 'n', 'x' })
-- WARN: This is not Goto Definition, this is Goto Declaration. -- For example, in C this would take you to the header. map('grD', vim.lsp.buf.declaration, '[G]oto [D]eclaration')
-- The following two autocommands are used to highlight references of the -- word under your cursor when your cursor rests there for a little while. -- See `:help CursorHold` for information about when this is executed -- -- When you move your cursor, the highlights will be cleared (the second autocommand). local client = vim.lsp.get_client_by_id(event.data.client_id) if client and client:supports_method('textDocument/documentHighlight', event.buf) then local highlight_augroup = vim.api.nvim_create_augroup('kickstart-lsp-highlight', { clear = false }) vim.api.nvim_create_autocmd({ 'CursorHold', 'CursorHoldI' }, { buffer = event.buf, group = highlight_augroup, callback = vim.lsp.buf.document_highlight, })
vim.api.nvim_create_autocmd({ 'CursorMoved', 'CursorMovedI' }, { buffer = event.buf, group = highlight_augroup, callback = vim.lsp.buf.clear_references, })
vim.api.nvim_create_autocmd('LspDetach', { group = vim.api.nvim_create_augroup('kickstart-lsp-detach', { clear = true }), callback = function(event2) vim.lsp.buf.clear_references() vim.api.nvim_clear_autocmds { group = 'kickstart-lsp-highlight', buffer = event2.buf } end, }) end
-- The following code creates a keymap to toggle inlay hints in your -- code, if the language server you are using supports them -- -- This may be unwanted, since they displace some of your code if client and client:supports_method('textDocument/inlayHint', event.buf) then map('<leader>th', function() vim.lsp.inlay_hint.enable(not vim.lsp.inlay_hint.is_enabled { bufnr = event.buf }) end, '[T]oggle Inlay [H]ints') end end, })
-- Enable the following language servers -- See `:help lsp-config` for information about keys and how to configure ---@type table<string, vim.lsp.Config> local servers = { -- clangd = {}, -- gopls = {}, -- pyright = {}, -- tsc = {},
stylua = {}, -- Used to format Lua code
-- The servers below rely on the defaults shipped by nvim-lspconfig -- (`lsp/<name>.lua`); only overrides to those defaults are listed here. -- See `:help lspconfig-all` for the full defaults of each server. bashls = {},
gopls = { settings = { gopls = { gofumpt = true, }, }, },
helm_ls = { settings = { -- Delegate YAML handling for values files to yaml-language-server. ['helm-ls'] = { yamlls = { path = 'yaml-language-server', }, }, }, },
-- Supplied by the project's own Rust toolchain: give that project a mise -- config with `rust = { version = "stable", components = "rust-analyzer" }` -- and mise installs the server (plus the `cargo` it shells out to for the -- project model) for the toolchain. For clippy lints over plain `cargo -- check`, set `settings = { ['rust-analyzer'] = { check = { command = -- 'clippy' } } }`; https://github.com/mrcjkb/rustaceanvim adds Rust-specific -- commands. rust_analyzer = {},
terraformls = { -- Also treat Terragrunt configs as a project root marker. root_markers = { '.terraform', 'terragrunt.hcl', '.git' }, },
yamlls = { settings = { -- https://github.com/redhat-developer/vscode-redhat-telemetry#how-to-disable-telemetry-reporting redhat = { telemetry = { enabled = false } }, -- NOTE: `yaml.schemaStore` is left at its default (enabled), which is what -- validates Kubernetes manifests, Helm charts, GitHub Actions, etc. -- To run yamlls fully offline, set `schemaStore = { enable = false }` here -- and list the schemas you want explicitly under `yaml.schemas`. }, },
zls = {},
-- Special Lua Config, as recommended by neovim help docs lua_ls = { on_init = function(client) client.server_capabilities.documentFormattingProvider = false -- Disable formatting (formatting is done by stylua)
if client.workspace_folders then local path = client.workspace_folders[1].name if path ~= vim.fn.stdpath 'config' and (vim.uv.fs_stat(path .. '/.luarc.json') or vim.uv.fs_stat(path .. '/.luarc.jsonc')) then return end end
local current_settings = client.config.settings --[[@as lspconfig.settings.lua_ls]] client.config.settings.Lua = vim.tbl_deep_extend('force', current_settings.Lua, { runtime = { version = 'LuaJIT', path = { 'lua/?.lua', 'lua/?/init.lua' }, }, workspace = { checkThirdParty = false, -- NOTE: this is a lot slower and will cause issues when working on your own configuration. -- See https://github.com/neovim/nvim-lspconfig/issues/3189 library = vim.api.nvim_get_runtime_file('', true), }, }) end, ---@type lspconfig.settings.lua_ls settings = { Lua = { format = { enable = false }, -- Disable formatting (formatting is done by stylua) }, }, }, }
vim.pack.add { gh 'neovim/nvim-lspconfig', }
-- Helm filetype detection (templates, helmfiles, values files) plus a -- Go-template `commentstring` and `%` block matching. The treesitter -- indent hints activate once the `helm` parser from the treesitter section -- is installed. Template conceal is disabled because it caches rendered -- values by raw template text and never invalidates that cache. vim.pack.add { gh 'qvalentin/helm-ls.nvim' } require('helm-ls').setup { conceal_templates = { enabled = false }, }
for name, server in pairs(servers) do vim.lsp.config(name, server) vim.lsp.enable(name) endend
-- ============================================================-- SECTION 7: FORMATTING-- conform.nvim setup and keymap-- ============================================================do -- [[ Formatting ]] vim.pack.add { gh 'stevearc/conform.nvim' } require('conform').setup { notify_on_error = false, format_on_save = function(bufnr) -- You can specify filetypes to autoformat on save here: local enabled_filetypes = { -- lua = true, -- python = true, } if enabled_filetypes[vim.bo[bufnr].filetype] then return { timeout_ms = 500 } else return nil end end, default_format_opts = { lsp_format = 'fallback', -- Use external formatters if configured below, otherwise use LSP formatting. Set to `false` to disable LSP formatting entirely. }, -- You can also specify external formatters in here. formatters_by_ft = { sh = { 'shfmt' }, bash = { 'shfmt' }, -- rust = { 'rustfmt' }, -- Conform can also run multiple formatters sequentially -- python = { "isort", "black" }, -- -- You can use 'stop_after_first' to run the first available formatter from the list -- javascript = { "prettierd", "prettier", stop_after_first = true }, }, }
vim.keymap.set({ 'n', 'v' }, '<leader>f', function() require('conform').format { async = true } end, { desc = '[F]ormat buffer' })end
-- ============================================================-- SECTION 8: AUTOCOMPLETE & SNIPPETS-- blink.cmp and luasnip setup-- ============================================================do -- [[ Snippet Engine ]]
-- NOTE: You can also specify plugin using a version range for its git tag. -- See `:help vim.version.range()` for more info vim.pack.add { { src = gh 'L3MON4D3/LuaSnip', version = vim.version.range '2.*' } } require('luasnip').setup {}
-- `friendly-snippets` contains a variety of premade snippets. -- See the README about individual language/framework/plugin snippets: -- https://github.com/rafamadriz/friendly-snippets -- -- vim.pack.add { gh 'rafamadriz/friendly-snippets' } -- require('luasnip.loaders.from_vscode').lazy_load()
-- [[ Autocomplete Engine ]] vim.pack.add { { src = gh 'saghen/blink.cmp', version = vim.version.range '1.*' } } require('blink.cmp').setup { keymap = { -- 'default' (recommended) for mappings similar to built-in completions -- <c-y> to accept ([y]es) the completion. -- This will auto-import if your LSP supports it. -- This will expand snippets if the LSP sent a snippet. -- 'super-tab' for tab to accept -- 'enter' for enter to accept -- 'none' for no mappings -- -- For an understanding of why the 'default' preset is recommended, -- you will need to read `:help ins-completion` -- -- No, but seriously. Please read `:help ins-completion`, it is really good! -- -- All presets have the following mappings: -- <tab>/<s-tab>: move to right/left of your snippet expansion -- <c-space>: Open menu or open docs if already open -- <c-n>/<c-p> or <up>/<down>: Select next/previous item -- <c-e>: Hide menu -- <c-k>: Toggle signature help -- -- See `:help blink-cmp-config-keymap` for defining your own keymap preset = 'default',
-- For more advanced Luasnip keymaps (e.g. selecting choice nodes, expansion) see: -- https://github.com/L3MON4D3/LuaSnip?tab=readme-ov-file#keymaps },
appearance = { -- 'mono' (default) for 'Nerd Font Mono' or 'normal' for 'Nerd Font' -- Adjusts spacing to ensure icons are aligned nerd_font_variant = 'mono', },
completion = { -- By default, you may press `<c-space>` to show the documentation. -- Optionally, set `auto_show = true` to show the documentation after a delay. documentation = { auto_show = false, auto_show_delay_ms = 500 }, },
sources = { default = { 'lsp', 'path', 'snippets' }, },
snippets = { preset = 'luasnip' },
-- Blink.cmp includes an optional, recommended rust fuzzy matcher, -- which automatically downloads a prebuilt binary when enabled. -- -- By default, we use the Lua implementation instead, but you may enable -- the rust implementation via `'prefer_rust_with_warning'` -- -- See `:help blink-cmp-config-fuzzy` for more information fuzzy = { implementation = 'lua' },
-- Shows a signature help window while you type arguments for a function signature = { enabled = true }, }
-- Advertise blink.cmp's capabilities (snippet expansion, resolve support, -- label details for auto-import) to every server. Neovim deep-extends these -- over `vim.lsp.protocol.make_client_capabilities()`, so this only adds to -- the defaults. Lives here rather than in the LSP section because blink.cmp -- only reaches 'runtimepath' via the `vim.pack.add` above. Ordering against -- `vim.lsp.enable()` is fine: writing a config invalidates resolved configs, -- which are recomputed when a client starts for a buffer. vim.lsp.config('*', { capabilities = require('blink.cmp').get_lsp_capabilities() })end
-- ============================================================-- SECTION 9: TREESITTER-- Parser installation, syntax highlighting, folds, indentation-- ============================================================do -- [[ Configure Treesitter ]] -- Used to highlight, edit, and navigate code -- -- See `:help nvim-treesitter-intro`
vim.pack.add { gh 'nvim-treesitter/nvim-treesitter' }
-- Ensure basic parsers are installed local parsers = { 'bash', 'c', 'diff', 'helm', 'html', 'lua', 'luadoc', 'markdown', 'markdown_inline', 'query', 'vim', 'vimdoc' } require('nvim-treesitter').install(parsers)
---@param buf integer ---@param language string local function treesitter_try_attach(buf, language) -- Check if a parser exists and load it if not vim.treesitter.language.add(language) then return end
-- Check if the buffer is valid (might not be after install completes) if not vim.api.nvim_buf_is_valid(buf) then return end
-- Enable syntax highlighting and other treesitter features vim.treesitter.start(buf, language)
-- Enable treesitter based folds -- For more info on folds see `:help folds` -- vim.wo.foldexpr = 'v:lua.vim.treesitter.foldexpr()' -- vim.wo.foldmethod = 'expr'
-- Check if treesitter indentation is available for this language, and if so enable it -- in case there is no indent query, the indentexpr will fallback to the vim's built in one local has_indent_query = vim.treesitter.query.get(language, 'indents') ~= nil
-- Enable treesitter based indentation if has_indent_query then vim.bo.indentexpr = "v:lua.require'nvim-treesitter'.indentexpr()" end end
local available_parsers = require('nvim-treesitter').get_available() vim.api.nvim_create_autocmd('FileType', { callback = function(args) local buf, filetype = args.buf, args.match
local language = vim.treesitter.language.get_lang(filetype) if not language then return end
local installed_parsers = require('nvim-treesitter').get_installed 'parsers'
if vim.tbl_contains(installed_parsers, language) then -- Enable the parser if it is already installed treesitter_try_attach(buf, language) elseif vim.tbl_contains(available_parsers, language) then -- If a parser is available in `nvim-treesitter`, auto-install it and enable it after the installation is done require('nvim-treesitter').install(language):await(function() treesitter_try_attach(buf, language) end) else -- Try to enable treesitter features in case the parser exists but is not available from `nvim-treesitter` treesitter_try_attach(buf, language) end end, })end
-- vim: ts=2 sts=2 sw=2 et