Embedding SwiftUI Views in Storyboard-Based macOS Apps

December 23rd, 2021

⏱ Reading Time: 6 mins

Developing macOS apps using SwiftUI can be both a quite pleasant, as well as a pretty annoying task. And that because SwiftUI makes it so interesting and quick to create user interfaces, but on the other hand it lacks of various capabilities on macOS. So, it’s often necessary to bring AppKit in SwiftUI, and to build custom things in order to fill the gaps that we discover along the way of the implementation process.

However, what about the opposite case? What if we want to bring SwiftUI in AppKit based projects? You might be wondering why we would want to do this, but there are a couple of good reasons explaining it. At first, we might have apps already built using storyboards and AppKit, and we plan to make the transition to SwiftUI over time; a way to achieve this could be by replacing certain parts of the app with SwiftUI views in future updates. Or, we might want to make new apps keeping the flexibility that storyboards and AppKit provide in specific aspects, and use SwiftUI to implement other sections of the user interface.

No matter what the case is, it’s really easy to bring SwiftUI to storyboard based apps and enjoy the benefits it has to offer. This can be done in two ways; either to embed SwiftUI views as NSViews, or as view controllers. The former is what I’m discussing in this post, demonstrating it through a quite simple example.

Preparing the ground

So, to get started, suppose that we have the following view controller where its interface is designed in the app’s main storyboard:

View controller in storyboard with a view containing a button titled Host SwiftUI view and a custom view that will work as a container view.

The view controller’s view contains only a button, and a custom view right above it. The purpose of the button is to embed a SwiftUI view; it’s going to be a subview of the custom view.

In the respective view controller source file, an IBOutlet property is connected to the custom view, and an action method to the button; the latter will be called when clicking on the button.

Embedding the SwiftUI view

The first step towards embedding a SwiftUI view into an NSView is to import the SwiftUI framework in the source file where all that is going to happen:

There is a specific class that does the actual job of embedding a SwiftUI view; an instance of it is an NSView, which we can use normally like any other NSView object. But the really interesting thing with it is the fact that it accepts a SwiftUI view instance as argument upon initialization. That is the NSHostingView class:

DemoView is a SwiftUI view that contains just a an animated image and a couple of text views, while demoView is a NSView object. We can add it to the container view as a subview, exactly as we would be doing with any other NSView instance:

In addition, we can also set any constraints necessary:

All the above few lines of code go in the hostSwiftUIView(_:) action method, which is connected to the only button in the view controller’s view:

As you understand, the real deal is happening in the first line only where the NSHostingView instance is being initialized. All the rest is just code that places the embedded SwiftUI properly in the interface.

You can see the result of the above simple implementation right next:

Animated GIF with a button that gets clicked and the SwiftUI view displayed in the container view. The app window is resized.

Also, here’s the implementation of the SwiftUI view that I called DemoView in this example:

The above is a great success, because with just a minimum amount of effort we managed to bring SwiftUI in AppKit! However, you’ll notice that there is something that does not feel right in the previous illustration; the window is resized when the SwiftUI view is added to the container view. Most probably, you won’t want that to happen, so let’s fix it.

Providing a size

The SwiftUI view does not have a specific size, and its content is what actually defines its height. The width is adapted to the window’s width. In order to avoid window resizing, it’s necessary to provide a specific size to the SwiftUI view, or at least a minimum size, so the window won’t be able to be resized less than that.

There are two ways to achieve that. The first is to hardcode the values of the width and height we want for the view. But that’s not so flexible; it would be much better to have the SwiftUI view accept the desired size as argument at initialization time. That way, we can set an arbitrary size which the SwiftUI view will adopt dynamically at runtime.

In order to make the second approach work, it’s necessary first to declare the following property in the DemoView struct (the SwiftUI view):

Then, we apply the given size to the outermost container view using the frame view modifier like so:

Note: Instead of setting the exact width and height as shown here, you might need to set the idealWidth and idealHeight in conjunction to the min and max width and height values that are being demonstrated next.

With the above two moves, the SwiftUI view will get any size that we will provide it with; no more resizing automatically depending on the view’s contents.

In addition, we can also set a minimum width and height for the view, so it won’t go less than these:

It might happen sometimes the window containing a SwiftUI view not to be able to increase its size when trying to resize it, depending on where and how we embed that view. The solution to that is to specify a max width and height for the SwiftUI view, setting the infinity value to both:

Back to the view controller again, and to the hostSwiftUIView(_:) action method where we embed the SwiftUI view. The only thing that changes here is the new requirement we just introduced; to provide a specific size for the SwiftUI view at the moment we initialize it.

What should be that size? That’s easy, we’ll set the size of the container view as shown right next:

The window now keeps its original size when the SwiftUI view appears:

Animated GIF with a button that gets clicked and the SwiftUI view displayed in the container view respecting window size.


Embedding SwiftUI views in storyboard based projects can make development process a much more interesting and funny task. At the same time, it can lead to less code in order to create the desired user interface. If you already have or plan to make macOS apps based on storyboards, then it’s worth considering to create part of the interface in SwiftUI. As you have found out in the previous lines, it’s really fast and painless to achieve it, and chances are that your future self will probably appreciate it more than you think.

Thank you for reading, and happy coding! ????????

Stay Up To Date

Subscribe to my newsletter and get notifiied instantly when I post something new on SerialCoder.dev.

    We respect your privacy. Unsubscribe at any time.