Getting Started

Get rootfont up and running on your Mac in minutes.

Requirements

• macOS 14+ (Sonoma or later)
• Apple Silicon or Intel Mac
• Xcode 15+ with macOS SDK (for building from source)
• Swift 6.0+ (Swift 6.2+ recommended)

Install from Release

Download the latest .app bundle from GitHub Releases.

1. Download RootFont.app.zip from the latest release
2. Unzip and move RootFont.app to /Applications
3. Open rootfont — if macOS blocks it, go to System Settings → Privacy & Security and allow it

Build from Source

First, ensure your toolchain is set up correctly:

xcode-select -p
# Expected: /Applications/Xcode.app/Contents/Developer

# If needed:
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

Then clone and run:

git clone https://github.com/rootfont/rootfont
cd rootfont
swift run RootFontApp

Build .app Bundle

bash scripts/build-app.sh

This produces .build/app/RootFont.app with version, build number, and git SHA in the Info.plist.

Run Tests

swift test

Requires XCTest from Xcode. If you see "no such module 'XCTest'", switch xcode-select as shown above.

Optional: Git Hooks

bash scripts/install-git-hooks.sh

Installs hooks that run localization and version-metadata checks on commit.