How do I ask for help for a Build Error?

Browser Build

If you’re building Loop using the Browser Build, then the best place to look for help is on the Errors with Browser page.
If you are still unsuccessful, then post your request for help along with your GitHub username, or better yet, provide a link to your Actions URL.  For example, if you are building Loop, your Actions URL would look like this

https://github.com/username/LoopWorkspace/actions

Just copy/past this URL into your browser and then substitue your actual GitHub username.  Mentors can go to your public GitHub repository, check the status and view your log files directly.

  • Do not copy from the log file and post the words
  • Do not take a screenshot of what you think is an error.  Your actual error is not “Exit code 1”.  We promise.
  • Just post your GitHub username or link to your Actions URL and the name of the app that you are trying to build

Mac Build

If you’re building Loop using the Mac Build, verify that you’re using a minimum versions of macOS and Xcode to enable you to build for the iOS version on your phone. Check Version Updates for the latest requirements.  If you’ve already satisfied these minimum requirements, then the best place to look for help is on the Build Errors page.

That page can be a little intimidating, so we’ve added some bite-sized links to the page to help you navigate.

Still having a build error – and you’ve done your best and need help – please ask – but please follow these instructions for how to ask:

Not providing these details will make troubleshooting more time-consuming.  Volunteers with limited time to assist may scroll by your post hoping that someone else will respond. You will still get help even if you’re missing information, but it will definitely take longer.

Finally, here are the links to start looking for specific errors for:

Post on Social Media

Pick one place to post.  Be sure to indicate whether you’re using the Browser Build or Mac Build.  Wait and give the mentors at that site time to get back to you.

Do not create multiple posts about your build.  It creates confusion for you and for the community’s volunteer troubleshooters.  What seems like multiple different issues to you may be related, so stick with one post on one site.

Once you start accepting help from an individual, stick with that ONE person until you have exhausted that path. It is very frustrating for a volunteer to be trying to help someone, and you try two other things in the middle of them helping you that blows-out the steps that they were trying to walk you through, so they have to start again.  If that volunteer runs out of time, timezone or expertise, they will tag someone else to assist.

If someone helps you, make sure to give them feedback: Did it fix your problem, are you still stuck?   Are you thankful for the help? And if you post on Facebook, please edit the original post – at the very top – and add the word “Resolved”.  That lets the mentors know they don’t need to help you AND it lets others with the same problem know the solution can be found in the comments of your post. If you feel very ambitious, edit your post to say “Resolved” with a summary of what fixed the problem.

Skip to content