Neovim Forge

My Winchester Mystery Neovim Configuration, using lazy.nvim for plugin management and Lua as its configuration language. My Personal Development Environment (PDE) and the core tool used in cultivating my Personal Knowledge Base (PKB).

Warning

This is my personal configuration, subject to experimentation and radical rewrites periodically, rebases or substantially modifications without prior warning and other things that may make this unstable for you to use as it is presented.

With this in mind, feel free to take from it as you please, use pieces of it or the whole thing as a basis for your own, and you are more than welcome to submit pull requests if it so pleases you, that's why its on GitHub |wink|

Installation

To use this configuration, clone or copy it directly into your ~/.config/nvim directory.

# Back up your old configuration if present
mv ~/.config/nim ~/.config/nvim.bak
# Now clone this one
git clone https://github.com/Thomashighbaugh/nvim-forge ~/.config/nvim

And that should be it, if you have the prerequisites installed it should run through the lazy.nvim installation process and handle setting up everything in the process from Treesitter grammars to Mason dependencies, it might just take a few minutes so be patient.

Configuration Structure

This configuration roughly follows that of LazyVim, with some minor changes that are mostly due to personal taste, which while arbitrary is much easier to quickly locate various things when they are arranged in the way one prefers and not an artificially imposed standard. The lion's share of the configuration exists within the lua/ subdirectory as is the convention of Lua-based NeoVim configurations.

Unlike many other highly customized NeoVim configurations, as well as most major configuration frameworks, the configuration is not nested within a subdirectory of the Lua subdirectory named after the author, plugin or configuration, I find no need to brand this configuration in a way that makes using its parts elsewhere highly onerous and introduces a needless source of potential errors for me to deal with instead of working on code like I intend to be.

Below is a representation of the structure of the configuration in tree format

 . ├──  Dockerfile ├──  ftplugin │ └──  java.lua ├──  init.lua ├──  lazy-lock.json ├──  lua │ ├──  code_action_utils.lua │ ├──  core │ │ ├──  autocommands.lua │ │ ├──  keymaps.lua │ │ ├──  options.lua │ │ ├──  usercommands.lua │ │ └──  utils.lua │ └──  plugins │ ├──  aisync.lua │ ├──  bufferline.lua │ ├──  cmp.lua │ ├──  codesnap.lua │ ├──  comments.lua │ ├──  conform.lua │ ├──  dap │ │ └──  debug_adapter.lua │ ├──  dashboard.lua │ ├──  devdocs.lua │ ├──  dressing.lua │ ├──  flash.lua │ ├──  focus.lua │ ├──  git.lua │ ├──  image_preview.lua │ ├──  inc_rename.lua │ ├──  indent-blankline.lua │ ├──  init.lua │ ├──  lsp │ │ ├──  aerial.lua │ │ ├──  glance.lua │ │ ├──  lazydev.lua │ │ ├──  lsp-config.lua │ │ ├──  mason.lua │ │ ├──  nvim-navic.lua │ │ ├──  outline.lua │ │ └──  trouble.lua │ ├──  lualine.lua │ ├──  luasnip.lua │ ├──  mini-align.lua │ ├──  mini-indentscope.lua │ ├──  neo-tree.lua │ ├──  noice.lua │ ├──  nvim-autopairs.lua │ ├──  nvim-lint.lua │ ├──  nvim-notify.lua │ ├──  nvim-surround.lua │ ├──  nvim-tree.lua │ ├──  oil.lua │ ├──  ollama.lua │ ├──  rainbow-delimiters.lua │ ├──  rest.lua │ ├──  snipe.lua │ ├──  ssr.lua │ ├──  statuscol.lua │ ├──  symbols.lua │ ├──  telescope.lua │ ├──  toggleterm.lua │ ├──  treesitter.lua │ ├──  web_devicons.lua │ ├──  which-key.lua │ └──  yanky.lua ├── 󰂺 README.md → .github/README.md ├──  snippets │ ├──  all.lua │ ├──  java.snippets │ ├──  javascript.lua │ ├──  lua.lua │ ├──  markdown.lua │ ├──  package.json │ ├──  vscode │ │ ├──  c.json │ │ ├──  cpp.json │ │ ├──  css.json │ │ ├──  frameworks │ │ │ ├──  ejs.json │ │ │ ├──  flutter.json │ │ │ ├──  jekyll.json │ │ │ └──  vue │ │ │ ├──  html.json │ │ │ ├──  javascript.json │ │ │ ├──  pug.json │ │ │ └──  vue.json │ │ ├──  gdscript.json │ │ ├──  gitcommit.json │ │ ├──  global.json │ │ ├──  glsl.json │ │ ├──  go.json │ │ ├──  haskell.json │ │ ├──  html.json │ │ ├──  java.json │ │ ├──  javascript │ │ │ ├──  javascript.json │ │ │ ├──  react-native-ts.json │ │ │ ├──  react-native.json │ │ │ ├──  react-ts.json │ │ │ ├──  react.json │ │ │ └──  typescript.json │ │ ├──  kotlin.json │ │ ├──  kubernetes.json │ │ ├──  latex │ │ │ ├──  latex-snippets.json │ │ │ └──  vscode-latex-snippets.json │ │ ├──  latex.json │ │ ├──  lua.json │ │ ├──  markdown.json │ │ ├──  meson.json │ │ ├──  norg.json │ │ ├──  org.json │ │ ├──  package-lock.json │ │ ├──  package.json │ │ ├──  python │ │ │ ├──  base.json │ │ │ ├──  comprehension.json │ │ │ ├──  debug.json │ │ │ ├──  python.json │ │ │ └──  unittest.json │ │ ├──  rust.json │ │ ├──  scala.json │ │ ├──  shell.json │ │ └──  sql.json │ └──  yaml.lua └──  spell ├──  en.dict ├──  en.utf-8.add └──  en.utf-8.add.spl

Keybindings

Below are the keybind mappings used in this configuration, they are subject to change and are not exhaustive, but they should give you a good idea of how the configuration is set up and how to use it.

General Keybindings

[!] Note:

• means press both keys at the same time
  

  → means first the key on the left then the key on the right

Basic Navigation and Editing

Text Manipulation

Buffer Management

Window Management

Search and Replace

Selection and Deletion

Insert Mode

Editor Functionality

Plugin Management (Lazy)

Debugging

Diff View

Noice

Terminal Bindings

Java Development Tools

LuaSnip

Nvim-Toggler

Nvim-Tree

LSP (Language Server Protocol)

Treesitter

Inspiration

The following projects were instrumental in the crafting of this environment

• Allaman's nvim
• Alexis12119's nvim-config
• glepnir's nvim
• ayamir's nvimdots
• CharlesChiuGit's nvimdots
• dragove's nvim
• Dharmx's Nvim
• loctvl842's nvim'
• ... and many, many more!