swiftui-webkit

name: swiftui-webkit description: Embed and control web content in SwiftUI apps using WebView and WebPage. Use when displaying URLs or HTML in a SwiftUI app, implementing JavaScript interop, controlling web navigation, capturing snapshots, or handling custom URL schemes. Core APIs require iOS/macOS 26+. metadata: author: rshankras

WebKit Integration for SwiftUI

Embed and control web content in SwiftUI using WebView and WebPage.

When This Skill Activates

Use this skill when the user needs to:

• Display web content within SwiftUI applications
• Load URLs, HTML strings, or data blobs
• Execute JavaScript from SwiftUI
• Control navigation (back, forward, reload)
• Customize web view behavior
• Capture snapshots or generate PDFs
• Intercept navigation requests
• Configure private browsing or custom user agents

API Availability

Quick Start

Minimal — Just a URL

import SwiftUI
import WebKit

struct SimpleWebView: View {
    var body: some View {
        WebView(url: URL(string: "https://apple.com")!)
    }
}

Full Control — with WebPage

import SwiftUI
import WebKit

struct ControlledWebView: View {
    @State private var page = WebPage()

    var body: some View {
        VStack {
            HStack {
                Button("Back") { page.goBack() }
                    .disabled(!page.canGoBack)
                Button("Forward") { page.goForward() }
                    .disabled(!page.canGoForward)
                Button("Reload") { page.reload() }
            }
            WebView(page)
        }
        .onAppear {
            page.load(URLRequest(url: URL(string: "https://apple.com")!))
        }
    }
}

JavaScript Execution

// Execute after page loads
let result = try await page.callJavaScript("document.title")

// Inject script
await page.evaluateJavaScript("document.body.style.backgroundColor = 'red'")

Wait for page load before executing JavaScript — check page.isLoading or observe load events.

Navigation Control

page.load(URLRequest(url: url))
page.loadHTMLString("<h1>Hello</h1>", baseURL: nil)
page.goBack()
page.goForward()
page.reload()
page.stopLoading()

Critical Mistakes to Avoid

Review Checklist

• import WebKit present alongside import SwiftUI
• Using WebPage for any navigation or JavaScript needs
• JavaScript execution waits for page load
• User input sanitized before JavaScript injection
• Navigation events observed for loading states
• iOS/macOS 26+ requirement documented