Modern C++20 project template with CMake, Google Test, and Ninja.

Required:

• CMake 3.25+ (brew install cmake)
• C++20 compiler (GCC 10+, Clang 10+, MSVC 2019+)
• Ninja (brew install ninja)

Optional (targets degrade gracefully if missing):

• clang-format -- for make format / make format-check (included with Xcode)
• clang-tidy -- for make tidy / make tidy-fix (brew install llvm on macOS)
• lcov + genhtml -- for make coverage
• pre-commit -- for git hooks (pip install pre-commit)

Google Test is fetched automatically by CMake (no install needed).

make build    # generate + build
make test     # run all tests
make run      # run the application

CMakeLists.txt              # main cmake config
Makefile                    # convenience wrapper
cmake/                      # cmake modules (ClangTools, CodeCoverage)
src/
  common/include/           # shared headers
  foo/                      # library module
    include/ src/ tests/
  app/                      # application
    src/

Off by default. Enable via CMake options:

cmake -B .build -DENABLE_ASAN=ON     # AddressSanitizer (memory errors)
cmake -B .build -DENABLE_TSAN=ON     # ThreadSanitizer (data races)
cmake -B .build -DENABLE_UBSAN=ON    # UndefinedBehaviorSanitizer

1. Create the directory structure:

src/mymodule/
  CMakeLists.txt
  include/mymodule.h
  src/mymodule.cpp
  tests/
    CMakeLists.txt
    tests.cpp

2. Add add_subdirectory(mymodule) to src/CMakeLists.txt.

3. Update app_binaries in the Makefile if the module produces an executable.

Update the clearly marked PROJECT SETTINGS sections:

• CMakeLists.txt -- project() name and version
• Makefile -- app_binaries paths

Everything else (build targets, cmake modules, test infrastructure) is generic boilerplate.

MIT