Dockerfile

FROM ubuntu:22.04

ENV DEBIAN_FRONTEND=noninteractive

# --- Core C++ toolchain -----------------------------------------------
#   build-essential  -> gcc/g++, make, etc.
#   cmake            -> build system
#   gdb              -> debugger
#   pkg-config       -> lets CMake/Makefiles find installed libraries
#
# --- Example domain libraries (swap for whatever your project needs) --
#   libopencv-dev    -> OpenCV, image/video processing
#   libeigen3-dev    -> Eigen, linear algebra (common in robotics/SLAM/CV)
#
# --- GUI forwarding requirements ---------------------------------------
#   x11-apps         -> provides `xeyes`, our end-to-end smoke test
#   xauth            -> lets the container read/verify the X11
#                        authentication cookie mounted in at runtime
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    cmake \
    gdb \
    pkg-config \
    libopencv-dev \
    libeigen3-dev \
    x11-apps \
    xauth \
    && rm -rf /var/lib/apt/lists/*

# Note: libopencv-dev pulls in a large dependency tree (codecs, image/video
# libraries, etc.) and can take several minutes to install the first time,
# especially inside Docker Desktop's WSL2 backend. This is normal — once
# built, this layer is cached and future rebuilds skip it entirely unless
# you change the package list above.