MayaFlux itself does not require external IDEs or large SDK bundles. Weave installs all internal framework dependencies across all supported platforms.

However, some operating systems enforce their own compiler toolchains. This is not a MayaFlux design choice, it is how those platforms are structured.

Linux

Linux behaves as expected:

• A C/C++ compiler
• Standard C/C++ libraries

On supported distributions, these are already present or installed via the system package manager. Weave installs MayaFlux-specific dependencies automatically.

No IDE required. No heavyweight SDK required.

Windows

Windows requires Microsoft's toolchain.

You must install:

• Visual Studio 2022
• The "Desktop development with C++" workload

How to Install

1. Download Visual Studio 2022 from Microsoft
2. Run the installer
3. Select Desktop development with C++
4. Complete installation

This requirement is enforced by Windows' compiler ecosystem. MayaFlux uses MSVC on Windows because that is the officially supported toolchain.

Yes, this is a large installation. No, MayaFlux cannot replace Microsoft's compiler.

macOS

macOS requires Apple’s toolchain.

You must install:

• Xcode Command Line Tools

How to Install

xcode-select --install

Follow the system dialog to complete installation.

Apple does not allow third-party compilers to fully replace the system toolchain. MayaFlux uses Clang via Apple's command line tools because that is how macOS is designed.

Important Clarification

Weave installs:

• MayaFlux libraries
• Vulkan components
• Internal runtime dependencies
• Project templates

It does not replace or bundle:

• Microsoft’s compiler on Windows
• Apple’s compiler on macOS

Those ecosystems require their own development toolchains. Linux remains the only platform where a minimal compiler + standard library setup is sufficient.

Install

1. Download and open Weave-macos.dmg
2. Double-click Weave.app
3. If macOS shows “unverified developer”:
   • Close dialog
   • System Settings → Privacy & Security
   • Find Weave → Open Anyway
4. Choose “Install MayaFlux”
5. Select a release channel and follow the prompts
6. Restart your terminal when done

Prerequisites

• macOS 15.0 (Sequoia) or later

Contents

• MayaFlux via Homebrew
• CLI tool (~/.local/bin/weave)
• Environment configured in ~/.zshenv

Create & Build a Project

weave new MyProject ~/Projects/

cd MyProject && mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --parallel
./MyProject

📘 Full guide: macOS Documentation

Install

tar -xzf Weave-X.X.X-linux.tar.gz -C ~/.local/
~/.local/Weave-X.X.X/Weave

Supported Distributions

• Arch Linux (pacman)
• Fedora >= 43 (dnf)
• Ubuntu (25)/Debian (ci build)
• openSUSE (ci build)

Mode Selection

• Install MayaFlux — first-time setup
• Create Project — if MayaFlux already installed

Supported Behaviours

• Arch Linux: installs mayaflux-dev-bin from AUR
• Fedora 43+: installs from COPR
• Ubuntu 25+, openSUSE Tumbleweed, others: downloads MayaFlux locally into ~/MayaFlux

Requires: GCC 15+, LLVM 21+, GLFW 3.4+

Create & Build

GUI:

~/.local/Weave-X.X.X/Weave

CLI:

weave new MyProject ~/Projects/

Build:

cd MyProject && mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --parallel
./MyProject

📘 Full guide: Linux Documentation

Install

1. Right-click → Run as Administrator

2. Accept UAC prompt

3. Choose a mode:

   • Install MayaFlux
   • Create Project

4. Installer performs:

   • System checks

   • Download MayaFlux (~1.5 MB)

   • Launch Vulkan SDK installer

     • Install all components except ARM

   • Install dependencies (~90 MB of DLLs)

   • Configure environment variables

5. Restart your terminal

6. Run Weave again and select Create Project

Prerequisites

• Windows 10 or later (64-bit only)

Create & Build

Weave.exe   # then select "Create Project"

cd MyProject
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release
.\Release\MyProject.exe

📘 Full guide: Windows Documentation