https://github.com/chalet-org/chalet
A cross-platform JSON-based project & build tool
https://github.com/chalet-org/chalet
build build-system build-tool c clang clion command-line cplusplus cpp cpp17 cpp20 cross-platform gcc json msvc visual-studio visual-studio-code xcode
Last synced: about 1 month ago
JSON representation
A cross-platform JSON-based project & build tool
- Host: GitHub
- URL: https://github.com/chalet-org/chalet
- Owner: chalet-org
- License: other
- Created: 2021-01-16T18:13:27.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2026-02-02T04:08:03.000Z (about 2 months ago)
- Last Synced: 2026-02-02T08:41:14.748Z (about 2 months ago)
- Topics: build, build-system, build-tool, c, clang, clion, command-line, cplusplus, cpp, cpp17, cpp20, cross-platform, gcc, json, msvc, visual-studio, visual-studio-code, xcode
- Language: C++
- Homepage: https://www.chalet-work.space
- Size: 21.9 MB
- Stars: 123
- Watchers: 5
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://www.chalet-work.space)
A cross-platform project format & build tool for C/C++ focused on usability and interoperability.
[](https://github.com/chalet-org/chalet/releases)
[](https://github.com/chalet-org/chalet/blob/main/LICENSE.txt)
[](https://github.com/chalet-org/chalet/discussions)
[](https://github.com/orgs/chalet-org/repositories?q=chalet-example)
## Introduction
Chalet is a command-line application that reads from a JSON or YAML project file, and compiles your C/C++ projects. Behind the scenes, Chalet performs a variety actions based on the type of project and the strategy requested by the user. It can build natively using its own system, or utilizing: [Ninja](https://ninja-build.org/), [Make](https://en.wikipedia.org/wiki/Make_(software)), [MSBuild](https://learn.microsoft.com/en-us/cpp/build/msbuild-visual-cpp?view=msvc-170), and [Xcode(build)](https://developer.apple.com/xcode/). Chalet project files focus on intuitive language designed to be easy to understand, while at the same time providing lots of control. Because the projects are JSON, they can be easily integrated with IDEs and other types of tooling, but depending on the compiler, Chalet also generates workspace/project files for [Visual Studio](https://visualstudio.microsoft.com/), [Xcode](https://developer.apple.com/xcode/), [CLion](https://www.jetbrains.com/clion/), [Visual Studio Code](https://code.visualstudio.com/), [Zed](https://zed.dev/) and [Code::Blocks](https://www.codeblocks.org/).
Visit [https://www.chalet-work.space](https://www.chalet-work.space) to learn more about Chalet.
Visit [https://www.chalet-work.space/docs](https://www.chalet-work.space/docs) for the full documentation.
Explore some of the example repositories at: [https://github.com/orgs/chalet-org/repositories?q=chalet-example](https://github.com/orgs/chalet-org/repositories?q=chalet-example)
## Download
Grab the latest version from [https://www.chalet-work.space/download](https://www.chalet-work.space/download) or the [Releases](https://github.com/chalet-org/chalet/releases) section of this repository.
The actual release builds are still being fine-tuned, especially on Linux, so there may still be issues on various Linux distros.
## License
Chalet is released under the [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause) license. See [LICENSE.txt](LICENSE.txt).
## External Libraries that make Chalet possible
- [JSON for Modern C++](https://github.com/nlohmann/json) - [MIT license](https://github.com/nlohmann/json/blob/develop/LICENSE.MIT)
- [JSON schema validator for JSON for Modern C++](https://github.com/pboettch/json-schema-validator) - [MIT license](https://github.com/pboettch/json-schema-validator/blob/main/LICENSE)
- [fmt](https://github.com/fmtlib/fmt) - [MIT license](https://github.com/fmtlib/fmt/blob/master/LICENSE.rst)
- [stduuid](https://github.com/mariusbancila/stduuid) - [MIT license](https://github.com/mariusbancila/stduuid/blob/master/LICENSE)
- [Catch2](https://github.com/catchorg/Catch2) - [BSL-1.0 license](https://github.com/catchorg/Catch2/blob/devel/LICENSE.txt)
## Build from Source
If you would like to build from source, and track the latest changes as they come out, please review the [COMPILE.md](COMPILE.md) document.
## Contributing
If you would like to contribute, please review the [CONTRIBUTING.md](CONTRIBUTING.md) document.