How to create a new Xcode project without Storyboard

When you create a new project in Xcode, the default boilerplate includes the Main.storyboard. If you are going with a no storyboard approach and want to set everything up in code, there are a few steps you need to take.

Pre Xcode 11

Everyone should be on Xcode 11 by now, but I will add this here for completeness.

Remove Main.storyboard

Delete the Main.storyboard file and make sure you select the "Move to trash" option to remove it completely.

Remove reference to Main.storyboard

1. Click on your project root level on the left panel
2. Select your app target
3. Click the General tab
4. Under the Deployment Info section, you will find the Main Interface field
5. Delete "Main" and leave it blank

Create the main window

If the application has a Storyboard set as the Main Interface, the window property will automatically be initialized, and its root view controller will be set to the storyboard's initial view controller. Since we already removed it, we need to initialize window and set rootViewController manually. Before Xcode 11, we do this in appDelegate.

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    let window = UIWindow(frame: UIScreen.main.bounds)    
    window.rootViewController = ViewController() // Your initial view controller.
    window.makeKeyAndVisible()
    self.window = window
    return true
}

That's all.

You can easily support sarunw.com by checking out this sponsor.

AI Grammar: Correct grammar, spell check, check punctuation, and parphrase.

Try it for Free

Xcode 11

To support multiple windows in iOS 13, Xcode 11 boilerplate is a little bit different than in Xcode 10. The most noticeable change is the introduction of the new SceneDelegate.

Remove Main.storyboard

The first step is the same, delete Main.storyboard file and make sure you select the "Move to trash" option to completely remove it.

Remove reference to Main.storyboard from Deployment Info

1. Click on your project root level on the left panel
2. Select your app target
3. Click the General tab
4. Under the Deployment Info section, you will find the Main Interface field
5. Delete "Main" and leave it blank

Remove new Info.plist key-value, UISceneStoryboardFile

Removing "Main" from Main Interface is not enough. You have to delete another reference to Main.storyboard hidden inside Info.plist

Open your Info.plist

1. Click the arrow at the leftmost of Application Scene Manifest (UIApplicationSceneManifest) key to expand
2. Click the arrow at the leftmost of Scene Configuration (UISceneConfigurations) key to expand
3. Click the arrow at the leftmost of Application Session Role (UIWindowSceneSessionRoleApplication) key to expand
4. Click the arrow at the leftmost of First Item (Item 0) key to expand
5. Remove the key Storyboard Name (UISceneStoryboardFile)

If you want to do it in your text editor, search for UISceneStoryboardFile and remove both key and value.

<key>UISceneStoryboardFile</key>
<string>Main</string>

Create the main window

Just like in Xcode 10, we need to initialize window and set rootViewController manually. This time we do it in SceneDelegate.

From this:

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let _ = (scene as? UIWindowScene) else { return }
}

To this:

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
  
    let window = UIWindow(windowScene: windowScene)
    window.rootViewController = ViewController() // Your initial view controller.    
    window.makeKeyAndVisible()
    self.window = window
}

You can easily support sarunw.com by checking out this sponsor.

AI Grammar: Correct grammar, spell check, check punctuation, and parphrase.

Try it for Free

Related Resources

• Learn how to create a new iOS 12 project in Xcode 11