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 f17923c18b
Bump to 0.2.18
9 months ago
.github Document template targets 2 years ago
cmake Bump to 0.2.18 9 months ago
docs Add documentation for the [variables] section 9 months ago
include Preserve backwards compatibility 9 months ago
src Preserve backwards compatibility 9 months ago
tests Fix the tests 10 months ago
third_party prelim vcpkg manifest support 2 years ago
.clang-format Update the formatting to now allow functions on a single line 1 year ago
.gitattributes Merge cmkrlib into the cmkr target 2 years ago
.gitignore Minor improvements 10 months ago
CMakeLists.txt Bump to 0.2.18 9 months ago
LICENSE Create LICENSE 3 years ago Initial draft of new documentation 9 months ago
cmake.toml Bump to 0.2.18 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.