macos-appkit-swiftui-bridge

Community

Seamlessly bridge AppKit and SwiftUI

AuthorAutisticAF
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Provides expert guidance to integrate SwiftUI into existing AppKit macOS applications and to wrap AppKit views for use in SwiftUI, resolving lifecycle mismatches, layout sizing issues, and state synchronization problems that commonly cause memory leaks, stale UI, or poor performance.

Core Features & Use Cases

  • NSViewRepresentable guidance: Full protocol patterns, coordinator lifecycle, sizing integration, and dismantle cleanup for embedding AppKit views in SwiftUI.
  • Hosting controllers & views: Best practices for NSHostingView and NSHostingController usage, window and toolbar integration, and incremental migration strategies.
  • State management across frameworks: Recommended approaches using @Observable, Combine, NotificationCenter, and responder chain patterns with attention to thread safety and retain-cycle avoidance.
  • Use Case: Incrementally adopt SwiftUI by replacing a complex AppKit detail view with an NSHostingView while sharing a single observable view model between AppKit controllers and SwiftUI views.

Quick Start

Use the macos-appkit-swiftui-bridge skill to review an AppKit view and produce a migration plan with an NSViewRepresentable wrapper, coordinator lifecycle handling, and dismantle cleanup.

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: macos-appkit-swiftui-bridge
Download link: https://github.com/AutisticAF/claude-code-apple-dev-plugin/archive/main.zip#macos-appkit-swiftui-bridge

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 471,000+ vetted skills library on demand.