SwiftUI Needs to Get Schwifty

Building Twine, my first impression of SwiftUI was “wow, this is pretty neat”: it’s easy to build the interface you want, and complex things like animations are elementary. And I just love Swift as a language. You can tell it was designed by Apple. Since the honeymoon phase, though, I’ve been increasingly dissatisfied with the SwiftUI development experience. I list my reasons down below, mostly as a form of therapy. My thoughts are based on my experience with React in VS Code and Java in IntelliJ.

Xcode is slow and bloated

I’m just gonna say it right out the gate: Xcode is painful to use. I cannot figure out why Apple doesn’t just let people bring their own editors. It’d be easier to cope with other issues if I could use VS Code.

For one, everything is slow: there’s a lag of 3 seconds between typing something and the suggestions and warnings showing up, even on my M1 Pro machine. I’m sure this is due to complex Swift compiler reasons that I’m not privy to, but I still expect better in 2022. VS Code is snappier while using less memory, even though it’s built on Electron. Even JetBrains IDEs outdo Xcode on performance, while managing to not be 12 GB downloads.

Xcode also makes everything fiendishly complicated. The version control pane is so poorly designed that I still haven’t quite figured out what all the icons mean, and I seldom have any idea what I’m committing. By comparison, I was able to use the Git pane in VS Code from day one.

My criticisms may be unfair. Many of Xcode’s features predate their modern equivalents in VS Code and the like, so it’s easy to criticize them even though they may have been groundbreaking when they were released. But perhaps that means it’s time for Apple to rebuild Xcode in line with modern metaphors. The first thing they should do is provide command line tools to build and run iOS projects. This would provide first-class support for developing outside Xcode.

SwiftUI APIs aren't stable

The React team is great with API stability: React code written 3-4 years ago still mostly works now. This API stability has important effects downstream: it means you can get by on React blog posts from 2017 even if they don’t reflect current best practices like hooks. And you don’t have to worry too much about breaking changes when using libraries. Things mostly Just Work. Hey, isn’t that Apple’s thing?

SwiftUI is the opposite. You search for an obscure problem and paste in something from Stack Overflow, and odds are Xcode tells you that what you pasted is deprecated. This is more than just annoying—it means people writing SwiftUI tutorials and answering questions on Stack Overflow are documenting a moving target.

Further, simple things like auto-resizing text boxes haven’t made their way into SwiftUI yet. I needed these in Twine; conveniently enough, they do not exist. Instead, you have to resort to a hack that layers a text box on top of a “ghost” text view. It's not a particularly elegant hack either, since you have to add magic numbers to align things correctly.

This thread on /r/apple echoes a lot of my thoughts. As someone in the thread mentioned, it feels like I’m beta testing SwiftUI.

The docs are incoherent

One of the most annoying things about SwiftUI is that you constantly have to Sherlock your way through a patchwork of one-line API docs, videos from WWDC, and half-baked examples. If you’re looking up aMethodThatDoesSomething(handler:), consider yourself lucky if the documentation says:

aMethodThatDoesSomething(handler:) does something, accepting a handler.

The incoherent docs haven’t gone unnoticed: On Apple’s Piss-Poor Documentation by Casey Liss does a great job of covering all the issues. (Hacker News thread here.)

What does the SwiftUI team need to do to fix the docs? For one, it could start by adding examples to every method and writing guides for common patterns like state management. (There are a few guides and examples, but they're pretty contrived. Moreover, they tell you how you should do things without addressing why.)

---

SwiftUI needs a lot more investment from Apple. I’m guessing the SwiftUI team is aware of these issues, but there’s organizational baggage preventing them from solving them. As things stand, it seems Xcode is bound to collapse under the weight of the features that keep getting strapped to it with every release. I don’t expect that its demise will be well documented.