Prerequisites

Required Tools

  • Monomcs compiler + mono runtime
  • clang++ — C++ compiler with C++17 support
  • Vulkan SDK — Vulkan headers, validation layers, and glslc shader compiler
  • GLFW — windowing and input library
  • GLM — OpenGL Mathematics library

macOS (Homebrew)

# Install Mono
brew install mono

# Install Vulkan SDK (includes glslc, MoltenVK)
brew install --cask vulkan-sdk

# Install GLFW and GLM
brew install glfw glm

Verify everything is installed:

mcs --version        # Mono C# compiler
mono --version       # Mono runtime
glslc --version      # Shader compiler
brew list glfw glm   # Libraries

Optional — IDE IntelliSense

For C# autocomplete, go-to-definition, and error checking in VS Code (or other IDEs), install the .NET SDK and run:

dotnet restore

This generates the project assets that the C# language server needs. The .sln and .csproj are for IDE support only — the actual build uses mcs via the Makefile.

Windows & Linux

Work in Progress

Windows and Linux builds are not yet supported. See the cross-platform roadmap for planned support.

Key Paths (macOS / Homebrew)

DependencyHeadersLibraries
Vulkan/opt/homebrew/include/vulkan//opt/homebrew/lib/
GLFW/opt/homebrew/include/GLFW//opt/homebrew/lib/
GLM/opt/homebrew/include/glm/(header-only)
MoltenVK ICD/opt/homebrew/etc/vulkan/icd.d/MoltenVK_icd.json