◉RORK LABJP
●TOOLING — Rork's developer repos keep moving: rork-xcode was updated on July 16, rork-device on July 15, and rork-plist on July 13●OPUS46 — Claude Opus 4.6 is live in Rork, and Rork Max is built to assemble apps on top of Claude Code●SIM — A cloud iOS simulator runs in the browser, with one click to install on a device and two clicks to publish to the App Store●MAX — Rork Max emits pure Swift rather than React Native, reaching iPhone, iPad, Apple Watch, Apple TV, Vision Pro, and even iMessage●NATIVE — That opens up HealthKit, ARKit and LiDAR, NFC, Dynamic Island, Live Activities, 3D through Metal, and on-device inference with Core ML●SEED — Rork raised a $15M seed led by Left Lane Capital, with Peak XV and a16z Speedrun joining the round●TOOLING — Rork's developer repos keep moving: rork-xcode was updated on July 16, rork-device on July 15, and rork-plist on July 13●OPUS46 — Claude Opus 4.6 is live in Rork, and Rork Max is built to assemble apps on top of Claude Code●SIM — A cloud iOS simulator runs in the browser, with one click to install on a device and two clicks to publish to the App Store●MAX — Rork Max emits pure Swift rather than React Native, reaching iPhone, iPad, Apple Watch, Apple TV, Vision Pro, and even iMessage●NATIVE — That opens up HealthKit, ARKit and LiDAR, NFC, Dynamic Island, Live Activities, 3D through Metal, and on-device inference with Core ML●SEED — Rork raised a $15M seed led by Left Lane Capital, with Peak XV and a16z Speedrun joining the round
← Back to Blog

Getting Started with Rork Companion — Test Your Apps on a Real iPhone Without an Apple Developer Account

Rork Companiondevice testingiPhoneRork Maxapp development

Introduction

You've just built something with Rork. The next thing you want to do is obvious — see it running on your actual iPhone.

Traditional iOS development makes this surprisingly difficult. You'd typically need to install Xcode (a 30GB+ download), wrestle with provisioning profiles and certificates, configure TestFlight, and pay $99 per year for an Apple Developer account. That's a lot of friction when all you want to do is tap your app on a real screen.

Rork Companion changes this entirely. It's a Mac app that lets you install up to three Rork-built apps on your iPhone using just a USB cable. No Xcode. No Developer Program enrollment. No headaches.

In this guide, we'll walk through the complete setup process and share practical tips for getting the most out of real-device testing.

What Is Rork Companion?

Rork Companion is an official desktop application from Rork, designed for macOS. It acts as a bridge between the Rork web editor and your physical iPhone, allowing you to install and run your apps directly on the device.

Here's what makes it compelling:

Free testing without a Developer account. You can install up to three apps on your iPhone using just a free Apple ID. This is a game-changer for indie developers who are still in the exploration phase and aren't ready to commit to the $99/year Apple Developer Program.

No Xcode required. You won't need to download or configure Xcode at all. Rork Companion handles the entire installation process on its own — no certificates, no provisioning profiles, no build configurations.

A streamlined workflow. Build your app in Rork's web editor, connect your iPhone, and install. That's it. The entire process takes minutes, not hours.

Setting Up Rork Companion

1. What You'll Need

