SideRefresh v0.2.0-beta.2 — Apache-2.0 source preview

SideRefresh v0.2.0-beta.2 — Apache-2.0 source preview

This source-only prerelease changes SideRefresh's licensing and distribution
notices. It does not change the supported renewal workflow or add a downloadable
Mac application.

License change

• Source code and prose documentation are licensed under Apache License 2.0
  beginning with this release.
• NOTICE records project attribution.
• The SideRefresh name, logo, icons, screenshots, and other visual identity
  follow the separate brand policy.
• Versions through v0.2.0-beta.1 remain available under their original MIT
  terms; their tags and release records have not changed.
• App and Headless build outputs now include LICENSE, NOTICE, and
  BRAND_POLICY.md.

Apache-2.0 permits use, modification, commercial distribution, and private
forks. It adds an explicit contributor patent grant and requires applicable
notices and changed-file identification. It does not require forks to publish
their source.

Requirements

• macOS 13 or later.
• Xcode 16.2 or a compatible Swift 6 toolchain.
• An Apple Account Personal Team configured in Xcode.
• One physical iPhone paired and trusted in Xcode with Developer Mode enabled.
• One successful installation from Xcode before enabling automatic refresh.

Build and run

swift test
Scripts/validate-samples.sh
Scripts/build-app.sh
open dist/SideRefresh.app

The generated app is ad-hoc signed for local source builds. This prerelease has
no downloadable Developer ID-signed and notarized binary asset and does not ask
users to bypass Gatekeeper.

Scope and limitations

• One user-owned app, one Xcode project or workspace, and one paired iPhone.
• Initial pairing, trust, Developer Mode, and the first Xcode installation
  remain user-controlled prerequisites.
• Tailscale discovery is optional and experimental and does not replace Apple
  signing or CoreDevice pairing.
• No third-party IPA installation, permanent signing, fleet management,
  Xcode-free operation, or Apple Account password collection.
• No real-device compatibility claim is added by this license-only release.

Documentation and support

• License
• Brand policy
• User manual
• Distribution
• Support
• Security reporting
• Full changelog

Apple, Mac, iPhone, macOS, and Xcode are trademarks of Apple Inc. SideRefresh
is independent and is not affiliated with, endorsed by, or sponsored by Apple.

SideRefresh v0.2.0-beta.1 — source preview

SideRefresh v0.2.0-beta.1 — source preview

This is SideRefresh's first public source prerelease. It is intended for
contributors and early testers who can build a native macOS app with Xcode or
a compatible Swift 6 toolchain.

There is no downloadable Mac application in this release. GitHub's generated
ZIP and tarball are source snapshots. A Developer ID-signed and notarized
binary remains gated for the stable v0.2.0 release.

What is included

• The Simple workspace for one user-owned Xcode project and one paired iPhone.
• Guided app, Personal Team, iPhone, connection, and automatic-refresh setup.
• English and Korean app interfaces with Settings, Help, and Diagnostics in
  one window.
• Local SwiftUI app, short-lived background Agent, iOS renewal helper, CLI,
  and MCP server sharing the same renewal core.
• Privacy-reviewed source, MIT licensing, contribution guidance, support
  boundaries, and private vulnerability reporting.

Requirements

• macOS 13 or later.
• Xcode 16.2 or a compatible Swift 6 toolchain.
• An Apple Account Personal Team configured in Xcode.
• One physical iPhone paired and trusted in Xcode with Developer Mode enabled.
• One successful installation from Xcode before enabling automatic refresh.

The release candidate was validated on an Apple silicon Mac with macOS 26.6,
Xcode 26.6, and Apple Swift 6.3.3. Pull-request CI also validates the source on
GitHub-hosted macOS runners. Other compatible combinations are welcome, but
this prerelease does not claim that every macOS, Xcode, iOS, device, or network
combination has been tested.

No real iPhone, iOS version, or connection route was tested against this exact
source candidate, so this prerelease claims none as a verified combination.

Build and run

swift test
Scripts/validate-samples.sh
Scripts/build-app.sh
open dist/SideRefresh.app

The local app build is ad-hoc signed. It is for a user who builds from source;
it is not a normal downloadable binary trusted by Gatekeeper. SideRefresh does
not ask users to disable Gatekeeper or remove quarantine.

Scope and limitations

• One app, one Xcode project or workspace, and one paired iPhone.
• USB for the initial supported installation; later renewal requires a route
  already usable by Xcode.
• Tailscale discovery is optional and experimental. It does not replace Xcode
  pairing, trust, Developer Mode, or Apple signing.
• No third-party IPA installation, permanent signing, fleet management,
  Xcode-free operation, or Apple Account password collection.
• Manual and real-device acceptance remains not-run for this exact source
  candidate; only the automated source validation is recorded here.

Documentation and support

• User manual
• Personal Team setup
• Source build and removal
• Known status and limitations
• Support
• Security reporting
• Full changelog

Apple, Mac, iPhone, macOS, and Xcode are trademarks of Apple Inc. SideRefresh
is independent and is not affiliated with, endorsed by, or sponsored by Apple.