What is refrax-browser?

Refrax is a web browser for macOS, built entirely in Swift using Apple's native WebKit rendering engine. It targets macOS 26 and later, requires Xcode 26 and Swift 6.2 to build, and uses SwiftUI for its interface with a visual style described as Liquid Glass. The browser is free and open source under the GNU General Public License version 3, which means you can study, modify, and share the code. The Refrax name and icon are trademarks and are not covered by that license: anyone distributing a modified version must rebrand and use a different name and icon. Builds and updates are distributed from the project website rather than through this repository. Internally, the browser organizes browsing through Tabs that can hold multiple TabPages, stored with SwiftData for persistence. The WebPage type wraps WKWebView, Apple's component for displaying web content, and a pool manages those views so they are created on demand rather than up front. The SwiftUI layer sits on top, consuming shared state through environment injection with a Manager pattern. The repository also contains a headless command-line tool called refrax-ctl for controlling the browser programmatically, a widget extension, a shared Swift package used by both the app and the CLI, and build scripts for generating color palettes. The project layout uses folder references in Xcode rather than Xcode groups, so files are added and removed on disk. Building requires setting your own code-signing identity in Xcode, since signing is not preconfigured in the public repository. CloudKit sync also needs your own iCloud container identifier. A setup script handles the first-time installation of SwiftFormat, SwiftLint, and a pre-commit hook.