Modern C++ template using CMake with a library target, CLI app target, and test target.

Status

• Stage: Draft | Active | Stable | Deprecated
• Owner:
• License:
• Visibility: Public | Private | Internal
• Reason:
• Promotion criteria to Public:

What This Project Is

• A clean starter for C++ projects that need predictable structure and CI.
• Not a full framework or opinionated application architecture.

Use This Template

1. Click Use this template on GitHub to create a new repository.
2. Rename package/module identifiers and update ownership metadata.
3. Review .env.example and update environment configuration for your target project.
4. Run validation and CI checks before first release.

Quickstart

Prerequisites

• CMake >= 3.20
• C++20 compiler

Build, Test, Run

cmake -S . -B build -DENABLE_TESTS=ON -DBUILD_APPS=ON
cmake --build build
ctest --test-dir build --output-on-failure
./build/ProjectName_cli

Formatting Enforcement

git config core.hooksPath .githooks

clang-format -i apps/project_name_cli.cpp include/project_name.hpp src/project_name.cpp tests/test_placeholder.cpp

Repository Layout

• include/ public headers
• src/ library implementation
• apps/ executable entrypoints
• tests/ test targets
• docs/ project documentation
• examples/ optional sample programs
• tools/ helper scripts

Documentation

• Overview
• Architecture
• ADRs

Contributing

See CONTRIBUTING.md.

Advanced Models

For multi-model C/C++ architectures (library/executable families, engine-app splits, multi-lib workspaces, and addon plugins), use repo-template-cpp-family.