Skip to content

SideRefresh v0.2.0-beta.1 — source preview

Pre-release
Pre-release

Choose a tag to compare

View all tags
@recrack recrack released this 06 Aug 13:54
· 1 commit to master since this release
Immutable release. Only release title and notes can be modified.
v0.2.0-beta.1
3857c93
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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

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.

Assets 3
Loading