Neovim Configuration

This repository contains a modular, modern Neovim configuration designed for productivity, aesthetics, and extensibility. It leverages the lazy.nvim plugin manager for fast startup and easy plugin management, and organizes custom settings and plugins for clarity and maintainability.

Directory Structure

• init.lua — Main entry point, bootstraps plugin manager and loads all modules/plugins.
• lua/core/ — Core configuration files:
  • keymaps.lua — Custom keybindings for efficient navigation and editing.
  • options.lua — Editor options and settings.
• lua/plugins/ — Individual plugin configurations (one file per plugin):
  • alpha.lua — Dashboard/start screen.
  • autocomplete.lua — Autocompletion setup.
  • bufferline.lua — Buffer/tab management.
  • colortheme.lua — Colorscheme and theme settings.
  • comment.lua — Commenting utilities.
  • debug.lua — Debugging tools.
  • gitsigns.lua — Git integration and signs.
  • indent-blankline.lua — Indentation guides.
  • lsp.lua — Language Server Protocol setup.
  • lualine.lua — Statusline configuration.
  • mini.lua — Mini.nvim plugin settings.
  • misc.lua — Miscellaneous plugin configs.
  • neotree.lua — File explorer/tree.
  • noice.lua — UI/notifications enhancements.
  • none-ls.lua — Null-ls integration for formatting/linting.
  • toggleterm.lua — Terminal integration.
  • telescope.lua — Fuzzy finder and picker.
  • treesitter.lua — Syntax highlighting and parsing.

Plugin Management

Uses lazy.nvim for plugin management. Plugins are defined in init.lua and loaded from the lua/plugins/ directory.

Installation

1. Clone this repository:

   git clone https://github.com/RajeshPandey057/nvim-config ~/.config/nvim

2. Open Neovim:

   nvim

   The config will automatically bootstrap lazy.nvim and install all plugins.
3. Check plugin status:
   • Run :Lazy inside Neovim to view/manage plugins.
   • Use :Lazy update to update plugins.

Customization

• Keymaps: Defined in lua/core/keymaps.lua.
• Options: Editor settings in lua/core/options.lua.
• Add plugins: Create a new file in lua/plugins/ and add it to the require("lazy").setup({ ... }) list in init.lua.

Usage Tips

• Press ? in the :Lazy menu for help.
• Use :q to close plugin/status windows.
• Colorscheme is set to cyberdream by default (can be changed in init.lua).
• Automatic plugin update checking is enabled.

Troubleshooting

• If plugins do not install, check your internet connection and ensure git is installed.
• For errors during startup, review messages in Neovim and check the relevant config file in lua/core/ or lua/plugins/.

Credits

• lazy.nvim for plugin management
• All plugin authors listed in the lua/plugins/ directory

Keymaps

Below are the custom key mappings defined in lua/core/keymaps.lua:

Mode	Key	Action/Command	Description
n/v	<Space>	<Nop>	Disable default spacebar behavior
n	<C-s>	:w	Save file
n	<leader>sn	:noautocmd w	Save file without auto-formatting
n	<C-q>	:q	Quit file
n	x	"_x	Delete character without yanking
n	<C-d>	<C-d>zz	Scroll down and center
n	<C-u>	<C-u>zz	Scroll up and center
n	n	nzzzv	Find next and center
n	N	Nzzzv	Find previous and center
n	<Up>	:resize -2	Resize window up
n	<Down>	:resize +2	Resize window down
n	<Left>	:vertical resize -2	Resize window left
n	<Right>	:vertical resize +2	Resize window right
n	<Tab>	:bnext	Next buffer
n	<S-Tab>	:bprevious	Previous buffer
n	<leader>x	:bdelete!	Close buffer
n	<leader>b	:enew	New buffer
n	<leader>v	<C-w>v	Split window vertically
n	<leader>h	<C-w>s	Split window horizontally
n	<leader>se	<C-w>=	Equalize split windows
n	<leader>xs	:close	Close current split window
n	<C-k>	:wincmd k	Move to split above
n	<C-j>	:wincmd j	Move to split below
n	<C-h>	:wincmd h	Move to split left
n	<C-l>	:wincmd l	Move to split right
n	<leader>to	:tabnew	Open new tab
n	<leader>tx	:tabclose	Close current tab
n	<leader>tn	:tabn	Next tab
n	<leader>tp	:tabp	Previous tab
n	<leader>lw	:set wrap!	Toggle line wrapping
v	<	<gv	Stay in indent mode
v	>	>gv	Stay in indent mode
v	p	"_dP	Paste without losing yanked text
n	[d	vim.diagnostic.goto_prev	Previous diagnostic message
n	]d	vim.diagnostic.goto_next	Next diagnostic message
n	<leader>d	vim.diagnostic.open_float	Floating diagnostic message
n	<leader>q	vim.diagnostic.setloclist	Diagnostics list

