Support matrix
This page describes the pinned Treefall SDK release-preview boundary. “Supported” means the surface is built, SDK-owned checks run, and the installed package is consumed through documented targets in required qualification. Source compilation alone does not promote a device backend.
Release tiers
Section titled “Release tiers”| Surface | macOS | Windows | Linux |
|---|---|---|---|
| Host-neutral core, session, transport, routing, analysis, writer, and input | Supported | Supported | Supported |
| Installed CMake package and documented target catalog | Supported | Source/package validation only | Supported |
| Dummy audio driver | Supported | Supported | Supported |
| CoreAudio device backend | Supported on Apple platforms | Unavailable | Unavailable |
| WASAPI device backend | Unavailable | Source/fake-test capable only; not release-supported | Unavailable |
| ASIO device backend | Unavailable | Optional source-only integration requiring a separately supplied SDK; excluded from install/export | Unavailable |
| ALSA device backend | Unavailable | Unavailable | Not implemented |
| JACK device backend | Unavailable | Unavailable | Not implemented |
| PipeWire device backend | Unavailable | Unavailable | Not implemented |
Important: the generated Windows target entry for WASAPI does not make WASAPI release-supported. It records source and fake-runtime capability only; package/ABI and physical-device evidence are still required for promotion. Likewise, Linux has no production device backend. The only advertised Linux driver is Dummy, while ALSA, JACK, and PipeWire remain separate future providers.
Toolchains and package minimum
Section titled “Toolchains and package minimum”The package minimum is CMake 3.22 and a compiler with C++20 support. Required qualification uses Apple Clang with libc++ on macOS, Visual Studio 2022 MSVC with vcpkg x64-windows on Windows, and GCC with libstdc++ on Linux. Architectures and toolchain versions outside that matrix may work but are not release-qualified until added to required qualification.
The host-neutral package surface includes Treefall::core, Treefall::diagnostics, Treefall::audio_utils, Treefall::audio_io, Treefall::routing, and Treefall::transport. Consumers must test target presence in the discovered package or query runtime capabilities; do not infer target availability from a platform label.
Device promotion rules
Section titled “Device promotion rules”CoreAudio is the shipped production device backend on Apple platforms. WASAPI remains source/fake-test capable but not release-supported. ASIO requires a separately supplied vendor SDK and is source-only, never part of install/export/catalog artifacts. No production ALSA, JACK, or PipeWire provider is claimed. A backend becomes supported only after its package, ABI, backend conformance, and real-device acceptance evidence satisfy the release gate.