Skip to content

docs: add IPA sideloading guide - #45

Merged
saksham2001 merged 2 commits into
saksham2001:mainfrom
rgvxsthi:docs/sideloading-guide
Jul 5, 2026
Merged

saksham2001 merged 2 commits into
saksham2001:mainfrom
rgvxsthi:docs/sideloading-guide

Conversation

@rgvxsthi

@rgvxsthi rgvxsthi commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

What this does

Adds a Sideloading the IPA page to the docs (Getting Started section),
covering how to sign and install the pre-built release IPA from PR #39 without
Xcode. Wired into the nav and linked from the iOS page.

Methods covered

  • Sideloadly (simplest one-shot desktop install)
  • AltStore (auto-refresh over Wi-Fi via AltServer)
  • SideStore (on-device refresh, iloader + LocalDevVPN, per-OS install tabs for macOS/Windows/Linux/Chromebook, plus LiveContainer for the 3-app limit)
  • Feather / ESign (on-device, certificate-based)
  • TrollStore (permanent, version-limited)
  • Paid Developer + Xcode (widgets + 1-year signing)

Key points

  • Leads with the App Group caveat: a free Apple ID strips
    group.xyz.sakshambhutani.pulseloop2, so the Home Screen widgets and the Live
    Activity / Dynamic Island won't work on free-signed builds. The core app (ring
    sync, vitals, sleep, coach, workouts, GPS) is unaffected and does not crash.
    A paid Developer account provisions the App Group and enables those features.
  • Free-ID limits (7-day expiry, 3-app cap) and the burner-Apple-ID
    recommendation are called out per method.
  • SideStore steps follow the current official flow (iloader + LocalDevVPN) and
    point to docs.sidestore.io as the source of truth.
  • Security note on only importing certificates you trust.

Notes

  • All external links were HTTP-checked. Anchors validated via mkdocs build --strict.
  • The download links resolve once a release carries a PulseLoop-<tag>.ipa
    asset. New releases build it automatically via the workflow from Add Release IPA workflow for sideload builds #39; the
    existing beta release can be back-filled with a manual Actions → Release
    IPA → Run workflow
    dispatch (tag beta) at your discretion.

🤖 Generated with Claude Code

radxp and others added 2 commits July 5, 2026 12:48
Add a Getting Started page covering how to sign and install the pre-built
release IPA without Xcode: Sideloadly, SideStore (iloader + LocalDevVPN,
per-OS install), AltStore, Feather/ESign, TrollStore, and paid Developer
signing. Documents the App Group entitlement caveat (free Apple ID strips it,
so widgets and the Live Activity require a paid cert) and the LiveContainer
extension limitation. Wire it into the nav and link it from the iOS page.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Correct the LiveContainer repo URL (was 404) and swap the dead trollstore.app
link for the ios.cfw.guide install guide. Reword the LiveContainer widget note
to 'not expected to work / untested' rather than stated as fact. Remove all
em-dashes from the sideloading guide and the iOS-page tip.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rgvxsthi
rgvxsthi requested a review from saksham2001 as a code owner July 5, 2026 02:50
@saksham2001
saksham2001 merged commit d50b7c8 into saksham2001:main Jul 5, 2026
4 checks passed
@rgvxsthi
rgvxsthi deleted the docs/sideloading-guide branch July 5, 2026 04:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants