Repository navigation
Releases
peek 0.2.1
Install / update
curl -fsSL https://raw.githubusercontent.com/kimikr/peek/main/scripts/install.sh | sh
peek doctor
On the phone, install Peek-0.2.1.ipa with SideStore or AltStore, or add it to LiveContainer. Check it with sha256sum -c Peek-0.2.1.ipa.sha256. The 0.2.0 app still works with this script, but translations need the 0.2.1 app.
Every 0.2 feature has now been checked on an iPhone (iOS 27): hot patching, C/Objective-C/C++ and .xcframework dependencies, colour sets, asset symbols, image sets, string catalogs and DocumentGroup.
Fixes
- Asset catalogs in packages. A package target with an
Assets.xcassetsno longer stops the build (SwiftPM needs Xcode'sactoolfor those). SwiftPM now only builds the dependencies; peek compiles the previewed target itself, unpacks its.xcframeworks and assembles its resource bundle. First builds are faster too. - Images.
Image("name"),Image("name", bundle: .module)andImage(.name)showed nothing on iOS 27 for images peek ships. They are now loaded throughUIImage. - Translations. String catalogs (
.xcstrings) become.stringsand.stringsdictfiles, plurals included. The Peek app now lists every language iOS offers, so previews show your translations in the phone's language. - iOS 16 deployment targets. Packages that target iOS 16 or older failed to build; they are now compiled for iOS 17, which the Peek app needs anyway.
- Dependency errors. A failed dependency build is reported instead of silently previewing the old code. Errors are shorter, without colour codes, and no longer include SwiftBuild's dump of your environment variables, which could contain secrets.
- Local macros build again; an
.xcframeworkused by both the app and a dependency is linked once; C++ in remote dependencies linkslibc++;Color(.red)keeps meaning the system red.
Known limits: a dependency (not the previewed target) with an asset catalog or a string catalog can't be built on Linux.
peek 0.2.0
Install / update
curl -fsSL https://raw.githubusercontent.com/kimikr/peek/main/scripts/install.sh | sh
peek doctor
On the phone, install Peek-0.2.0.ipa with SideStore or AltStore, or add it to LiveContainer. Check it with sha256sum -c Peek-0.2.0.ipa.sha256.
What's new
- Hot patching. When an edit only changes function bodies (
bodyincluded), peek sends a small patch instead of a new build, and the view keeps its@State. Body edits on real apps reload in 1–3 s. Changes to the shape of a type still do a full build. - C, Objective-C and C++ dependencies. C-family targets built by SwiftPM are imported through their module maps;
.interoperabilityMode(.Cxx)is supported and the C++ standard library is linked when needed. - Binary dependencies.
.xcframeworktargets work, both static libraries and dynamic frameworks (signed and sent to the phone once). - Colour sets and asset symbols. Colour sets from asset catalogs (light and dark) work without compiling
Assets.car, and so do the symbols Xcode generates:Color(.brand),.foregroundStyle(.brand),Image(.logo),UIColor(resource:),UIImage(resource:). DocumentGroupapps preview with one new document.- Crash screen shows the last output the build printed (a
fatalErrormessage, say).
Protocol change: the 0.2.0 app and script only work with each other. Update both; the app tells you if they don't match.
peek 0.1.1
Install / update
curl -fsSL https://raw.githubusercontent.com/kimikr/peek/main/scripts/install.sh | sh
peek doctor
On the phone, install Peek-0.1.1.ipa with SideStore or AltStore, or add it to LiveContainer. Check it with sha256sum -c Peek-0.1.1.ipa.sha256.
What's new
- Faster package edits. Changing a source file in a SwiftPM dependency now rebuilds only the dependencies, not the previewed app target as well. On a ~3,800-line app, a package edit went from 11 s to 5 s.
- Version check. The app and the
peekscript now tell each other their versions. If they don't match, the app says so instead of failing silently. The 0.1.0 app still works with this script. peek doctorchecks the toolchain, iOS SDK, ldid, signing certificate and its expiry, network addresses, the dev server, connected phones and their app versions, and runs a test build.- Install script that sets up
peekin~/.localand downloads ldid if it's missing. - Low-memory warning. Every reload keeps the previous build loaded; when memory runs low, the menu dot turns orange and offers to quit Peek so the next launch starts fresh.
Use the IPA from the same release as the peek script.
peek 0.1.0
First release.
Install the app: download Peek-0.1.0.ipa and install it with SideStore or AltStore (they sign it with your Apple ID), or add it to LiveContainer. The IPA is unsigned.
On your Linux machine: clone this repository and run ./peek dev <your app>. You need xtool's Swift toolchain and Darwin SDK, ldid and openssl (see the README).
Check the download against Peek-0.1.0.ipa.sha256:
sha256sum -c Peek-0.1.0.ipa.sha256
Use the IPA from the same release as the peek script: other versions may not be able to talk to each other.