neovim-flake

Nix flake for neovim with configuration options

Originally based on Wil Taylor's amazing neovim-flake and jordanisaacs neovim-flake

Installation

This config is constantly changing and updating as it is my personal config. It is opinionated and some available options may also be broken which I will try to keep documented in issues. I am sharing it so anyone can use it as inspiration/a starting point for their own config. I recommend cloning the config and running it locally with:

nix run .#

If you want to live life on the edge you can point to this repository directly with:

nix run github:emattiza/neovim-flake.#

If you don't want to use nix, you can do the following with docker and host mounts:

docker run -v `pwd`:`pwd` -w `pwd` --rm -it ghcr.io/emattiza/neovim-flake:latest

Or if you're running containerd and nerdctl

nerdctl run -v `pwd`:`pwd` -w `pwd` --rm -it ghcr.io/emattiza/neovim-flake:latest

Options

The philosophy behind this flake configuration is sensible options. While the default package has almost everything enabled, when building your own config using the overlay everything is disabled. By enabling a plugin or language, it will set up the keybindings and plugin automatically. Additionally each plugin knows when another plugin is enabled allowing for smart configuration of keybindings and automatic setup of things like completion sources and languages.

A goal of mine is that I shouldn't not be able to break neovim by enabling or disabling an option. For example you can't have two completion plugins enabled as the option is an enum.

Screenshot

Language Support

Most languages use nvim-lspconfig to set up language server. Additionally some languages also (or exclusively) use null-ls to extend capabilities.

Rust

LSP Server: rust-analyzer

Formatting

Rust analyzer provides builtin formatting with rustfmt

Plugins

• rust-tools
• crates.nvim

Nix

LSP Server: rnix-lsp

Formatting

rnix provides builtin formatting with nixpkgs-fmt but it is disabled and I am instead using null-ls with alejandra

SQL

LSP Server: sqls

Formatting

sqls provides formatting but it does not work very well so it is disabled. Instead using sqlfluff through null-ls.

Linting

Using sqlfluff through null-ls to provide linting diagnostics set at information severity.

Plugins

• sqls.nvim for useful actions that leverage sqls LSP

C/C++

LSP Server: ccls

Typescript

LSP Server: typescript-language-server

Linting

Using eslint through null-ls.

Formatting

Disabled lsp server formatting, using prettier through null-ls.

Deno

** LSP Server ** : Deno native

Linting

Using eslint through null-ls.

Formatting

Disabled lsp server formatting, using prettier through null-ls.

Purescript

** LSP Server ** : purescript-language-server

Python

LSP Server: pyright

Formatting:

Using black through null-ls

Markdown

Plugins

• glow.nvim for preview directly in neovim buffer (broken, waiting on issue)

HTML

Plugins

• nvim-ts-autotag for autoclosing and renaming html tags. Works with html, tsx, vue, svelte, and php

All Plugins

A list of all plugins that can be enabled

LSP

• nvim-lspconfig common configurations for built-in language server
• null-ls.nvim neovim as a language server to inject LSP diagnostics, code actions, etc.
• lspsaga.nvim useful UI and tools for lsp
• trouble.nvim pretty list of lsp data
• nvim-code-action-menu a better code action menu with diff support
• lsp-signature show function signatures as you type
• lspkind-nvim for pictograms in lsp (with support for nvim-cmp)

Buffers

• nvim-bufferline-lua a buffer line with tab integration
• bufdelete-nvim delete buffers without losing window layout

Statuslines

• lualine.nvim statusline written in lua.

Filetrees

• nvim-tree-lua a file explorer tree written in lua. Using

Git

• gitsigns.nvim a variety of git decorations

Treesitter

• Nix installation of treesitter
• nvim-treesitter-context a context bar using tree-sitter
• nvim-ts-autotag uses treesitter to autoclose/rename html tags

Visuals

• indent-blankline for indentation guides
• nvim-web-devicons Plugins and colors for icons. Requires patched font

Utilities

• telescope an extendable fuzzy finder of lists. Working ripgrep and fd
• which-key a popup that displays possible keybindings of command being typed

Markdown

• glow.nvim a markdown preview directly in neovim using glow

Completions

• nvim-compe A deprecated autocomplete plugin
• nvim-cmp a completion engine that utilizes sources (replaces nvim-compe)
  • cmp-buffer a source for buffer words
  • cmp-nvim-lsp a source for builtin LSP client
  • cmp-vsnip a source for vim-vsnip autocomplete
  • cmp-path a source for path autocomplete
  • cmp-treesitter treesitter nodes autcomplete
  • crates.nvim autocompletion of rust crate versions in cargo.toml

Snippets

• vim-vsnip a snippet plugin that supports LSP/VSCode's snippet format

Autopairs

• nvim-autopairs an autopair plugin for neovim

Themes

• onedark a dark colorscheme with multiple options
• tokyonight-nvim a neovim theme with multiple color options

Dependencies

• plenary which is a dependency of some plugins, installed automatically if needed