Neovim Ecosystem

As we know, achieving a comfortable Vim or Neovim configuration is a painful and tedious task, especially when changing our host machine, experimenting with a new plugin or Neovim version, or updating all plugins at once. This project allows us to deal with those issues running Neovim and our desired configurations inside a Docker container.

This project contains two Dockerfiles, located in the nvim and nvim-c directories. The first allows building a Docker image with Neovim and basic tools and configurations, while the second provides a Docker image, based on the previous one, with specific tools for C/C++ development.

The Dockerfile in the nvim directory is intended to be used as a base image. It installs tools such as Cmake, tmux, fish, and Git, as well as Neovim plugins like CoC and other AI-related ones.

The Dockerfile in the nvim-c directory, based on the nvim image, installs specific tools for C/C++ development such as Clang, Gdb, Gcov, Lcov, Ceedling, and Codechecker, among others.

This project was partially inspired by nvim-ide.

Build Docker base image

cd nvim
docker build -t nvim-ide \
             --build-arg user=$(id -un) \
             --build-arg group=$(id -gn) \
             -f Dockerfile \
             .

Build Docker image for C/C++ development

cd nvim-c
docker build -t nvim-ide:c \
    --build-arg user=$(id -un) \
    --build-arg group=$(id -gn) \
    -f Dockerfile \
    .

Usage

1. Basic use.

   cd <your-repository>
   docker run -it --rm \
       -v $PWD:/home/$(id -un)/workspace \
       -u $(id -un):$(id -gn) \
       --name nvim-ide \
       nvim-ide:c \
       nvim

2. Pass host environment variables to use AI plugins

   cd <your-repository>
   docker run -it --rm \
       -v $PWD:/home/$(id -un)/workspace \
       -u $(id -un):$(id -gn) \
       -e <LLM>_API_KEY:$<LLM>_API_KEY \
       --name nvim-ide \
       nvim-ide:c \
       nvim

3. Interact with nvim-ide mouting some dotfiles from the host machine.

   cd <your-repository>
   docker run -it --rm \
       -v ~/.bashrc:/$(id -un)/.bashrc \
       -v ~/.gitconfig:/home/$(id -un)/.gitconfig \
       -v ~/.tmux.conf:/home/$(id -un)/.tmux.conf \
       -v $PWD:/home/$(id -un)/workspace \
       -u $(id -un):$(id -gn) \
       --name nvim-ide \
       nvim-ide:c \
       fish