You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Duncan Ogilvie 58c7de1d60
Merge pull request #129 from build-cpp/gitignore-improvement
8 months ago
.github Add .editorconfig and linting 1 year ago
cmake Bump to 0.2.25 9 months ago
docs Document the supported languages 8 months ago
include Add .editorconfig and linting 1 year ago
src Merge pull request #129 from build-cpp/gitignore-improvement 8 months ago
tests test(relative-paths): Add the test-library file to libs 9 months ago
third_party Add workflow for checking clang-format 1 year ago
.clang-format Add .editorconfig and linting 1 year ago
.editorconfig Add .editorconfig and linting 1 year ago
.gitattributes Merge cmkrlib into the cmkr target 3 years ago
.gitignore Remove a bunch of dead code 1 year ago
CMakeLists.txt Bump to 0.2.25 9 months ago
LICENSE Create LICENSE 4 years ago Initial draft of new documentation 1 year ago
cmake.toml Bump to 0.2.25 9 months ago


cmkr, pronounced "cmaker", is a modern build system based on CMake and TOML.

cmkr parses cmake.toml files and generates a modern, idiomatic CMakeLists.txt for you. A minimal example:

name = "cmkr_for_beginners"

type = "executable"
sources = ["src/main.cpp"]

cmkr can bootstrap itself and you only need CMake and a C++ compiler to use it.

Getting started

To get started, run the following commands from your project directory:

curl -o cmkr.cmake
cmake -P cmkr.cmake

After the bootstrapping process finishes, customize cmake.toml for your project and run CMake:

cmake -B build
cmake --build build

Once bootstrapped, cmkr does not introduce extra steps to your workflow. After modifying cmake.toml you simply build/configure your CMake project and cmkr will automatically regenerate CMakeLists.txt when necessary.

Note: The cmake.toml project file, generated CMakeLists.txt and cmkr.cmake bootstrapping script are all intended to be added to source control.

In CI environments the cmkr bootstrapping process is skipped, so there is no additional overhead in your pipelines.

Template repositories

Another way to get started is to use the cmkr_for_beginners template repository. Either open it in Gitpod, or clone the repository and run:

cmake -B build
cmake --build build

Check out the cmkr topic, the build-cpp organization or the tests for more examples and templates.

Command line

Optionally you can put a cmkr release in your PATH and use it as a utility from the command line:

Usage: cmkr [arguments]
    init    [executable|library|shared|static|interface] Create a project.
    gen                                                  Generates CMakeLists.txt file.
    build   <extra cmake args>                           Run cmake and build.
    install                                              Run cmake --install.
    clean                                                Clean the build directory.
    help                                                 Show help.
    version                                              Current cmkr version.