# Safari build (WebExtension)

This extension is MV3 and can be packaged for Safari using Apple's WebExtension converter.

## Requirements
- macOS with Xcode installed
- Safari 17+ (MV3 support)

## One-time conversion
From the repository root:
```sh
xcrun safari-web-extension-converter ./extension --project-location ./extension/safari --app-name "SSForum Overlay"
```

This will generate an Xcode project in `extension/safari/`.

## Build and run
1. Open the generated `.xcodeproj` in `extension/safari/`.
2. Select the macOS host app target.
3. Run the app from Xcode.
4. In Safari: `Settings` -> `Extensions` -> enable the extension.

## Notes
- `host_permissions` is already set to `<all_urls>`; make sure to grant access to “All Websites” in Safari’s extension settings.
- If the auth popup does not open, the code falls back to `window.open()` and should still work.
