Errors that occur during project generation

Here are all of the errors that might occur during project generation together with a suggested solution for each one.

A good checklist to follow that might help you troubleshoot the issues:

Make sure you have installed Xcode (15.3 or later)
Make sure you have installed Node.js
You have an active, stable internet connection without a VPN.
Make sure you have granted SwiftyLaunch system access if prompted. - we need to run multiple commands in your terminal to make generate a new project for you, as well as access your GitHub credentials to fetch dependencies on your behalf.
Make sure your system isn't running in safe mode.
Make sure you aren't running low on disk space and memory.
Make sure you are running SwiftyLaunch on macOS Ventura 14.0 or later.
If you are running a beta version of macOS, or test SwiftyLaunch's generated app on beta versions of iOS, please don't spam us with messages that something isn't working. We are doing our best to fix these issues as soon as possible and always prepare an updated, stable SwiftyLaunch version as soon as the new macOS or iOS versions are out of beta.
Make sure you aren't blocking network requests with tools like Little Snitch or similar.
Make sure SwiftyLaunch can find your Xcode App. It has to be located at /Applications/Xcode.app and be named Xcode.app and be selected as the active Xcode version by running sudo xcode-select -s /Applications/Xcode.app in your terminal.

If you have repeated the steps above and the issue still persists, you can:

Try restarting your Mac
Try reinstalling SwiftyLaunch
Try generating a new project in a different path
Try changing the selected module combinations
Reset Xcode Package Caches by in Xcode: File -> Packages -> Reset Package Caches
Clean derived data by running rm -rf ~/Library/Developer/Xcode/DerivedData

Error: Couldn't find Xcode in /Applications OR Couldn't locate Xcode's Info.plist

We couldn't locate Xcode on your machine. Make sure it is installed, located in /Applications, is named 'Xcode.app' and is selected as default by running sudo xcode-select -s /Applications/Xcode.app in your terminal.

Error: Make sure Node.js is installed on your system

Couldn't locate a Node.js (Version 18 - 22) executable on your system. Make sure it is installed via brew or downloaded from nodejs.org (opens in a new tab) and try again. We look for it in following locations:

/usr/local/bin/node
/opt/homebrew/bin/node
/usr/local/opt/node@18/bin/node
/usr/local/opt/node@19/bin/node
/usr/local/opt/node@20/bin/node
/usr/local/opt/node@21/bin/node
/usr/local/opt/node@22/bin/node

Error setting up AIKit

We had an issue setting up AIKit with the Whisper AI model. Please check if the Whisper model is installed on the Additional Components tab in SwiftyLaunch's settings. If the issue persists, generate a new project with AIKit disabled.

Internal Error 102

We had an error creating a temporary folder for the project generation. This can happen on systems with very strict security settings. Make sure you have granted SwiftyLaunch all the required system access when prompted.

Internal Generation Error 105

General error during the project generation. Reasons for this error can be different. Please refer to the checklist in the beginning of this document and try to resolve the issue. If you have repeated the steps above and the issue still persists, please contact us.

Interal Error 106

Couldn't prepare project template. Upgrade SwiftyLaunch to the latest version. If the issue persists, contact us.

Internal Error 107

Error finalizing the project after it was generated. Try generating a new project.

Internal Error 108

Error moving the project to the selected destination. Try generating a new project in a different location.

Internal Error 114

There was an issue preparing files of a module. Try changing the selected modules.

Internal Error 115

Error formatting the project after it was generated. Try again.

Internal Error 116

Error during project clean up. Try generating a new project.

Internal Error 117

Error adding BackendKit to the project. Try generating a new project with BackendKit disabled.

Internal Error 119

Error decoding required project resources. This can happen if the project resources were not found or were corrupted. Try reinstalling SwiftyLaunch. If the issue persists, contact us.

Internal Error 122

Error adding BackendKit to the project. Try generating a new project with BackendKit disabled.

Internal Error 124

We couldn't locate the resources that are required to generate your project. Try reinstalling SwiftyLaunch. If the issue persists, contact us.

Internal Error 125, 126

Couldn't generate the project with the selected modules or deployment target version. Try changing the selected modules or deployment target version.

Internal Error 127, 128

Internal Error 129

Error that happens from the inability to clean up a project without BackendKit. Try generating a new project with BackendKit enabled.

Internal Error 130, 131, 132

Error setting up project's assets. Try generating a new project.

Internal Error 133

We couldn't generate your project because you have not agreed to Xcode's license agreement terms. Please open Xcode and agree to the terms before trying again. If you can't find it, check out this StackOverflow answer (opens in a new tab).

Incorrect App Icon Firebase Functions returns UNAUTHENTICATED error