HealkiteDocs

PR previews

Testers open a link (or scan a QR code) and the app they installed from the store switches to a pull request's code, with a banner to go back. No TestFlight build, no waiting.

Set up the app

  1. Set your app's URL scheme in the dashboard: Settings → PR previews (for example myapp).
  2. Pass incoming links to Healkite and render the banner:
tsx
import { Linking } from "react-native";
import Healkite, { PreviewBanner } from "@healkite/react-native";

Linking.addEventListener("url", ({ url }) => Healkite.openPreview(url)); // false for other links
Linking.getInitialURL().then((url) => url && Healkite.openPreview(url));

export default function App() {
  return (
    <>
      {/* your app */}
      <PreviewBanner />
    </>
  );
}

Publish a preview

From CI with the GitHub Action (it comments the link on the PR), or:

sh
npx healkite preview --from <channel-key> --name pr-123 -p android -r 1.0.0 -d "New checkout"
npx healkite preview --from <channel-key> --name pr-123 --close

Previews show up in the dashboard's Previews tab with a QR code. Closing one sends testers back to the normal channel; a new store build always starts on its normal channel.