# siteline/swiftui-introspect

Introspect underlying UIKit/AppKit components from SwiftUI

Repository: https://github.com/siteline/swiftui-introspect
Canonical: https://ross.abutalabs.com/products/swiftui-introspect
Language: Swift
License: MIT
License Family: permissive
Topics: appkit, inspect, inspection, introspection, nsview, nsviewcontroller, swiftui, uikit, uiview, uiviewcontroller
Last push: 2026-08-05T22:22:05+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 92, longevity 100
- inputs: {"age_days": 2472, "days_push": 28, "days_rel": 56, "gap_med": 27.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6543, forks 418 (observed 2026-08-28T04:09:45.062502+00:00)

## What it is
A Swift library that lets SwiftUI developers access and customize the underlying UIKit or AppKit views behind SwiftUI views. It works by inserting invisible marker views and traversing the native view hierarchy to find the relevant platform view.

## Use cases
- customize a UIScrollView behind a SwiftUI ScrollView
- access the underlying UITextField from a SwiftUI TextField
- modify UIKit view properties not exposed by SwiftUI
- introspect AppKit views on macOS SwiftUI apps
- apply UIKit-level tweaks to SwiftUI components in production apps

## When to choose
- you need fine-grained control over UIKit/AppKit views that SwiftUI doesn't expose
- you want a production-safe approach that uses only public APIs
- you need to support specific iOS/macOS versions with explicit opt-in

## When to avoid
- you want a pure SwiftUI solution without platform dependencies
- your app targets platforms without UIKit/AppKit (e.g., Linux, Windows)
- you're unwilling to update introspection targets when new OS versions change underlying types

## Facets
- artifact type: library
- maturity: active
- function: ui-components, developer-tools
- domain: mobile-development, frontend, cross-platform
- platform: -
- tags: swiftui, uikit, appkit, view-hierarchy, introspection, swift-package-manager, ios, macos, swift

## Member repositories
- siteline/swiftui-introspect (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:45.062502+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:44:06.405615+00:00, confidence not recorded.
  - readme: https://github.com/siteline/swiftui-introspect (fetched 2026-08-28T04:09:45.062502+00:00, sha d611ae81018b)
- Data as of 2026-08-30T08:39:29.467469+00:00.