Toolkit Package Manager

Toolkit Package Manager is a cross-platform C/C++ dependency management system designed to serve CMake projects.

It is not a replacement for CMake, Ninja, Visual Studio, Xcode, or any native build backend. Its job is to restore source, archive, local, or prebuilt dependencies; build dependency artifacts when needed; write a lock file for reproducibility; and generate CMake integration files that your normal CMake project can consume.

Project status

Toolkit Package Manager is under active development.

Current validation scope:

• Desktop platforms are the current tested target.
• Windows desktop workflows are the most exercised path.
• Linux and macOS are intended cross-platform targets but should be validated per project.
• Android toolchain profiles are supported and will continue to be tested.
• iOS support is planned but not implemented yet.

Core workflow

# Check the local environment
tpkg doctor

# Detect local C/C++ and platform toolchains
tpkg sdk detect
tpkg sdk list

# Restore dependency sources and artifacts
tpkg restore --config debug --toolchain windows-msvc-x64

# Generate CMake integration files
tpkg generate --config debug --toolchain windows-msvc-x64

A normal project keeps using CMake:

include("${CMAKE_SOURCE_DIR}/.tpkg/generated/cmake/tpkg_deps.cmake")

Minimal tpkg.deps.lua

package("ExampleApp")
version("0.1.0")
default_config("debug")
default_platform("host")
default_arch("x64")

require("fmt", {
    source = "https://github.com/fmtlib/fmt.git",
    ref = "10.2.1",
    build = "cmake",
    cmake = {
        options = {
            FMT_DOC = false,
            FMT_TEST = false
        }
    },
    artifacts = {
        include_dirs = {"include"},
        libs = {"fmt"}
    }
})

Documentation

Start here:

• Documentation index
• Getting started
• Basic workflow
• DSL overview
• Command reference
• Architecture overview
• Contributor guide

Repository layout

src/tpkg/          Toolkit Package Manager implementation
cmake/             CMake project glue
docs/              User, reference, architecture, and contributor docs
examples/          Example dependency manifests and project layouts
tests/             Unit and integration-style tests
scripts/           Local helper scripts

License

This snapshot preserves the existing project copyright notice. See LICENSE.