Quickstart

Set a custom working directory

By default, Xcode builds and runs all projects in a separate directory; ~/Library/Developer/Xcode/DerivedData/. This isn’t an issue for iOS apps, but it means that your Alchemy app won’t be able to access important assets in your project such as an .env file or a Public/ directory.

Fortunately this is simple to fix. You just need to tell Xcode to build and run your app in the root directory of your project: Command + Shift + < -> Run -> Options -> select 'Use custom working directory:' -> enter the root directory of your project.

Accessing hidden files

You’ll likely be configuring your Alchemy app with a .env file. Xcode is unable to edit or view hidden files (files prefaced with a .). When it comes time to work with these files, you’ll need to use a text editor that can access them such as Visual Studio Code.

Install the official Visual Studio Code extension for Swift .