darkstar

Requirements

Dependency	Why	Notes
Neovim 0.12+	nvim-treesitter's `main` branch needs it	Build from source or use a release
git	Plugin installs and vim-fugitive
A C compiler (`gcc` or `clang`)	Compiles treesitter parsers and the native FZF sorter
`make`	Builds telescope-fzf-native
tree-sitter CLI	Compiles parsers on the treesitter `main` branch	`cargo install tree-sitter-cli` or `npm i -g tree-sitter-cli`

Optional:

Dependency	Why
ripgrep	Speeds up telescope live grep; the config falls back to `grep` without it
A Nerd Font	Renders icons in telescope and which-key

Debian and Ubuntu pull the build tools in one line:

apt install git build-essential ripgrep cargo && cargo install tree-sitter-cli

Install

git clone <repo-url> ~/.config/nvim
nvim

The first launch bootstraps lazy.nvim and installs every plugin. Treesitter compiles each parser the first time you open a matching file.

To run it next to an existing config, clone to ~/.config/neovim and start NVIM_APPNAME=neovim nvim.

Plugins

lazy.nvim: plugin manager
telescope.nvim: fuzzy finder, with the native FZF sorter when a compiler is present
nvim-treesitter (main branch): syntax highlighting, parsers installed on demand
nvim-treesitter-context: sticky scope header
vim-fugitive: git
vim-surround: surround text objects
undotree: undo history
which-key.nvim: keymap hints
fidget.nvim: progress notifications
dracula.nvim: colorscheme, transparent background by default

Comment toggling uses the built-in gc operator.

Key bindings

Leader is space. Press <leader>? for buffer-local bindings, or start typing and which-key fills in the rest.

Keys	Action
`<leader>pv`	File explorer (netrw)
`<leader>ff` / `<leader>fg`	Find files / live grep
`<leader>fb` / `<leader>fr`	Buffers / recent files
`<leader>gs`	Git status
`<leader>u`	Undo tree
`<leader>y` / `<leader>d`	Yank to system clipboard / delete without yanking
`<leader>pcp` / `<leader>pcd`	Dracula with transparent / opaque background

Structure

init.lua                  entry point, sets the leader key
lua/darkstar/
  init.lua                autocmds, netrw, shada
  set.lua                 options
  remap.lua               keymaps
  lazy.lua                lazy.nvim bootstrap
  plugins/                one file per plugin spec

hawkff/nvim

README