Test a build you just made on BugRadar’s cloud devices, without leaving your editor.
With your coding agent
Tell your coding agent (Cursor, Claude Code, etc.):
Upload my latest simulator build to BugRadar
It finds the build and uploads it for you.
With the CLI
After BugRadar login:
BugRadar builds upload MyApp.app
Works with an iOS Simulator .app, an iOS .ipa for real devices, and an Android .apk. Not sure which build you need? See Building Your App.
Xcode Archive builds are for real devices and won’t run on the Simulator. Build for a Simulator destination instead.
What an upload does
Either way, the upload becomes your app’s default build, so runs that don’t pin a build use it. It also starts the app’s CI/CD automations, which can start flow runs.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"BugRadar","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/BugRadar/mTDCZgW2I2SWs-UB/logo/light.svg?fit=max\u0026auto=format\u0026n=mTDCZgW2I2SWs-UB\u0026q=85\u0026s=ccb4d8c65c27b826c24b21c2c40eece6","dark":"https://mintcdn.com/BugRadar/mTDCZgW2I2SWs-UB/logo/dark.svg?fit=max\u0026auto=format\u0026n=mTDCZgW2I2SWs-UB\u0026q=85\u0026s=e7d9ad801e878c55ff81cab43ea6b42a","href":"https://docs.usebugradar.com"},"favicon":"https://mintcdn.com/BugRadar/tfnV7RyCfUuC94qX/logo/favicon.png?fit=max\u0026auto=format\u0026n=tfnV7RyCfUuC94qX\u0026q=85\u0026s=0010a2d74f105f6ba6f6c6fd0ba85b6c","styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"BugRadar","hasAudioNarration":false,"actualSubdomain":"BugRadar","customDomains":["docs.usebugradar.com"],"gitSource":{"type":"github","owner":"BugRadar","repo":"BugRadardashboard","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6affd0178b23d922026ced83","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Core Features","count":13},{"language":"default","tag":"APIs","count":11},{"language":"default","tag":"Integrations","count":11},{"language":"default","tag":"Getting Started","count":8},{"language":"default","tag":"Uploading Your App","count":6},{"language":"default","tag":"Code-Managed Flows","count":6},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Best Practices","count":2}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"upload-build","slug":"/upload-build","pageMetadata":{"title":"Upload a Build","description":"Send a build from your computer to BugRadar","href":"/upload-build"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Send a build from your computer to BugRadar\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Test a build you just made on BugRadar’s cloud devices, without leaving your editor.`}),`\n`,_jsx(Heading,{level:`2`,id:`with-your-coding-agent`,children:`With your coding agent`}),`\n`,_jsx(_components.p,{children:`Tell your coding agent (Cursor, Claude Code, etc.):`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Upload my latest simulator build to BugRadar`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`It finds the build and uploads it for you.`}),`\n`,_jsx(Heading,{level:`2`,id:`with-the-cli`,children:`With the CLI`}),`\n`,_jsxs(_components.p,{children:[`After `,_jsx(_components.code,{children:`BugRadar login`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`BugRadar`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` builds`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` upload`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` MyApp.app`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Works with an iOS Simulator `,_jsx(_components.code,{children:`.app`}),`, an iOS `,_jsx(_components.code,{children:`.ipa`}),` for `,_jsx(_components.a,{href:`/real-device-testing`,children:`real devices`}),`, and an Android `,_jsx(_components.code,{children:`.apk`}),`. Not sure which build you need? See `,_jsx(_components.a,{href:`/app-build-guide`,children:`Building Your App`}),`.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Xcode Archive builds are for real devices and won’t run on the Simulator. Build for a Simulator destination instead.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what-an-upload-does`,children:`What an upload does`}),`\n`,_jsxs(_components.p,{children:[`Either way, the upload becomes your app’s default build, so runs that don’t pin a build use it. It also starts the app’s `,_jsx(_components.a,{href:`/automations`,children:`CI/CD automations`}),`, which can start flow runs.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Upload a Build","description":"Send a build from your computer to BugRadar","href":"/upload-build"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"With your coding agent","slug":"with-your-coding-agent","depth":2,"children":[]},{"title":"With the CLI","slug":"with-the-cli","depth":2,"children":[]},{"title":"What an upload does","slug":"what-an-upload-does","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"BugRadar","siteName":"BugRadar","title":"Upload a Build - BugRadar","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T09:10:37.320Z","originalFileLocation":"upload-build.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Send a build from your computer to BugRadar\">\u003cmeta data-mint-head name=\"application-name\" content=\"BugRadar\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload a Build - BugRadar\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send a build from your computer to BugRadar\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BugRadar\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usebugradar.com/upload-build\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://BugRadar.mintlify.site/_mintlify/api/og/v2?division=Uploading+Your+App\u0026amp;title=Upload+a+Build\u0026amp;description=Send+a+build+from+your+computer+to+BugRadar\u0026amp;theme=cc826f7a773f7bae312a843a\u0026amp;signature=e924782e727a9eb469327569d3827497c6c43d914ac83f2399371737c6736ae7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Upload a Build - BugRadar\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send a build from your computer to BugRadar\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://BugRadar.mintlify.site/_mintlify/api/og/v2?division=Uploading+Your+App\u0026amp;title=Upload+a+Build\u0026amp;description=Send+a+build+from+your+computer+to+BugRadar\u0026amp;theme=cc826f7a773f7bae312a843a\u0026amp;signature=e924782e727a9eb469327569d3827497c6c43d914ac83f2399371737c6736ae7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BugRadar\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usebugradar.com/upload-build\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/upload-build.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usebugradar.com/#organization\",\"name\":\"BugRadar\",\"url\":\"https://docs.usebugradar.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/BugRadar/mTDCZgW2I2SWs-UB/logo/light.svg?fit=max\u0026auto=format\u0026n=mTDCZgW2I2SWs-UB\u0026q=85\u0026s=ccb4d8c65c27b826c24b21c2c40eece6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usebugradar.com#website\",\"name\":\"BugRadar\",\"url\":\"https://docs.usebugradar.com\",\"publisher\":{\"@id\":\"https://docs.usebugradar.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usebugradar.com/upload-build#webpage\",\"url\":\"https://docs.usebugradar.com/upload-build\",\"name\":\"Upload a Build\",\"description\":\"Send a build from your computer to BugRadar\",\"dateModified\":\"2026-11-11T09:10:37.320Z\",\"isPartOf\":{\"@id\":\"https://docs.usebugradar.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usebugradar.com/upload-build#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usebugradar.com/upload-build#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Uploading Your App\",\"item\":\"https://docs.usebugradar.com/bundle-id\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Upload a Build\",\"item\":\"https://docs.usebugradar.com/upload-build\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.usebugradar.com/upload-build#article\",\"headline\":\"Upload a Build\",\"name\":\"Upload a Build\",\"description\":\"Send a build from your computer to BugRadar\",\"url\":\"https://docs.usebugradar.com/upload-build\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usebugradar.com/upload-build#webpage\"},\"dateModified\":\"2026-11-11T09:10:37.320Z\",\"publisher\":{\"@id\":\"https://docs.usebugradar.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usebugradar.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BugRadar\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"BugRadar\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/upload-build.md","siteName":"BugRadar","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Intro(doc)tion","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Web Testing","href":"/web-testing"},{"title":"Mobile Testing","href":"/real-device-testing"},{"title":"MCP Server","href":"/mcp-setup"},{"title":"Install the CLI","href":"/install-cli"},{"title":"Local Testing","href":"/local-testing"},{"title":"Browse resources","href":"/resources"}]},{"group":"Core Features","pages":[{"title":"Apps","href":"/apps"},{"title":"Flows","href":"/flows"},{"title":"Suites","href":"/suites"},{"title":"Automations","href":"/automations"},{"title":"Hooks","href":"/hooks"},{"title":"Environments","href":"/environments"},{"title":"Variables","href":"/variables"},{"title":"Notifications","href":"/notifications"},{"title":"Performance Monitoring","href":"/performance-monitoring"},{"title":"Network Traffic","href":"/network-traffic"},{"title":"Issues","href":"/issues"},{"title":"Sandboxes","tag":"Beta","href":"/sandboxes"},{"title":"Team","href":"/team"}]},{"group":"Best Practices","pages":[{"title":"Writing Effective Flow Instructions","href":"/writing-effective-flow-instructions"},{"title":"Making Suites, Parallelizable, Isolated, and Repeatable","href":"/guides-parallelizable-isolated-tests"}]},{"group":"Code-Managed Flows","pages":[{"title":"Code-Managed Flows","sidebarTitle":"Overview","href":"/code-managed-flows"},{"title":"Files \u0026 Schema","href":"/code-managed-files"},{"title":"Running from the CLI","sidebarTitle":"Running from the CLI","href":"/code-managed-cli"},{"title":"Validation, Syncing \u0026 Pull Requests","sidebarTitle":"Syncing \u0026 Pull Requests","href":"/code-managed-sync"},{"title":"GitLab CI","sidebarTitle":"GitLab CI","href":"/gitlab-ci"},{"title":"Migrating Existing Flows","sidebarTitle":"Migrating","href":"/code-managed-migrate"}]},{"group":"Guides","pages":[{"title":"Multi-Device Testing","href":"/multi-device-testing"},{"title":"Testing Push Notifications","href":"/guides-push-notifications"},{"title":"Testing In-App Purchases","href":"/guides-in-app-purchases"},{"title":"Testing One-time Passwords (OTP)","href":"/guides-otp-testing"},{"title":"Testing App Clips","href":"/guides-app-clips"}]},{"group":"Integrations","pages":[{"title":"GitHub Bot","href":"/github-integration"},{"title":"Code Review","href":"/code-review"},{"title":"Jira Cloud","href":"/jira-integration"},{"title":"Linear Tickets","href":"/linear-integration"},{"title":"Slack Notifications","href":"/slack-integration"},{"title":"Grok Bot","href":"/grok-bot"},{"title":"Devin","href":"/devin"},{"title":"Dots","href":"/dots"},{"title":"Hermes Agent","href":"/hermes-agent"},{"title":"Webhooks","href":"/webhooks"},{"title":"Tailscale","href":"/private-network"}]},{"group":"Uploading Your App","pages":[{"title":"Finding Your Bundle ID","href":"/bundle-id"},{"title":"Building Your Mobile App for Our Cloud","description":"Step-by-step guide to building your mobile app for our virtual device cloud","href":"/app-build-guide"},{"title":"Upload a Build","href":"/upload-build"},{"title":"Github Action for App Uploads","description":"Automatically upload mobile builds or register web apps with BugRadar","href":"/ci-cd-integration"},{"title":"Language \u0026 region","href":"/language-and-region"},{"title":"Proxy location","href":"/run-location"}]},{"group":"APIs","pages":[{"title":"API Reference","href":"/api-reference"},{"title":"Apps API","href":"/api-apps"},{"title":"Suites \u0026 Flows API","href":"/api-suites-flows"},{"title":"Labels API","href":"/api-labels"},{"title":"Runs API","href":"/api-runs"},{"title":"Hooks API","href":"/api-hooks"},{"title":"Environment Variables API","href":"/api-env-vars"},{"title":"Members API","href":"/api-members"},{"title":"Usage API","href":"/api-usage"},{"title":"App Build Upload API","href":"/api-ci"},{"title":"Network Allowlist","href":"/network-allowlist"}]}]},"basePath":"","title":"Upload a Build - BugRadar","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}