Plugin Keymaps

Telescope

Mode	Key	Action/Command	Description
n	<leader>sh	Telescope help_tags	Search help tags
n	<leader>sk	Telescope keymaps	Search keymaps
n	<leader>sf	Telescope find_files	Search files
n	<leader>ss	Telescope builtin	Search Telescope builtins
n	<leader>sw	Telescope grep_string	Search current word
n	<leader>sg	Telescope live_grep	Search by grep
n	<leader>sd	Telescope diagnostics	Search diagnostics
n	<leader>sr	Telescope resume	Resume last Telescope search
n	<leader>s.	Telescope oldfiles	Search recent files
n	<leader><leader>	Telescope buffers	Find existing buffers
n	<leader>/	Telescope current_buffer_fuzzy_find	Fuzzy search in current buffer
n	<leader>s/	Telescope live_grep (open files)	Live grep in open files

Neo-tree

Mode	Key	Action/Command	Description
n	<leader>e	Neotree toggle	Toggle file explorer

LSP

Mode	Key	Action/Command	Description
n	gd	LSP definitions	Goto definition
n	gr	LSP references	Goto references
n	gI	LSP implementations	Goto implementation
n	<leader>D	LSP type definitions	Goto type definition
n	<leader>ds	LSP document symbols	Document symbols
n	<leader>ws	LSP workspace symbols	Workspace symbols
n	<leader>rn	LSP rename	Rename symbol
n/x	<leader>ca	LSP code action	Code action
n	gD	LSP declaration	Goto declaration
n	<leader>th	Toggle inlay hints	Toggle inlay hints
n	<leader>id	Toggle inline diagnostics	Toggle inline diagnostics
n	<leader>f	Format file	Format current file

Autocompletion

This config uses nvim-cmp for autocompletion, with support for LSP, buffer, path, and snippets via LuaSnip.

Features:

• Completion from LSP, buffer, file paths, and snippets.
• Snippet expansion and navigation (LuaSnip).
• Icons for completion kinds.
• Customizable keymaps.

Keymaps:

Mode	Key	Action/Command	Description
i/s	<Tab>	Next completion/snippet field	Select next item or jump in snippet
i/s	<S-Tab>	Previous completion/snippet	Select previous item or jump back in snippet
i/s	<C-n>	Next completion item	Select next item
i/s	<C-p>	Previous completion item	Select previous item
i/s	<C-y>	Confirm completion	Accept selected completion
i/s	<C-Space>	Trigger completion menu	Manually open completion menu
i/s	<C-l>	Jump to next snippet field	Move to next snippet placeholder
i/s	<C-h>	Jump to previous snippet field	Move to previous snippet placeholder
i/s	<C-b>	Scroll docs up	Scroll documentation up
i/s	<C-f>	Scroll docs down	Scroll documentation down

Snippets:

• Uses LuaSnip and friendly-snippets for a wide range of language snippets.
• You can add your own snippets in Lua or load VSCode-style snippets.

Customization:

• Change completion sources, icons, and formatting in lua/plugins/autocomplete.lua.
• For more info, see nvim-cmp and LuaSnip.

Troubleshooting:

• If completions/snippets don’t work, check plugin installation and ensure LSP servers are running.
• For snippet expansion, make sure LuaSnip and friendly-snippets are installed.

---

C++ Debugging (nvim-dap)

This config supports C++ debugging using nvim-dap with two adapters:

• codelldb (installed via mason-nvim-dap)
• cppdbg (Microsoft VSCode C++ extension)

Setup:

• For codelldb: Make sure you have lldb installed. codelldb is installed automatically by Mason.
• For cppdbg: Download the VSCode cpptools extension if you haven't already. Set the path to OpenDebugAD7 in your config (see lua/plugins/debug.lua).
  • On macOS, the path is usually: ~/.vscode/extensions/ms-vscode.cpptools-<version>-darwin-arm64/debugAdapters/bin/OpenDebugAD7
  • For your setup, use: ~/.vscode/extensions/ms-vscode.cpptools-1.26.3-darwin-arm64/debugAdapters/bin/OpenDebugAD7

