swiftui-appkit-interop

Community

Bridge SwiftUI and AppKit for macOS apps.

AuthorLaughingJackalope
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill solves the common friction developers face when combining AppKit and SwiftUI in macOS applications, eliminating the need to rewrite entire legacy AppKit codebases to adopt modern SwiftUI interfaces. It provides battle-tested, production-ready patterns for handling the unique challenges of cross-framework integration, including state synchronization, focus management, and layout quirks that arise at the framework boundary.

Core Features & Use Cases

  • Bidirectional Framework Bridging: Wrap AppKit NSViews and NSViewControllers for use in SwiftUI with NSViewRepresentable and NSViewControllerRepresentable, or embed SwiftUI views in legacy AppKit view controllers with NSHostingController and NSHostingView.
  • State & Focus Synchronization: Implement the coordinator pattern to manage delegate callbacks, two-way state binding, and first responder status across the AppKit-SwiftUI boundary.
  • Use Case: Migrate a legacy AppKit document-based macOS app to SwiftUI incrementally by wrapping existing NSTextView and NSOutlineView components in SwiftUI views first, without rewriting core AppKit business logic.

Quick Start

Use the swiftui-appkit-interop skill to wrap an existing NSTextView component for use in your SwiftUI macOS app's main editor view.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: swiftui-appkit-interop
Download link: https://github.com/LaughingJackalope/macos-skills/archive/main.zip#swiftui-appkit-interop

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 537,000+ vetted skills library on demand.