kickstart.nvim/README.md

Neovim Development Environment

A highly opinionated, single-file Neovim configuration built for performance, transparency, and a terminal-native workflow.

Philosophy

This configuration is intentionally streamlined. It avoids the bloat of heavy distributions in favor of a clear, maintainable init.lua that acts as its own documentation.

• Built for Infrastructure & Backend: Tuned specifically for a DevOps engineering workflow, with deep integrations for Go, Terraform, Bicep, and bash scripting.
• Terminal-Native: Optimized for fast, keyboard-driven navigation. No unnecessary GUI abstractions.
• Radical Transparency: Every line of code is meant to be understood. The configuration is a foundation, ready to be scaled or refactored as tooling requirements evolve.

Prerequisites

This setup expects a modern Unix environment. It is primarily developed and tested on Arch Linux.

Ensure you have the following system dependencies installed so tools like Telescope and Treesitter compile correctly:

sudo pacman -S --needed neovim gcc make git ripgrep fd tree-sitter-cli unzip xclip

Installation

1. Prepare the Environment Back up any existing configuration and clear the local share directory to avoid plugin conflicts.

mv ~/.config/nvim ~/.config/nvim.bak
rm -rf ~/.local/share/nvim

2. Clone the Repository

git clone https://github.com/YOUR_GITHUB_USERNAME/kickstart.nvim.git ~/.config/nvim

3. Bootstrap Launch Neovim. The package manager will automatically pull and compile all plugins on the first run.

nvim

Core Stack & Integrations

• LSP & Linting: Native Neovim LSP setup configured for gopls, terraform-ls, and bicep-lsp.
• Fuzzy Finding: Telescope.nvim powered by ripgrep and fd for instant project-wide navigation.
• Parsing: Treesitter for high-performance syntax highlighting and structural code manipulation.

Management & Updates

• Inspect State: Run :lua vim.pack.update(nil, { offline = true })
• Apply Updates: Run :lua vim.pack.update() (:write to apply, :quit to cancel)