Keymaps:

Key	Action
<F5>	Start/Continue
<F1>	Step Into
<F2>	Step Over
<F3>	Step Out
<F7>	Toggle DAP UI
<leader>b	Toggle Breakpoint
<leader>B	Set Conditional Breakpoint

Usage:

1. Open your C++ file and compile it to an executable (e.g., clang++ main.cpp -g -o main).
2. In Neovim, run :Mason and ensure codelldb is installed (for codelldb adapter).
3. For cppdbg, download and extract VSCode cpptools, then set the path to OpenDebugAD7 in your config.
4. Set breakpoints with <leader>b.
5. Start debugging with <F5>. When prompted, enter the path to your executable.
6. Use <F1>, <F2>, <F3> to step through code. Toggle the DAP UI with <F7>.

Example Configurations:

• codelldb:

{
  name = "Launch file (codelldb)",
  type = "codelldb",
  request = "launch",
  program = function()
    return vim.fn.input("Path to executable: ", vim.fn.getcwd() .. "/", "file")
  end,
  cwd = "${workspaceFolder}",
  stopOnEntry = false,
}

• cppdbg:

{
  name = "Launch file (cppdbg)",
  type = "cppdbg",
  request = "launch",
  program = function()
    return vim.fn.input("Path to executable: ", vim.fn.getcwd() .. "/", "file")
  end,
  cwd = "${workspaceFolder}",
  stopAtEntry = true,
  MIMode = "gdb",
  miDebuggerPath = "/usr/bin/gdb",
  setupCommands = {
    {
      text = "-enable-pretty-printing",
      description = "enable pretty printing",
      ignoreFailures = false
    },
  },
}

Troubleshooting:

• If debugging doesn't start, check that your executable is compiled with debug symbols (-g).
• For codelldb, make sure it is installed and executable (see :Mason).
• For cppdbg, ensure you have set the correct path to OpenDebugAD7 and have gdb installed.
• For adapter errors, check the path in the config and your system's debugger installation.

---

Terminal Integration (toggleterm.nvim)

This config uses toggleterm.nvim for seamless terminal management in Neovim.

Features:

• Toggle terminal with <leader>tt
• Supports horizontal, vertical, floating, and tab terminals
• Persistent terminal sessions
• Custom shell and appearance options

Keymaps:

Mode	Key	Action/Command	Description
n	<leader>tt	ToggleTerm	Toggle floating terminal
t	<esc>	<C-\><C-n>	Exit terminal mode
t	jk	<C-\><C-n>	Exit terminal mode
t	<C-h>	wincmd h	Move to left split
t	<C-j>	wincmd j	Move to below split
t	<C-k>	wincmd k	Move to above split
t	<C-l>	wincmd l	Move to right split
t	<C-w>	<C-\><C-n><C-w>	Window command in terminal

Usage:

• Press <leader>tt in normal mode to toggle a floating terminal.
• To close a floating terminal: press <esc> or jk to exit terminal mode, then use :q or click the close button in the float window.
• Use the above keymaps to navigate and exit terminal mode easily.
• Customize shell and appearance in lua/plugins/toggleterm.lua.
• Open multiple terminals with counts: 2<leader>tt for terminal 2, etc.
• Use :TermExec cmd="your_command" to run commands in a new terminal.

Advanced:

• Create custom terminals for tools like lazygit, htop, etc.
• Send lines or selections to the terminal with plugin commands.
• See the toggleterm.nvim docs for more features.

---

Competitive Programming Workflow

Compile & Run C/C++ Files

• Keybinding: <leader>rr
• Behavior:
  • Compiles the current C/C++ file with strong flags.
  • If compilation succeeds, runs the output binary in a floating terminal.
  • If input.txt exists in the same directory, program reads from it.
  • If compilation fails, prints Compilation failed and removes the output binary.
• Supported extensions: .cpp, .c
• Compiler: clang++ for C++, clang for C
• Flags: -std=c++20 -O2 -Wall -Wextra -Wshadow -Wconversion -Wfloat-equal
• Terminal: Uses toggleterm.nvim in horizontal mode only.

Example Usage

1. Open a C++ or C file in Neovim.
2. Press <leader>rr to compile and run.
3. If input.txt is present, it will be used as input.
4. Output and errors are shown in a horizontal terminal.

