Nixvim config

My Neovim config using nixvim.

Note

The colorscheme in these screenshots is paradise

More!

Configuring

To start configuring, just add or modify the nix files in ./config. If you add a new configuration file, remember to add it to the config/default.nix file

Current plugins

Warning

Some of them my be disabled, this is every plugins defined and configured in the repo.

List of plugins

• colorscheme/: Theme configuration. Current one is paradise
• completion/
  • codecompanion: Zed AI like
  • copilot-cmp: Completion support for GitHub copilot
  • lspkind: vscode-like pictograms for neovim lsp completion items
  • nvim-cmp: Completion plugin for nvim + emoji support
  • schemastore.nvim: Schemastore integration
• git/
  • gitlinker: Generate shareable file permalinks
  • gitblame: inline git blame
  • gitsigns: Git integration for buffers (replaced by mini.diff + gitblame)
  • lazygit: The best git TUI, as a neovim plugin
  • worktree: Make using git worktrees easier
• lsp/
  • conform: Formatter plugin
  • fidget: LSP progress notifications
  • hlchunk: Highlight useful things like current chunk or indent lines
  • lsp: LSP configs
  • lspsaga: Cool LSP features
  • none-ls: null-ls replacement. Use nvim as LSP
  • trouble: Pretty interface for working with LSP
• snippet/
  • luasnip: Snippet engine in lua
• statusline/
  • lualine: Status line for neovim
  • staline: Some soviet guy that died a long time ago
• treesitter/
  • treesitter-context: Show code context
  • treesitter-textobject: Allow cool text manipulation thanks to TS
  • treesitter: Parser generator tool to build a syntax tree of the current buffer
• ui/
  • alpha: Dashboard
  • btw: Writes a small message as startup screen
  • bufferline: VSCode like line for buffers -> replaced by mini.tabline
  • dressing: Better vim ui interfaces
  • noice: Better nvim UI
  • nvim-notify: Notification manager
  • precognition: Show inline navigation hint
  • smart-splits: Better split managment
  • telescope: Best plugin ever ?
• utils/
  • auto-session: Session managment
  • comment: Quickly toggle comments
  • comment-box: Comments utilities
  • flash: Navigate in file with a few keystrokes
  • grapple: Quickly switch between buffers (Harpoon replacement)
  • hardtime: Learn vim motions, the hard way
  • harpoon: Quickly switch between buffers
  • illuminate: Highlight word under the cursor
  • markview: Yet another markdown previewer for neovim
  • mini: Cool neovim utilities, currently using ai, notify, surround, diff, tabline, trailspace, icons, indentscope and pairs
  • nvim-autopairs: Autopairs in nvim
  • nvim-colorizer: Preview colors in neovim
  • obsidian: Obsidian integration for nvim
  • oil: Navigate in your working folder with a buffer
  • spectre: Search and replace
  • ufo: Folding plugin
  • undotree: Undo history visualizer
  • whichkey: Popup to display keybindings

Testing your new configuration

To test your configuration simply run the following command

nix run .

If you have nix installed, you can directly run my config from anywhere

You can try running mine with:

nix run 'github:elythh/nixvim'

Installing into NixOS configuration

This nixvim flake will output a derivation that you can easily include in either home.packages for home-manager, or environment.systemPackages for NixOS. Or whatever happens with darwin?

You can add my nixvim configuration as an input to your NixOS configuration like:

{
 inputs = {
    nixvim.url = "github:elythh/nixvim";
 };
}

Direct installation

With the input added you can reference it directly.

{ inputs, system, ... }:
{
  # NixOS
  environment.systemPackages = [ inputs.nixvim.packages.${pkgs.system}.default ];
  # home-manager
  home.packages = [ inputs.nixvim.packages.${pkgs.system}.default ];
}

The binary built by nixvim is already named as nvim so you can call it just like you normally would.

Installing as an overlay

Another method is to overlay your custom build over neovim from nixpkgs.

This method is less straight-forward but allows you to install neovim like you normally would. With this method you would just install neovim in your configuration (home.packges = with pkgs; [ neovim ]), but you replace neovim in pkgs with your derivation from nixvim.

{
  pkgs = import inputs.nixpkgs {
    overlays = [
      (final: prev: {
        neovim = inputs.nixvim.packages.${pkgs.system}.default;
      })
    ];
  }
}

Bonus lazy method

You can just straight up alias something like nix run 'github:elythh/nixvim' to nvim.

Bonus extend method

If you want to extend this configuration is your own NixOS config, you can do so using nixvimExtend. See here for more info.

Example for overwriting the theme

{
  inputs,
  lib,
  ...
}: let
  nixvim' = inputs.nixvim.packages."x86_64-linux".default;
  nvim = nixvim'.nixvimExtend {
    config.theme = lib.mkForce "jellybeans";
  };
in {
  home.packages = [
    nvim
  ];
}

Credits

• yavko for the logo
• nixvim and all their maintainers/contributors