Support

Get BestBrowser running cleanly

Use this page for install, build, and troubleshooting basics. For deeper internals and contributor workflow, use the GitHub wiki and repository docs.

Requirements

macOS 26 or newer
Xcode 26.4.1 or newer
Swift 6.3+
Apple Intelligence enabled on a supported Mac for AI features

Current Release

Quick local verification

cd /Users/jeremymcvay/dev/bestbrowser-native
swift build
./test.sh
./build.sh
open /Users/jeremymcvay/dev/bestbrowser-native/BestBrowser.app

Packaging problems

Re-run the full packaging path from the repo root:

cd /Users/jeremymcvay/dev/bestbrowser-native
./build.sh

Database reset

If local persistence gets into a bad state during testing:

rm -f ~/Library/Application\ Support/com.bestbrowser/bestbrowser.db

AI unavailable

BestBrowser now uses Apple’s on-device Foundation Models path rather than external providers. If AI features are unavailable, confirm Apple Intelligence is supported, enabled, and finished preparing on the current Mac.

Where to go deeper

The GitHub wiki covers product surfaces, development workflow, architecture, and troubleshooting in more depth than this support page.