{"slug":"build-failures","title":"Fix a failed build","summary":"Read the reason on the build, use Fix with AI for code problems, fix signing in Publish and Build, then retry. Failed builds are never charged.","body":"A failed build stays in the platform's history with a title and an explanation. Nothing is charged.\n\n## The two buttons\n\n- **Fix with AI** starts a chat turn with the build's redacted diagnostics, so the assistant can repair the project files. The log never contains secrets.\n- **Retry build** runs the same kind of build again. Use it after a fix, or when the failure looked temporary.\n\n## Common causes\n\n| What you see | Likely cause | What to do |\n| --- | --- | --- |\n| A compile or bundling error | Code the preview tolerates but the native build does not, or an incompatible native package | **Fix with AI**, then retry |\n| iOS archive failed | A native module or project setting Xcode rejects | **Fix with AI**; the assistant reads the Xcode log |\n| iOS signing error | Missing or expired certificate, or a profile for a different bundle ID | Upload the right certificate or profile. See [iOS certificates and profiles](/docs/ios-signing) |\n| Build queue is full | Many builds are waiting on the workers | Retry after an active build finishes |\n| Project source changed while queuing | An edit landed as you started | Start the build again |\n| Native builds temporarily unavailable | Build workers are down | Try later, or contact support with the build reference |\n\n## Upload failures\n\nIf **Send to TestFlight** or **Send to Play** fails, the release in **Publish**, **Releases** shows **failed** and a **Retry** button. The build itself is fine; you do not need to rebuild. Common reasons are a missing store account, an app that does not exist yet in Play Console, or a build number the store has already seen. See [Troubleshooting](/docs/troubleshooting).\n\n## Still stuck\n\nSend a support request with the project name and the build reference shown on the failed build. See [Get help](/docs/get-help).","sectionSlug":"native-builds","sectionTitle":"Build for devices","updatedAt":"2026-09-23T22:51:25.250Z","previous":{"slug":"install-on-device","title":"Install and test on a device"},"next":{"slug":"publishing-overview","title":"Publishing overview"}}