Skip to content

Add macOS build instructions#115

Open
furiousdbd wants to merge 1 commit into
GabrieleGiuseppini:masterfrom
furiousdbd:docs/macos-build
Open

Add macOS build instructions#115
furiousdbd wants to merge 1 commit into
GabrieleGiuseppini:masterfrom
furiousdbd:docs/macos-build

Conversation

@furiousdbd
Copy link
Copy Markdown

What

Adds BUILD-macOS.md and UserSettings.example-macos.cmake, giving macOS the same build documentation that already exists for Linux (BUILD-Ubuntu.md) and Windows (BUILD-Windows.md). Addresses #32.

Details

  • Verified on macOS 26 ("Tahoe") on Apple Silicon (arm64), using Homebrew for the prerequisite libraries.
  • Uses Homebrew's sfml@2 formula — the current sfml formula is 3.x, whose API is incompatible.
  • The original macOS build recipe was worked out by @matschaffer (https://gist.github.com/matschaffer/87220798c79a5d0ace1eaa9afb729d28). These docs update it for the current dependency set: DevIL is no longer a dependency, and SFML is now taken from Homebrew rather than built from source.

Note

A clean build also requires the dependent-template-name fix in #114 — recommend merging that first, or together.

Document building Floating Sandbox on macOS, addressing the
long-standing issue GabrieleGiuseppini#32. Adds BUILD-macOS.md and a matching
UserSettings.example-macos.cmake template, alongside the existing
Linux and Windows examples.

Verified on macOS 26 (Apple Silicon) using Homebrew for the
prerequisite libraries. The original macOS build recipe was worked
out by @matschaffer (gist 87220798c79a5d0ace1eaa9afb729d28); this
updates it for the current dependency set (DevIL is no longer
required; SFML is taken from Homebrew's sfml@2).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant