FAQ

What is the current state of CodeSandbox for iOS?

CodeSandbox for iOS is no longer available.

CodeSandbox is currently unable to maintain the app experience and has removed it from the App Store. This does not remove the app from your device or prevent you from opening it if you already have it installed.

Sandboxes

Why am I getting a git error resolving a dependency?

CodeSandbox for iOS is only compatible with dependencies hosted and accessible via HTTP or HTTPS.

This happens because the app doesn't provide local shell environments where you can run arbitrary commands, like git. Use the CodeSandbox web editor instead.

You may find some of the following answers helpful if you have gone through the sections in this documentation but still haven’t solved your questions:

I'm getting an error trying to run my Sandbox in CodeSandbox for iOS. What could be the cause?

The root cause of the problem could be either a coding mistake on your side or a dependency trying to do something forbidden by iOS.

For instance, dependencies relying on WebAssembly won't work, as WebAssembly requires JIT compilation to function, and this isn't allowed by the App Store guidelines.

Another cause can be that your project or one of its dependencies rely on a native dependency or Node extension, which aren’t supported.

One of the scripts in my Sandbox cannot be run. What could be the cause?

Only the scripts that start with node or the name of a dependency located inside the node_modules/.bin directory are compatible. This happens because CodeSandbox for iOS doesn’t provide a shell environment, so scripts containing an arbitrary bash command won't work.

I can't see the preview of my Sandbox in the web browser. What could be the cause?

The runtime provides a WEB_PORT environment variable matching the port used by default by the in-app web browser. If your Sandbox doesn't use the port in that environment variable, then you will need to fix the URL in the web browser to load the page on the right port.

Why does my Sandbox stop running when I move the app to the background?

This happens because iOS suspends the process while the application is in the background, which also suspends all its activity.

My Sandbox requires Node.js 14 but the app uses Node.js 12. How can I change the Node.js version?

The application uses a Node.js port that hasn’t been upgraded to Node.js 14 as we have been focused on integrating the new CodeSandbox experience instead. Stay tuned, as we will be making some updates.

Repositories

Why can't I make any changes to my project?

You likely have a protected branch selected (i.e. main). Forking a branch will create a new one where you can make changes.