A launch point for your personal nvim configuration
Go to file
Michael Mroczka 4a882c7d6c Fix nvim setup and add custom plugins 2024-08-13 11:49:43 -04:00
.github/ISSUE_TEMPLATE minor modifications on the issue template (#244) 2023-04-13 09:22:59 -04:00
doc feat: move to lazy.nvim package manager and add first plugins (#178) 2023-02-17 16:31:57 -05:00
lua Fix nvim setup and add custom plugins 2024-08-13 11:49:43 -04:00
.gitignore Remove lazy-lock.json from .gitignore 2023-09-27 16:44:03 -07:00
.stylua.toml Use call_parentheses 2023-06-16 21:12:11 -07:00
README.md Update remote url 2023-11-11 19:04:19 -06:00
init.lua Split modules and plugins apart 2023-11-12 07:15:41 -06:00
lazy-lock.json Fix nvim setup and add custom plugins 2024-08-13 11:49:43 -04:00

README.md

Mike's NVIM from kickstart.nvim

Requirements:

  • Make sure to review the readmes of the plugins if you are experiencing errors. In particular:

Neovim's configurations are located under the following paths, depending on your OS:

OS PATH
Linux $XDG_CONFIG_HOME/nvim, ~/.config/nvim
MacOS $XDG_CONFIG_HOME/nvim, ~/.config/nvim
Windows (cmd) %userprofile%\AppData\Local\nvim\
Windows (powershell) $env:USERPROFILE\AppData\Local\nvim\

Clone kickstart.nvim:

# on Linux and Mac
git clone git@github.com:mmroczka/kickstart.nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim

Post Installation

Start Neovim

nvim

Configuration And Extension

  • Inside of your copy, feel free to modify any file you like! It's your copy!
  • Feel free to change any of the default options in init.lua to better suit your needs.
  • For adding plugins, there are 3 primary options:
    • Add new configuration in lua/custom/plugins/* files, which will be auto sourced using lazy.nvim (uncomment the line importing the custom/plugins directory in the init.lua file to enable this)
    • Modify init.lua with additional plugins.
    • Include the lua/kickstart/plugins/* files in your configuration.

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",
  -- Optional dependency
  dependencies = { 'hrsh7th/nvim-cmp' },
  config = function()
    require("nvim-autopairs").setup {}
    -- If you want to automatically add `(` after selecting a function or method
    local cmp_autopairs = require('nvim-autopairs.completion.cmp')
    local cmp = require('cmp')
    cmp.event:on(
      'confirm_done',
      cmp_autopairs.on_confirm_done()
    )
  end,
}

This will automatically install windwp/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.