Getting Started

Using Xcode Export to Start a New Project

By using Judo's built-in Export to Xcode feature, you can get started quickly with an iOS app project automatically built around your project.

Export to Xcode can be handy not only for bootstrapping a new app, but also for quickly building running prototypes from Judo projects.


You will need to install Xcode, Apple's integrated development environment and SDK for iOS development. You can download Xcode from the Mac App Store or from the Apple Developer site.

Export to Xcode from Judo

Within Judo, click the Share button in the top right of the toolbar, and select "Export to Xcode". You will be prompted for a target folder, and then Judo will generate a template Xcode project around your Judo file and place it there.

After exporting, Judo will open Finder for you to the directory where your new Xcode project was created. Double click to open it.

Your new project serves as a turnkey prototype right out of the box, and you can immediately run your project in an iOS simulator using the play button in Xcode's toolbar.

Updating the Judo file in your project

Once you've exported to a new Xcode project, a copy of your Judo file was made and placed within it. You will need to update it with any future changes. Either you can make changes directly in the Judo file in your project (right click on the Judo file right in Xcode and use the external editor feature to open it directly in Judo) or you can replace it with an updated copy from elsewhere.

Adopt the workflow that best suits your use case.

Introducing JudoView

The Judo template project is a standard Xcode project with a few additions: the Judo SDK SwiftPM dependency (just as it would be had it been set up manually in an existing project), your Judo file included within the project and added to the target (to include it in the app's bundle where the Judo SDK can find it at runtime), and a ContentView.swift file that includes a JudoView SwiftUI view. This is the view that is responsible for rendering your UI.

JudoView will select and display the artboard marked as "prototype start point" in your Judo file by default.