Skip to content

Releases

peek 0.2.1

Choose a tag to compare

@kimikr kimikr released this 15 Nov 21:53

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.xcassets no longer stops the build (SwiftPM needs Xcode's actool for 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) and Image(.name) showed nothing on iOS 27 for images peek ships. They are now loaded through UIImage.
  • Translations. String catalogs (.xcstrings) become .strings and .stringsdict files, 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 .xcframework used by both the app and a dependency is linked once; C++ in remote dependencies links libc++; 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

Choose a tag to compare

@kimikr kimikr released this 15 Nov 11:33

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 (body included), 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. .xcframework targets 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:).
  • DocumentGroup apps preview with one new document.
  • Crash screen shows the last output the build printed (a fatalError message, 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

Choose a tag to compare

@kimikr kimikr released this 15 Nov 02:19

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 peek script 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 doctor checks 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 peek in ~/.local and 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

Choose a tag to compare

@kimikr kimikr released this 14 Nov 22:31

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.