kickstart.nvim/lua/custom/plugins/README.md

1.5 KiB

Custom Plugins Setup

ToggleTerm

Quick notes on the terminal experience provided by lua/custom/plugins/toggleterm.lua.

Highlights

  • Floating terminals sized responsively to the current UI (<C-\> or <leader>tf).
  • Dedicated splits: <leader>th (horizontal) and <leader>tv (vertical).
  • Terminal picker <leader>tt to switch between multiple terminals.
  • Send code to the primary terminal with <leader>ts (line or visual selection).
  • Terminal windows inherit familiar navigation (<Esc>, jk, <C-hjkl>) automatically.

Tips

  • Use counts (2ToggleTerm, 3ToggleTerm) when you want to retarget a specific layout.
  • TermExec cmd="npm run test" reuses the floating terminal without stealing focus.
  • Update sizing or borders in float_opts if your display or font spacing demands it.

LazyGit

Enhanced git interface using lua/custom/plugins/lazygit.lua.

Highlights

  • Fast, native lazygit integration with no keyboard shortcut conflicts
  • Opens in a proper floating window (95% of screen size)
  • Fully functional with all lazygit features and keybindings
  • Use <leader>gg to open lazygit in current repo
  • Use <leader>gf to open lazygit focused on current file history

Why Not ToggleTerm?

LazyGit.nvim is used instead of toggleterm for lazygit because:

  • Better performance (uses native terminal, not Neovim's terminal emulator)
  • No keyboard shortcut conflicts (q, Esc, etc. work as expected)
  • Designed specifically for lazygit integration
  • Supports editing commit messages in Neovim