Install

1. Download the .pkg file
2. Double-click to open
3. If macOS shows “unverified developer”:
   • Close dialog
   • System Settings → Privacy & Security
   • Find Weave.pkg → Open Anyway
4. Run installer normally
5. A Terminal window will open and complete setup
6. When it closes, Weave is ready

Prerequisites

• Apple Silicon: macOS 14.0 (Sonoma) or later
• Intel: macOS 15.0 (Sequoia) or later

Contents

• Weave.app and CLI (~/.local/bin/weave)
• MayaFlux via Homebrew
• Environment variables 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