⚠️⚠️⚠️ BREAKING CHANGE: Build System Migration from Make to CMake⚠️⚠️⚠️

[Ryan-Millard]

Hi everyone,

This is a pinned notice about an upcoming breaking change to the project’s build system (which is scheduled for 22 December 2025). Please read carefully before the related PR (#93) is merged into main.

What’s Changing

• The project has migrated from a Makefile to CMakeLists.txt as the primary build system.
• Old make commands will no longer work.
• All development, builds, and CI workflows now rely on CMake:

cmake -S . -B build
cmake --build build

Why This Change

• Improves cross-platform support, especially for Windows users.
• Enables IDE integration (VS Code, CLion, Visual Studio).
• Avoids shell-specific issues and inconsistencies with Make.
• Aligns with modern OSS practices for scalability and maintainability.

Related discussion and PR:

• PR: fix: improve Windows support for npm scripts #93 – Improve Windows support for npm scripts
• Original issue: Better support for Windows #80 – Better support for Windows

Action Required for Contributors

1. Update your local workflow to use CMake commands above.
2. Test your platform and environment to ensure builds succeed. Tip: pull the code from fix: improve Windows support for npm scripts #93 onto your machine and make sure you can get it running.
3. If you have scripts or dependencies tied to make, consider refactoring to CMake (currently, there aren't many and they are being handled).
4. Leave comments or questions on this issue or the PR if you anticipate problems.

Timeline

• PR fix: improve Windows support for npm scripts #93 will not be merged immediately.
• Please review and provide feedback within the next 48–72 hours or as soon as possible.
• After feedback is addressed, the PR will be merged.

Makefile Stub

To prevent confusion, a Makefile stub like the below that clearly instructs developers will be merged into main soon:

all:
	@echo "❌ Make is no longer supported."
	@echo "✅ Use CMake instead: cmake -S . -B build && cmake --build build"