A professional, multi-target C++ project skeleton with cross-platform presets, per-library versioning, compile-time feature detection, and full tooling automation.
The full project README has been split into focused topic pages inside the docs/ directory. Use the links below to jump to what you need.
- Quick Start: docs/QUICK_START.md
- Project Structure: docs/PROJECT_STRUCTURE.md
- Embedded & Cross-Compilation Guide: docs/EMBEDDED.md
- Building: docs/BUILDING.md
- Testing: docs/TESTING.md
- Build Settings: docs/BUILD_SETTINGS.md
- Dependencies: docs/DEPENDENCIES.md
- Library Management: docs/LIBRARY_MANAGEMENT.md
- Plugins: docs/PLUGINS.md
- Project Orchestration: docs/PROJECT_ORCHESTRATION.md
- Compile-time Build Info: docs/BUILD_INFO.md
- Starting a New Project: docs/STARTING_PROJECT.md
- CLI Usage Reference: docs/USAGE.md
- Performance: docs/PERFORMANCE.md
- CI / Quality Guards: docs/CI.md
- Capabilities Reference: docs/CAPABILITIES.md
- Roadmap & Ideas: docs/ROADMAP.md
If you'd like these pages further split (for example docs/BUILDING.md → docs/VS_CODE.md, docs/PRESETS.md), tell me which area to subdivide next.
This repository's full documentation is split into focused topic pages inside the docs/ directory. The short quick-start is below — for all details, examples and the full reference, see the full document.
# Create a new project interactively
python3 scripts/tool.py new MyProject
# Or non-interactive with defaults
python3 scripts/tool.py new MyProject --non-interactiveFor an existing clone:
# 1. Install mandatory dependencies (Ubuntu/Debian)
python3 scripts/tool.py setup --install
# 2. Configure + build + test (auto-detects platform preset)
python3 scripts/tool.py build check
# 3. Run the example app
./build/gcc-debug-static-x86_64/apps/main_app/main_appFull documentation: docs/index.md | Roadmap: docs/ROADMAP.md | Capabilities: docs/CAPABILITIES.md | Embedded guide: docs/EMBEDDED.md