App Generation allows you to generate a pre-built Xcode project directly from Spline ready to publish in the App Store using our Metal-based renderer.
Our Metal-based renderer enables you to bring all of the interactivity from your 3D designs made in Spline to Apple devices. It also takes full advantage of all the native performance from your Apple devices like the iPhone, iPad, or Mac.
Follow the steps below to get set up for using App Generation.
1. Sign up for an Apple ID or join the Apple Developer Program
- To get started testing your app on your devices you’ll need a free Apple ID.
- In order to publish your app on the App Store, you need to register with the Apple Developer Program.
For more information about the differences between an Apple ID and Apple Developer Program membership, refer to Apple’s documentation on Choosing a Membership.
To build your apps within Xcode, you might need a Team ID.
Learn how to find your Team ID on Apple’s documentation: Locate your Team ID.
2. Download and Install Xcode
To build your app with the Xcode project generated from Spline you’ll need Xcode. Xcode is only available for macOS.
- Download the latest version of Xcode from the Mac App Store.
- Download the latest or beta versions of Xcode from the Apple Developer website.
Follow the steps below to use native 3D embeds on your Swift projects with Spline iOS Runtime.
Spline is using the latest technologies to render 3D content on Apple Platforms.
Minimum Required OS
Minimum Required Chip
iOS 16.0 and up
A13 and up
iPadOS 16.0 and up
A13 and up
macOS 13.0 and up (via Mac Catalyst or Designed for iPad)
Experimental Support (Under Development)
Language and Libraries Support
The Spline iOS Runtime uses SwiftUI and Swift.
1. Generate an Xcode Project from Spline
- From the top toolbar, press the
Exportbutton to open the export panel;
- Under Apple Platforms, select the
- Fill in all the required settings to build your Xcode project. Refer below for more information;
- Press the Generate button.
1.1 Settings Overview
Refer to the below for more information on all the different settings related to App Generation.
The name of your app or project.
The ID of your organization or team. Best practice is to use your domain reversed.
The version of your app.
The ID of your Xcode team or organization. Refer to Team IDs section to learn more.
The way your Spline scenes will be embedded. - Cloud will load the scene via URL. - Local will download and use a .splineswift file.
The Xcode version needed to open the generated project.
Enable or disable the Spline logo. You’ll need an active Super or Super Team subscription.
Upload a 1024x1024 image to use as your app icon.
Define the orientation that your app will use. When in Auto-Rotation you’ll be able to select which orientations your app can use.
Define if your app has the status bar visible or hidden.
2. Build and run the app with Xcode
Building the app and running it is done through Xcode and can be achieved with a few simple steps.
- On Xcode, go to File > Open and select the unzipped folder with your project;
- Select your build device – you can use your physical device (iPhone, iPad, Mac) or a simulator;
- Press ▶️ to build your project.
For more information on how to build an app with Xcode, refer to Apple’s documentation on Building and Running an App.
If you don't add a Team ID from Spline, on Xcode, you might need to go into
Signing & Capabilities, under
Signing, you can add your team manually.
3. Publishing and distributing your app
For more information on publishing to the App Store, refer to Apple’s documentation on Distributing your app for beta testing and releases.
When building your app, even if the app builds properly, there are a few errors that might be displayed on the embed. Refer below to see the warnings and their explanation.
"Spline scene file is in an unknown format"
The exported file is too old, the runtime is too old, or the file might have become corrupted.
"Spline scene file URL could not be reached"
It’s displayed when the runtime fails to download a
.splineswift file from the web. It can be because of an invalid URL, or just a non-functioning network connection.
Feature Support Roadmap
Full coverage of all Spline features for Metal Renderer is expected to be ready in Q1 2024, here is a list of the current status for each feature. This list will be updated weekly until everything is fully supported.
Parametric 2D Shapes
Parametric 3D Shapes
Non-Parametric 3D Shapes
3D Paths, Lathe, and Subdiv Meshes are baked (Temporarily) - Full support coming soon
Video Layer support coming soon. Some settings in the Outline layer are not supported (yet).
Work In Progress Game Controls, Variable Change, Distance, State Change, Trigger Area, and Collision events are coming soon
Work In Progress As of today, only Transition, Open Link and Sound actions are supported. Full-support coming soon
Only the Main Scene will be exported
Export Native Embeds for iOS
Another way to export your 3D content for Apple Platforms like iOS, is by using native embeds with a Swift code snippet.
Learn more about