Troubleshooting

Find your symptom, not the subsystem. Each entry says what’s actually happening and where to fix it.

#Deploy and production

“does not support production web hosting yet”: the template is frontend-only. The Website template publishes local previews only until static hosting lands; deploy to production from a backend template (App or Game). See Deploy targets.

Production logs are empty: the Health pane streams managed logs from Cloudflare’s Workers Observability telemetry. When that access isn’t configured for the deployment, the pane says so; read its Worker and Durable Object stats instead.

Deleting a deployment didn’t take the site down: delete only clears history from the pane. It does not unpublish the live URL.

Production looks different from my preview: the deploy is almost always running older files. Confirm the change is on main and the Dev preview is correct, then redeploy. See Inspect production.

#iOS

A signed build won’t start: “no live web deployment to bake as the app backend” means TestFlight and App Store builds need a production backend. Deploy web first, then build.

TestFlight / App Store lanes are disabled: connect Apple with Launch with Apple and finish app identity and metadata in Project Settings → iOS/App Store. External TestFlight also needs a beta-review contact and Apple’s one-time review before the public link works.

#GitHub sync

Installing the GitHub app didn’t connect my project: installing from the Marketplace alone doesn’t attach a repo. Link the repo in Project Settings → GitHub and install from that flow so the install carries your project.

GitHub sync didn’t create PR previews: branch sync and rnx PR previews are different features. Sync pushes branches and PRs; previews are set up separately in rnx.

A preview check is green but no preview opened: a green workflow check isn’t proof. Check the PR’s sticky comment for the preview URL and open it directly.

#Account and AI

AI asks me to verify my email or sign in with GitHub: AI needs a verified identity: a verified email or a connected GitHub account.

A model request asks me to upgrade to Pro: Free runs the included fast model; frontier models require Pro. See Account and billing.

Pro stopped working after a payment problem: Pro cloud access requires an active subscription. Fix billing in the portal and access returns.

My anonymous project moved after I signed in: signing in migrates your anonymous work onto your account and lands you back on it. Nothing was lost.

#Preview and data

The web preview is blank or stale: reload the preview pane. If it’s still stale, clear its storage from the pane actions (LocalStorage, IndexedDB, Caches) and reload.

There’s no native preview: native preview only appears when the project targets iOS, so web-only projects (like the Website template) have no iOS pane. Enable iOS in Project Settings → Runtimes to turn on the native preview and iOS deploy options. See Previews.

Native preview says “stopped responding”: the liveness watchdog lost the render. Reload the native pane to recover.

Schema changes didn’t take effect: apply them from the Run menu: Generate rebuilds the schema, Migrate applies the diff, Restart restarts the runtime. See Data generation.

You can’t edit while watching an agent: the editor is read-only with a watch banner while you follow an agent’s session. Return to your own branch to edit. See Branches.

A package works on web but breaks the native preview: check its native support at rnxsim.com/conformance. rnx implements the native side, and some packages are partial, stubbed, or unsupported.

For agent behavior (a stuck agent, work that won’t land), start from Agents.