Before getting started, make sure you have:

  • A Mac (any model running a recent version of macOS)
  • An iPhone (the device you'll test on)
  • A USB cable (Lightning or USB-C, depending on your iPhone model)

Rork Companion is currently Mac-only. If you're on Windows or Linux, you'll need to rely on Rork's browser-based simulator for now.

2. Installing the App

Download Rork Companion from Rork's official website. Installation follows the standard macOS pattern — drag the app to your Applications folder, and you're done.

3. Enabling Developer Mode on Your iPhone

To install apps outside of the App Store, your iPhone needs Developer Mode enabled. Here's how:

  1. Open the Settings app on your iPhone
  2. Navigate to Privacy & Security
  3. Scroll down and toggle Developer Mode on
  4. Your iPhone will ask to restart — follow the prompts

If you don't see the Developer Mode option, make sure your iPhone is running iOS 16 or later.

4. Installing Your App

With everything set up, the installation process is straightforward:

  1. Launch Rork Companion on your Mac
  2. Connect your iPhone via USB
  3. If prompted, tap Trust on your iPhone to trust the connected Mac
  4. Your Rork-built apps will appear in the Companion interface
  5. Select an app and click Install

Within about thirty seconds, the app icon will appear on your iPhone's home screen. Tap it, and you're in.

What to Look For During Real-Device Testing

Testing on a physical device reveals things that simulators simply can't replicate. Here are the key areas to focus on:

Touch interactions. Are buttons easy to tap with a finger? Does scrolling feel smooth and natural? Do swipe gestures respond the way you intended? These are things you can only truly assess with your hands on the screen.

Performance. Simulators run on your Mac's hardware, which is typically much more powerful than a phone. Apps that feel snappy in the simulator might lag on an actual device, especially if they involve heavy image processing or complex animations.

Native device features. Push notifications, camera access, location services, and motion sensors can only be properly tested on real hardware. If your app relies on any of these, simulator testing alone isn't sufficient.

Layout and display. Check that your UI looks correct on your specific device's screen size. Pay attention to the notch area, Dynamic Island (on newer iPhones), and the home indicator bar at the bottom. These are common spots where layout issues hide.

Why This Matters Even More for Rork Max Users

If you're building with Rork Max — which produces native Swift apps — real-device testing becomes even more critical.

Rork Max gives you access to Apple's native frameworks and APIs: ARKit for augmented reality, HealthKit for health data, Metal for 3D graphics, Dynamic Island, Live Activities, Siri Intents, and more. Most of these features either don't work in simulators or behave differently than on real hardware.

For example, an AR app built with ARKit needs a real camera and real-world environment to test properly. A HealthKit integration needs access to actual health data (or at least the Health app on a real device). Metal 3D rendering may perform completely differently on actual iPhone GPU hardware versus a simulated environment.

In these cases, Rork Companion isn't just convenient — it's essential.

Limitations to Keep in Mind

Rork Companion is a powerful tool, but it does have some boundaries:

Three-app limit. With a free Apple ID, you can have up to three apps installed at a time. To test a fourth, you'll need to remove one of the existing ones.

App Store publishing still requires a Developer account. Companion is for testing only. When you're ready to ship, you'll need an Apple Developer Program membership ($99/year). The good news is that Rork Max streamlines the submission process significantly with its 2-click publish feature.

Mac required. There's no Windows or Linux version of Companion at this time. If you don't have access to a Mac, the browser-based simulator in Rork is your best alternative.

Seven-day expiration. Apps installed via a free Apple ID may expire after seven days and require reinstallation. If you're in an active development cycle, this is worth keeping in mind.

A Practical Development Workflow

Here's the development cycle we recommend when incorporating Rork Companion into your process:

  1. Build and iterate in the Rork web editor, using the browser simulator for quick feedback loops
  2. Install on your iPhone via Companion once a feature set is functionally complete
  3. Test touch interactions, performance, and native features on the real device
  4. Note any issues — layout problems, performance bottlenecks, gesture quirks
  5. Return to the web editor to refine and fix, then repeat

The key is to use the browser simulator for rapid iteration and reserve real-device testing for validation. This keeps your development speed high while ensuring quality where it matters most.

Wrapping Up

Rork Companion fills a gap that has frustrated indie developers for years: the ability to quickly test an app on a real iPhone without jumping through Apple's traditional hoops.

Whether you're exploring Rork for the first time or actively building with Rork Max, having a real device in your testing workflow makes a meaningful difference. Interactions that seem fine in a simulator can feel completely different when you're actually holding the phone.

If you haven't tried real-device testing yet, give Rork Companion a shot. You might be surprised by what you discover.