Troubleshooting

• If the file is not C/C++, nothing happens.
• If compilation fails, the error is shown and the binary is removed.
• If input.txt is missing, program runs without input redirection.

---

Automated Debug Workflow for C/C++

• Keybinding: <F5>
• Behavior:
  • For C and C++ files, pressing <F5> will:
    • Compile the current file with debug flags (-g and strong warnings).
    • If compilation succeeds, automatically start a new debug session (using codelldb for C++ or cppdbg for C).
    • If a debug session is already running, <F5> will continue execution (step forward) as usual.
    • If compilation fails, an error message is shown and debugging does not start.
  • For other filetypes, <F5> behaves as usual (starts/continues debugging).

How to use:

1. Open a C or C++ file in Neovim.
2. Press <F5> to compile and start debugging, or to continue if already debugging.
3. If input.txt is present, it will be used for program input when running normally (not during debugging).

Note:

• This workflow is fully automated for C/C++ files. You do not need to manually compile before debugging.
• For other languages, use your normal DAP workflow.

---

Recommended Fonts & Terminal

• Font: Use a Nerd Font (e.g., FiraCode Nerd Font) for best icon support.
• Terminal: Set your terminal to use a Nerd Font and enable true color (export COLORTERM=truecolor).

---

Quickstart

1. Install a Nerd Font and set it in your terminal.
2. Clone this repo and open Neovim.
3. Run :Lazy to check plugin status.
4. Use <leader>e to open the file explorer, <leader>sf to search files, and <leader>f to format code.

---

Useful Resources

• Neovim Documentation
• lazy.nvim
• Telescope.nvim
• Neo-tree
• nvim-lspconfig
• Nerd Fonts

---

Feel free to fork and customize this config for your workflow!

Ghostty Terminal Keymaps & Config

Your Ghostty config (priority):

shell-integration = zsh
font-family = FiraCode Nerd Font
background-opacity = 0.8
background-blur = true
theme = dark:cyberdream,light:cyberdream-light
mouse-hide-while-typing = true
scrollback-limit = 1000000

keybind = ctrl+n=new_window

keybind = super+h=goto_split:left
keybind = super+j=goto_split:bottom
keybind = super+k=goto_split:top
keybind = super+l=goto_split:right

keybind = ctrl+a>h=new_split:left
keybind = ctrl+a>j=new_split:down
keybind = ctrl+a>k=new_split:up
keybind = ctrl+a>l=new_split:right
keybind = ctrl+a>f=toggle_split_zoom

keybind = ctrl+a>n=next_tab
keybind = ctrl+a>p=previous_tab

keybind = super=r=reload_config

window-save-state = always

Basic Ghostty keymaps:

Keybinding	Action
Ctrl+N	New window
Ctrl+T	New tab
Ctrl+W	Close tab
Ctrl+A > N/P	Next/Previous tab
Super+H/J/K/L	Move to split (left/bottom/top/right)
Ctrl+A > H/J/K/L	Create split (left/down/up/right)
Ctrl+A > F	Toggle split zoom
Super+R	Reload config

• Font: FiraCode Nerd Font
• Theme: cyberdream (dark/light)
• Shell: zsh
• Scrollback: 1,000,000 lines
• Mouse hides while typing
• Window state always saved

For more options, see Ghostty docs.

---

Custom C++ Template Snippet (LuaSnip)

This config includes a custom C++ template snippet using LuaSnip.

Setup:

• The snippet is defined in lua/plugins/luasnip.lua.
• It is loaded automatically via lazy.nvim (see init.lua).

Usage:

1. Open a .cpp file in Neovim.
2. In insert mode, type cpp and expand the snippet using one of these keys:
   • <leader><Tab> (default: <Space><Tab>, recommended to avoid conflicts)
   • <C-K> (Ctrl+K)
3. The full C++ template will be inserted, and your cursor will be placed at the end of the template (after return 0; in main()).

Editing the Snippet:

• To change the template, edit the snippet in lua/plugins/luasnip.lua.
• The snippet uses LuaSnip’s t (text_node) for static text and i(0) to place the cursor at the end.

Troubleshooting:

• If the snippet does not expand, ensure:
  • LuaSnip is installed (:Lazy should show it).
  • You are in a .cpp file and in insert mode.
  • You are using the correct trigger key (see above).
• If you see errors about curly braces, make sure the snippet uses t{...} and not fmt for static templates.