diff --git a/nativephp.json b/nativephp.json
index 72ff62c..7530299 100644
--- a/nativephp.json
+++ b/nativephp.json
@@ -237,6 +237,14 @@
             "ios_renderer": "NativeUIButtonRenderer",
             "self_closing": true
         },
+        {
+            "type": "sign_in_with_apple_button",
+            "element": "Native\\Mobile\\UI\\Elements\\SignInWithAppleButton",
+            "blade": "Native\\Mobile\\UI\\Components\\SignInWithAppleButton",
+            "android_renderer": "com.nativephp.plugins.native_ui.ui.SignInWithAppleButtonRenderer",
+            "ios_renderer": "NativeUISignInWithAppleButtonRenderer",
+            "self_closing": false
+        },
         {
             "type": "progress_bar",
             "element": "Native\\Mobile\\UI\\Elements\\ProgressBar",
diff --git a/resources/android/ListItemRenderer.kt b/resources/android/ListItemRenderer.kt
index 0cf7841..1fa6b8c 100644
--- a/resources/android/ListItemRenderer.kt
+++ b/resources/android/ListItemRenderer.kt
@@ -400,7 +400,7 @@ object ListItemRenderer {
         // `trailing_a11y_label` wins, else humanize the machine icon name
         // ("more_vert" -> "more vert") so it's never unlabeled.
         val iconButtonDescription = a11yLabel.ifEmpty {
-            effectiveValue.replace('_', ' ').replace('-', ' ')
+            effectiveValue.removePrefix(com.nativephp.mobile.ui.CUSTOM_ICON_PREFIX).replace('_', ' ').replace('-', ' ')
         }
 
         return {
diff --git a/resources/android/NavRenderers.kt b/resources/android/NavRenderers.kt
index 41c880b..a5d1bbe 100644
--- a/resources/android/NavRenderers.kt
+++ b/resources/android/NavRenderers.kt
@@ -37,6 +37,8 @@ import androidx.compose.ui.text.style.TextAlign
 import androidx.compose.ui.unit.dp
 import androidx.compose.ui.unit.sp
 import com.nativephp.mobile.R
+import com.nativephp.mobile.ui.CUSTOM_ICON_PREFIX
+import com.nativephp.mobile.ui.MaterialIcon
 import com.nativephp.mobile.ui.getIconName
 import com.nativephp.mobile.ui.nativerender.LocalSafeAreaBottom
 import com.nativephp.mobile.ui.nativerender.LocalSafeAreaTop
@@ -112,21 +114,28 @@ object TopBarRenderer {
                 val icon = action.props.getString("icon", "more_vert")
                 val url = action.props.getString("url")
                 val actionLabel = action.props.getString("label")
-                Text(
-                    text = getIconName(icon), fontFamily = iconFont, fontSize = 24.sp, color = textColor,
-                    modifier = Modifier
-                        .minimumInteractiveComponentSize()
-                        .clickable(role = Role.Button) {
-                            if (url.isNotEmpty()) {
-                                try { context.startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(url))) } catch (_: Exception) {}
-                            } else if (action.onPress != 0) {
-                                NativeElementBridge.sendPressEvent(action.onPress, action.id)
-                            }
-                        }
-                        .let { m ->
-                            if (actionLabel.isNotEmpty()) m.semantics { contentDescription = actionLabel } else m
+                val actionModifier = Modifier
+                    .minimumInteractiveComponentSize()
+                    .clickable(role = Role.Button) {
+                        if (url.isNotEmpty()) {
+                            try { context.startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(url))) } catch (_: Exception) {}
+                        } else if (action.onPress != 0) {
+                            NativeElementBridge.sendPressEvent(action.onPress, action.id)
                         }
-                )
+                    }
+                    .let { m ->
+                        if (actionLabel.isNotEmpty()) m.semantics { contentDescription = actionLabel } else m
+                    }
+                // Custom SVG icons are drawables, not font ligatures, so they
+                // go through core's MaterialIcon. Font glyphs stay as they were.
+                if (icon.startsWith(CUSTOM_ICON_PREFIX)) {
+                    MaterialIcon(name = icon, contentDescription = null, modifier = actionModifier, size = 24.dp, tint = textColor)
+                } else {
+                    Text(
+                        text = getIconName(icon), fontFamily = iconFont, fontSize = 24.sp, color = textColor,
+                        modifier = actionModifier
+                    )
+                }
             }
         }
     }
@@ -211,7 +220,11 @@ object BottomNavRenderer {
                     // Box wraps the icon at center; badge / news dot anchored
                     // to the icon's TopEnd corner via `.align(TopEnd)`.
                     Box(contentAlignment = Alignment.Center) {
-                        Text(text = getIconName(icon), fontFamily = iconFont, fontSize = 24.sp, color = itemColor, textAlign = TextAlign.Center)
+                        if (icon.startsWith(CUSTOM_ICON_PREFIX)) {
+                            MaterialIcon(name = icon, contentDescription = null, size = 24.dp, tint = itemColor)
+                        } else {
+                            Text(text = getIconName(icon), fontFamily = iconFont, fontSize = 24.sp, color = itemColor, textAlign = TextAlign.Center)
+                        }
                         if (badge.isNotEmpty()) {
                             Box(
                                 modifier = Modifier
diff --git a/resources/android/SignInWithAppleButtonRenderer.kt b/resources/android/SignInWithAppleButtonRenderer.kt
new file mode 100644
index 0000000..4efdc89
--- /dev/null
+++ b/resources/android/SignInWithAppleButtonRenderer.kt
@@ -0,0 +1,20 @@
+package com.nativephp.plugins.native_ui.ui
+
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import com.nativephp.mobile.ui.nativerender.DefaultContainerNode
+import com.nativephp.mobile.ui.nativerender.NativeUINode
+
+/**
+ * Sign in with Apple has no Android button, so this draws nothing unless the
+ * tag has children, which render as an Android-only fallback (laid out like a
+ * column). The iOS renderer draws Apple's button and ignores the children.
+ */
+object SignInWithAppleButtonRenderer {
+    @Composable
+    fun Render(node: NativeUINode, modifier: Modifier) {
+        if (node.children.isNotEmpty()) {
+            DefaultContainerNode(node, modifier)
+        }
+    }
+}
diff --git a/resources/boost/guidelines/core.blade.php b/resources/boost/guidelines/core.blade.php
index 299e903..45cda17 100644
--- a/resources/boost/guidelines/core.blade.php
+++ b/resources/boost/guidelines/core.blade.php
@@ -58,6 +58,20 @@
 - In tests, drive pickers with the `pickDate()` / `pickTime()` /
   `pickDateTime()` / `clearPicker()` macros and assert with
   `assertPicker()` / `assertPickerValue()` / `assertPickerEmpty()`.
+- For Sign in with Apple, use `<native:sign-in-with-apple-button
+  :nonce="$nonce" />`, never a `<native:button>` with an Apple logo: iOS draws
+  SwiftUI's `SignInWithAppleButton`, which is what App Review expects. Tapping
+  it runs the Apple ID request itself, so don't also start one from a plugin.
+  Listen for the result with `#[On(SignInWithAppleCompleted::class)]` and
+  `#[On(SignInWithAppleFailed::class)]` (`Native\Mobile\UI\Events`). Pass a
+  fresh `nonce` per attempt, the SHA-256 hex of a raw nonce you keep in memory
+  (never the raw value): it goes to Apple as given and the completed event
+  echoes it back. `scopes` is any of `email` / `full-name`. `label`
+  is `sign-in` (default) / `continue` / `sign-up` (NOT free text), and
+  `button-style` is `auto` (default, black in light mode and white in dark) /
+  `black` / `white` / `white-outline`. The app still needs the Sign in with
+  Apple entitlement from a plugin. Apple has no button on Android, so nothing
+  renders there unless you give the tag children as a fallback.
 
 @verbatim
 <code-snippet name="Declaring native elements in Blade" lang="blade">
diff --git a/resources/ios/NativeUIButtonRenderer.swift b/resources/ios/NativeUIButtonRenderer.swift
index 312cab5..20f071a 100644
--- a/resources/ios/NativeUIButtonRenderer.swift
+++ b/resources/ios/NativeUIButtonRenderer.swift
@@ -396,7 +396,7 @@ private struct ButtonContent: View {
                 }
             } else {
                 if !icon.isEmpty {
-                    Image(systemName: getIconForName(icon))
+                    NativeIconView(icon, pointSize: iconSize, relativeTo: .body)
                         .nuiScaledFont(size: iconSize)
                         // Pin the layout height to iconSize. SF Symbols report
                         // per-symbol intrinsic heights at the same point size,
@@ -411,7 +411,7 @@ private struct ButtonContent: View {
                     Text(label).nuiScaledFont(size: textSize, weight: .medium, fontName: fontName).lineSpacing(lineSpacing)
                 }
                 if !iconTrailing.isEmpty {
-                    Image(systemName: getIconForName(iconTrailing))
+                    NativeIconView(iconTrailing, pointSize: iconSize, relativeTo: .body)
                         .nuiScaledFont(size: iconSize)
                         .frame(height: iconSize)
                 }
@@ -465,7 +465,7 @@ private func buttonMenuItem(_ item: NativeUINode) -> some View {
             }
         } label: {
             if !icon.isEmpty {
-                Label(label, systemImage: getIconForName(icon))
+                Label { Text(label) } icon: { NativeIcon.image(icon) }
             } else {
                 Text(label)
             }
diff --git a/resources/ios/NativeUIChipRenderer.swift b/resources/ios/NativeUIChipRenderer.swift
index c073b8a..fad99e5 100644
--- a/resources/ios/NativeUIChipRenderer.swift
+++ b/resources/ios/NativeUIChipRenderer.swift
@@ -66,7 +66,7 @@ struct NativeUIChipRenderer: View {
         }) {
             HStack(spacing: 6) {
                 if !iconName.isEmpty {
-                    Image(systemName: getIconForName(iconName))
+                    NativeIconView(iconName, pointSize: 14, relativeTo: .body)
                         .nuiScaledFont(size: 14)
                 }
                 Text(label).nuiScaledFont(size: theme.fontSm, weight: .medium)
diff --git a/resources/ios/NativeUIFilledTextInputRenderer.swift b/resources/ios/NativeUIFilledTextInputRenderer.swift
index f8c6f51..385e920 100644
--- a/resources/ios/NativeUIFilledTextInputRenderer.swift
+++ b/resources/ios/NativeUIFilledTextInputRenderer.swift
@@ -68,7 +68,7 @@ struct NativeUIFilledTextInputRenderer: View {
             VStack(spacing: 0) {
                 HStack(spacing: 8) {
                     if !leadingIcon.isEmpty {
-                        Image(systemName: getIconForName(leadingIcon))
+                        NativeIconView(leadingIcon, pointSize: metrics.iconSize, relativeTo: .body)
                             .nuiScaledFont(size: metrics.iconSize)
                             .foregroundStyle(theme.onSurfaceVariant)
                     }
@@ -95,7 +95,7 @@ struct NativeUIFilledTextInputRenderer: View {
                     if loading {
                         ProgressView().controlSize(.small)
                     } else if !trailingIcon.isEmpty {
-                        Image(systemName: getIconForName(trailingIcon))
+                        NativeIconView(trailingIcon, pointSize: metrics.iconSize, relativeTo: .body)
                             .nuiScaledFont(size: metrics.iconSize)
                             .foregroundStyle(theme.onSurfaceVariant)
                     }
diff --git a/resources/ios/NativeUIIconRenderer.swift b/resources/ios/NativeUIIconRenderer.swift
index 5ed78a5..62dd317 100644
--- a/resources/ios/NativeUIIconRenderer.swift
+++ b/resources/ios/NativeUIIconRenderer.swift
@@ -27,7 +27,7 @@ struct NativeUIIconRenderer: View {
             ? darkArgb
             : lightArgb
 
-        Image(systemName: getIconForName(name))
+        NativeIcon.image(name)
             .resizable()
             .aspectRatio(contentMode: .fit)
             .frame(width: size, height: size)
diff --git a/resources/ios/NativeUIListItemRenderer.swift b/resources/ios/NativeUIListItemRenderer.swift
index 534cf7f..649a376 100644
--- a/resources/ios/NativeUIListItemRenderer.swift
+++ b/resources/ios/NativeUIListItemRenderer.swift
@@ -130,13 +130,13 @@ struct NativeUIListItemRenderer: View {
             if iconBgColor != 0 {
                 ZStack {
                     Circle().fill(Color(argb: iconBgColor))
-                    Image(systemName: getIconForName(value))
+                    NativeIconView(value, pointSize: 18, relativeTo: .body)
                         .nuiScaledFont(size: 18, weight: .medium)
                         .foregroundColor(.white)
                 }
                 .frame(width: 40, height: 40)
             } else {
-                Image(systemName: getIconForName(value))
+                NativeIcon.image(value)
                     .frame(width: 24, height: 24)
                     .foregroundColor(.secondary)
             }
@@ -225,7 +225,7 @@ struct NativeUIListItemRenderer: View {
         if !badges.isEmpty {
             HStack(spacing: 6) {
                 ForEach(badges) { b in
-                    Image(systemName: getIconForName(b.icon))
+                    NativeIconView(b.icon, pointSize: 15, relativeTo: .body)
                         .nuiScaledFont(size: 15)
                         .foregroundColor(parseListItemHex(b.color) ?? .secondary)
                 }
@@ -239,7 +239,7 @@ struct NativeUIListItemRenderer: View {
     private func buildTrailingContent(type: String, value: String, iconColor: Int, textColor: Int, checked: Bool = false, changeCb: Int = 0) -> some View {
         switch type {
         case "icon":
-            Image(systemName: getIconForName(value))
+            NativeIcon.image(value)
                 .frame(width: 24, height: 24)
                 .foregroundColor(iconColor != 0 ? Color(argb: iconColor) : .secondary)
         case "text":
@@ -252,7 +252,7 @@ struct NativeUIListItemRenderer: View {
             let trailingA11y = node.props.getString("trailing_a11y_label")
             let effectiveTrailingA11y = !trailingA11y.isEmpty
                 ? trailingA11y
-                : value.replacingOccurrences(of: "_", with: " ")
+                : (NativeIcon.customName(value) ?? value).replacingOccurrences(of: "_", with: " ")
                        .replacingOccurrences(of: "-", with: " ")
             // When the row has `:trailing-menu` attached, the trailing
             // icon button becomes a Menu trigger instead of a plain
@@ -271,7 +271,7 @@ struct NativeUIListItemRenderer: View {
                     // without it only the symbol's opaque pixels respond,
                     // which makes the ellipsis glyph (mostly empty space)
                     // almost un-tappable.
-                    Image(systemName: getIconForName(value))
+                    NativeIcon.image(value)
                         .frame(width: 24, height: 24)
                         .foregroundColor(iconColor != 0 ? Color(argb: iconColor) : .secondary)
                         .nuiMinTapTarget()
@@ -289,7 +289,7 @@ struct NativeUIListItemRenderer: View {
                         }
                     }
                 }) {
-                    Image(systemName: getIconForName(value))
+                    NativeIcon.image(value)
                         .frame(width: 24, height: 24)
                         .foregroundColor(iconColor != 0 ? Color(argb: iconColor) : .secondary)
                         .nuiMinTapTarget()
@@ -331,7 +331,7 @@ private func listItemMenuItem(_ item: NativeUINode) -> some View {
             }
         } label: {
             if !icon.isEmpty {
-                Label(label, systemImage: getIconForName(icon))
+                Label { Text(label) } icon: { NativeIcon.image(icon) }
             } else {
                 Text(label)
             }
diff --git a/resources/ios/NativeUIListRenderer.swift b/resources/ios/NativeUIListRenderer.swift
index 647f034..8a9e3b1 100644
--- a/resources/ios/NativeUIListRenderer.swift
+++ b/resources/ios/NativeUIListRenderer.swift
@@ -191,7 +191,11 @@ struct NativeUIListRenderer: View {
         let button = Button(role: role) {
             NativeElementBridge.sendPressEvent(spec.cb, nodeId: nodeId)
         } label: {
-            if !spec.icon.isEmpty {
+            if spec.icon.hasPrefix(NativeIcon.customPrefix) {
+                // Swipe icons are raw SF Symbol names (no getIconForName
+                // mapping), so only custom icons take the NativeIcon path.
+                Label { Text(spec.label.isEmpty ? " " : spec.label) } icon: { NativeIcon.image(spec.icon) }
+            } else if !spec.icon.isEmpty {
                 Label(spec.label.isEmpty ? " " : spec.label, systemImage: spec.icon)
             } else {
                 Text(spec.label.isEmpty ? " " : spec.label)
diff --git a/resources/ios/NativeUINavRenderers.swift b/resources/ios/NativeUINavRenderers.swift
index 092417a..7f012d7 100644
--- a/resources/ios/NativeUINavRenderers.swift
+++ b/resources/ios/NativeUINavRenderers.swift
@@ -62,14 +62,14 @@ struct NativeUITopBarRenderer: View {
                     ? a11y
                     : (!actionLabel.isEmpty
                         ? actionLabel
-                        : icon.replacingOccurrences(of: "_", with: " ")
+                        : (NativeIcon.customName(icon) ?? icon).replacingOccurrences(of: "_", with: " ")
                               .replacingOccurrences(of: "-", with: " "))
                 Button {
                     if action.onPress != 0 {
                         NativeElementBridge.sendPressEvent(action.onPress, nodeId: action.id)
                     }
                 } label: {
-                    Image(systemName: getIconForName(icon))
+                    NativeIconView(icon, pointSize: 17, relativeTo: .body)
                         .nuiScaledFont(size: 17, weight: .semibold)
                         .foregroundColor(textColor)
                         .frame(width: 32, height: 32)
@@ -166,7 +166,7 @@ struct NativeUIBottomNavRenderer: View {
                 } label: {
                     VStack(spacing: 4) {
                         ZStack(alignment: .topTrailing) {
-                            Image(systemName: getIconForName(icon))
+                            NativeIconView(icon, pointSize: 24, relativeTo: .body)
                                 .nuiScaledFont(size: 24)
                             if !badge.isEmpty {
                                 Text(badge)
diff --git a/resources/ios/NativeUIOutlinedTextInputRenderer.swift b/resources/ios/NativeUIOutlinedTextInputRenderer.swift
index 67c69e6..bc1c1c2 100644
--- a/resources/ios/NativeUIOutlinedTextInputRenderer.swift
+++ b/resources/ios/NativeUIOutlinedTextInputRenderer.swift
@@ -97,7 +97,7 @@ struct NativeUIOutlinedTextInputRenderer: View {
 
             HStack(spacing: 8) {
                 if !leadingIcon.isEmpty {
-                    Image(systemName: getIconForName(leadingIcon))
+                    NativeIconView(leadingIcon, pointSize: metrics.iconSize, relativeTo: .body)
                         .nuiScaledFont(size: metrics.iconSize)
                         .foregroundStyle(fieldDecorationColor)
                 }
@@ -128,7 +128,7 @@ struct NativeUIOutlinedTextInputRenderer: View {
                 if loading {
                     ProgressView().controlSize(.small)
                 } else if !trailingIcon.isEmpty {
-                    Image(systemName: getIconForName(trailingIcon))
+                    NativeIconView(trailingIcon, pointSize: metrics.iconSize, relativeTo: .body)
                         .nuiScaledFont(size: metrics.iconSize)
                         .foregroundStyle(fieldDecorationColor)
                 }
diff --git a/resources/ios/NativeUISignInWithAppleButtonRenderer.swift b/resources/ios/NativeUISignInWithAppleButtonRenderer.swift
new file mode 100644
index 0000000..68f07a8
--- /dev/null
+++ b/resources/ios/NativeUISignInWithAppleButtonRenderer.swift
@@ -0,0 +1,224 @@
+import AuthenticationServices
+import SwiftUI
+
+/// SwiftUI's own `SignInWithAppleButton`. Tapping it runs the Apple ID
+/// request, as the system button always does, and the result goes to PHP as
+/// a native event: `Native\Mobile\UI\Events\SignInWithAppleCompleted` or
+/// `SignInWithAppleFailed`. `on_press` fires as the request starts.
+///
+/// Props:
+///   - `label`: sign_in (default) | continue | sign_up
+///   - `button_style`: auto (default) | black | white | white_outline.
+///     `auto` follows the colour scheme: black in light mode, white in dark.
+///   - `corner_radius`: points, clamped to half the height (a capsule).
+///     The system default when absent.
+///   - `scopes`: any of `email`, `full_name`. None by default.
+///   - `nonce`: sent to Apple as given, and echoed on the completed event.
+///     Apps pass the SHA-256 of a raw nonce they keep, so the raw value
+///     never sits in the UI tree; Apple's identity token carries the hash.
+///   - `state`: echoed back on both events.
+///   - `disabled`
+///   - `a11y_label`, `a11y_hint`: override the system's VoiceOver text.
+///
+/// Height comes from the node's layout (`height`, `h-*`), 44pt when unset.
+/// Width follows the parent's proposal like any other control (`w-full`
+/// to fill). Children are an Android-only fallback and are ignored here.
+struct NativeUISignInWithAppleButtonRenderer: View {
+    let node: NativeUINode
+
+    @Environment(\.colorScheme) private var colorScheme
+
+    static let defaultHeight: CGFloat = 44
+    static let completedEvent = "Native\\Mobile\\UI\\Events\\SignInWithAppleCompleted"
+    static let failedEvent = "Native\\Mobile\\UI\\Events\\SignInWithAppleFailed"
+
+    var body: some View {
+        let p = node.props
+        let pressCb = p.getCallbackId("on_press")
+        let nodeId = node.id
+        let scopes = p.getStringList("scopes")
+        let nonce = p.getString("nonce")
+        let state = p.getString("state")
+        let disabled = p.getBool("disabled")
+        let a11yLabel = p.getString("a11y_label")
+        let a11yHint = p.getString("a11y_hint")
+        let styleName = Self.styleName(p.getString("button_style", default: "auto"), colorScheme: colorScheme)
+        let explicitHeight = (node.layout?.heightMode ?? SizeMode.wrap) != SizeMode.wrap
+
+        SignInWithAppleButton(Self.label(p.getString("label", default: "sign_in"))) { request in
+            request.requestedScopes = scopes.compactMap(Self.scope)
+            if !nonce.isEmpty {
+                request.nonce = nonce
+            }
+            if !state.isEmpty {
+                request.state = state
+            }
+            if pressCb != 0 {
+                // Through the focus policy so a focused field's pending
+                // change reaches PHP before the press does, as for <button>.
+                KeyboardFocusPolicy.dispatchPress {
+                    NativeElementBridge.sendPressEvent(pressCb, nodeId: nodeId)
+                }
+            }
+        } onCompletion: { result in
+            Self.send(result, nonce: nonce, state: state)
+        }
+        .signInWithAppleButtonStyle(Self.buttonStyle(styleName))
+        // Rebuild when the style flips with the colour scheme: the system
+        // button keeps the style it was first drawn with.
+        .id(styleName)
+        .frame(maxWidth: .infinity)
+        .frame(height: explicitHeight ? nil : Self.defaultHeight)
+        .frame(maxHeight: explicitHeight ? .infinity : nil)
+        .modifier(CornerRadiusModifier(radius: p.has("corner_radius") ? CGFloat(p.getFloat("corner_radius")) : nil, outlined: styleName == "white_outline"))
+        .disabled(disabled)
+        // The system button looks the same when disabled, so dim it.
+        .opacity(disabled ? 0.4 : 1)
+        .modifier(A11yModifier(label: a11yLabel, hint: a11yHint))
+    }
+
+    static func label(_ label: String) -> SignInWithAppleButton.Label {
+        switch label {
+        case "continue": return .continue
+        case "sign_up": return .signUp
+        default: return .signIn
+        }
+    }
+
+    /// `auto` resolved against the colour scheme.
+    static func styleName(_ style: String, colorScheme: ColorScheme) -> String {
+        switch style {
+        case "black", "white", "white_outline": return style
+        default: return colorScheme == .dark ? "white" : "black"
+        }
+    }
+
+    static func buttonStyle(_ name: String) -> SignInWithAppleButton.Style {
+        switch name {
+        case "white": return .white
+        case "white_outline": return .whiteOutline
+        default: return .black
+        }
+    }
+
+    static func scope(_ scope: String) -> ASAuthorization.Scope? {
+        switch scope {
+        case "email": return .email
+        case "full_name": return .fullName
+        default: return nil
+        }
+    }
+
+    /// Sends the result to PHP as a native event. Optional values go as null.
+    static func send(_ result: Result<ASAuthorization, Error>, nonce: String, state: String) {
+        func value(_ string: String?) -> Any {
+            guard let string, !string.isEmpty else { return NSNull() }
+            return string
+        }
+
+        switch result {
+        case .success(let authorization):
+            guard let credential = authorization.credential as? ASAuthorizationAppleIDCredential else {
+                LaravelBridge.shared.send?(failedEvent, [
+                    "code": "invalid_response",
+                    "message": "Apple returned a credential that isn't an Apple ID.",
+                    "state": value(state),
+                ])
+                return
+            }
+
+            LaravelBridge.shared.send?(completedEvent, [
+                "userId": credential.user,
+                "identityToken": value(credential.identityToken.flatMap { String(data: $0, encoding: .utf8) }),
+                "authorizationCode": value(credential.authorizationCode.flatMap { String(data: $0, encoding: .utf8) }),
+                "email": value(credential.email),
+                "givenName": value(credential.fullName?.givenName),
+                "familyName": value(credential.fullName?.familyName),
+                "nonce": value(nonce),
+                "state": value(credential.state ?? state),
+                "realUserStatus": realUserStatus(credential.realUserStatus),
+            ])
+
+        case .failure(let error):
+            LaravelBridge.shared.send?(failedEvent, [
+                "code": code(error),
+                "message": error.localizedDescription,
+                "state": value(state),
+            ])
+        }
+    }
+
+    static func code(_ error: Error) -> String {
+        guard let error = error as? ASAuthorizationError else { return "unknown" }
+
+        switch error.code {
+        case .canceled: return "canceled"
+        case .failed: return "failed"
+        case .invalidResponse: return "invalid_response"
+        case .notHandled: return "not_handled"
+        case .notInteractive: return "not_interactive"
+        default: return "unknown"
+        }
+    }
+
+    static func realUserStatus(_ status: ASUserDetectionStatus) -> String {
+        switch status {
+        case .likelyReal: return "likely_real"
+        case .unknown: return "unknown"
+        default: return "unsupported"
+        }
+    }
+}
+
+/// Clips to the requested corner radius, capped at a capsule. The white
+/// outline is drawn again on top, since clipping cuts the system's own
+/// outline at the corners.
+private struct CornerRadiusModifier: ViewModifier {
+    let radius: CGFloat?
+    let outlined: Bool
+
+    func body(content: Content) -> some View {
+        if let radius {
+            content.overlay {
+                GeometryReader { proxy in
+                    let shape = RoundedRectangle(cornerRadius: min(max(radius, 0), proxy.size.height / 2), style: .continuous)
+                    if outlined {
+                        shape.strokeBorder(Color.black, lineWidth: 1)
+                    }
+                }
+            }
+            .mask {
+                GeometryReader { proxy in
+                    RoundedRectangle(cornerRadius: min(max(radius, 0), proxy.size.height / 2), style: .continuous)
+                }
+            }
+        } else {
+            content
+        }
+    }
+}
+
+private struct A11yModifier: ViewModifier {
+    let label: String
+    let hint: String
+
+    func body(content: Content) -> some View {
+        content
+            .modifier(OptionalLabel(label: label))
+            .modifier(OptionalHint(hint: hint))
+    }
+
+    private struct OptionalLabel: ViewModifier {
+        let label: String
+        func body(content: Content) -> some View {
+            if label.isEmpty { content } else { content.accessibilityLabel(label) }
+        }
+    }
+
+    private struct OptionalHint: ViewModifier {
+        let hint: String
+        func body(content: Content) -> some View {
+            if hint.isEmpty { content } else { content.accessibilityHint(hint) }
+        }
+    }
+}
diff --git a/resources/ios/NativeUISimpleRenderers.swift b/resources/ios/NativeUISimpleRenderers.swift
index 6ff762a..060e771 100644
--- a/resources/ios/NativeUISimpleRenderers.swift
+++ b/resources/ios/NativeUISimpleRenderers.swift
@@ -41,7 +41,7 @@ private func pressableMenuItem(_ item: NativeUINode) -> some View {
             }
         } label: {
             if !icon.isEmpty {
-                Label(label, systemImage: getIconForName(icon))
+                Label { Text(label) } icon: { NativeIcon.image(icon) }
             } else {
                 Text(label)
             }
diff --git a/resources/ios/NativeUITabRowRenderer.swift b/resources/ios/NativeUITabRowRenderer.swift
index 9a801bb..fd1574b 100644
--- a/resources/ios/NativeUITabRowRenderer.swift
+++ b/resources/ios/NativeUITabRowRenderer.swift
@@ -42,7 +42,7 @@ struct NativeUITabRowRenderer: View {
                             let effectiveA11y = !tabA11y.isEmpty
                                 ? tabA11y
                                 : (label.isEmpty
-                                    ? icon.replacingOccurrences(of: "_", with: " ")
+                                    ? (NativeIcon.customName(icon) ?? icon).replacingOccurrences(of: "_", with: " ")
                                           .replacingOccurrences(of: "-", with: " ")
                                     : "")
 
@@ -55,7 +55,7 @@ struct NativeUITabRowRenderer: View {
                             }) {
                                 VStack(spacing: 4) {
                                     if !icon.isEmpty {
-                                        Image(systemName: getIconForName(icon))
+                                        NativeIcon.image(icon)
                                     }
                                     if !label.isEmpty {
                                         Text(label).nuiScaledFont(size: theme.fontSm, weight: .medium)
diff --git a/src/Components/SignInWithAppleButton.php b/src/Components/SignInWithAppleButton.php
new file mode 100644
index 0000000..d5963df
--- /dev/null
+++ b/src/Components/SignInWithAppleButton.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace Native\Mobile\UI\Components;
+
+use Native\Mobile\Edge\Components\Native\NativeBladeComponent;
+
+/**
+ * Not self-closing: children are an optional Android-only fallback, since
+ * Apple has no button there. iOS always draws Apple's button and ignores them.
+ */
+class SignInWithAppleButton extends NativeBladeComponent
+{
+    protected function elementType(): string
+    {
+        return 'sign_in_with_apple_button';
+    }
+}
diff --git a/src/Elements/SignInWithAppleButton.php b/src/Elements/SignInWithAppleButton.php
new file mode 100644
index 0000000..e2ba7e4
--- /dev/null
+++ b/src/Elements/SignInWithAppleButton.php
@@ -0,0 +1,215 @@
+<?php
+
+namespace Native\Mobile\UI\Elements;
+
+use InvalidArgumentException;
+use Native\Mobile\Edge\CallbackRegistry;
+use Native\Mobile\Edge\Element;
+
+/**
+ * Apple's own Sign in with Apple button: SwiftUI's `SignInWithAppleButton`
+ * on iOS, so the logo, title, font and proportions are always the ones App
+ * Review expects.
+ *
+ * Tapping it runs the Apple ID request, as the system button always does.
+ * The answer arrives as a native event, `SignInWithAppleCompleted` or
+ * `SignInWithAppleFailed`, which a component listens for with `#[On(...)]`.
+ * `@press` is called as the request starts.
+ *
+ * Apple has no button on Android, so nothing is drawn there unless the tag
+ * has children, which then render as an Android-only fallback.
+ *
+ *   - `label`: sign-in (default) | continue | sign-up
+ *   - `button-style`: auto (default; black in light mode, white in dark) | black | white | white-outline
+ *   - `scopes`: any of email, full-name. None by default.
+ *   - `nonce`: sent to Apple as given (usually the SHA-256 of a raw nonce you keep) and echoed on the completed event.
+ *   - `state`: echoed on both events.
+ *   - `corner-radius`: points, or a `rounded-*` class. Rounder than the system's corners, up to a capsule.
+ *   - `height`: points, or an `h-*` class. 44 when unset.
+ *   - `disabled`
+ *   - `@press`: called as the request starts
+ */
+class SignInWithAppleButton extends Element
+{
+    /** Title. `sign-in` is the default. */
+    public const LABELS = ['sign-in', 'continue', 'sign-up'];
+
+    /** Colours. `auto` (the default) is black in light mode and white in dark mode. */
+    public const BUTTON_STYLES = ['auto', 'black', 'white', 'white-outline'];
+
+    /** What to ask Apple for besides the user id. Apple only sends them on the first sign-in. */
+    public const SCOPES = ['email', 'full-name'];
+
+    protected string $type = 'sign_in_with_apple_button';
+
+    /** @var array<string, mixed> */
+    protected array $buttonProps = [];
+
+    protected ?string $pressCallback = null;
+
+    public static function make(): static
+    {
+        return new static;
+    }
+
+    public function applyAttributes(array $attrs): void
+    {
+        if (isset($attrs['label'])) {
+            $this->label((string) $attrs['label']);
+        }
+        $buttonStyle = $attrs['button-style'] ?? $attrs['buttonStyle'] ?? null;
+        if ($buttonStyle !== null) {
+            $this->buttonStyle((string) $buttonStyle);
+        }
+        if (isset($attrs['scopes'])) {
+            $this->scopes(is_array($attrs['scopes']) ? $attrs['scopes'] : explode(',', (string) $attrs['scopes']));
+        }
+        if (isset($attrs['nonce'])) {
+            $this->nonce((string) $attrs['nonce']);
+        }
+        if (isset($attrs['state'])) {
+            $this->state((string) $attrs['state']);
+        }
+
+        // `rounded-*` classes arrive as `borderRadius`; the attribute wins.
+        $cornerRadius = $attrs['corner-radius'] ?? $attrs['cornerRadius'] ?? $attrs['borderRadius'] ?? null;
+        if ($cornerRadius !== null) {
+            $this->cornerRadius((float) $cornerRadius);
+        }
+        if (! empty($attrs['disabled'])) {
+            $this->disabled();
+        }
+
+        $this->applyA11yAttributes($attrs);
+    }
+
+    /** sign-in | continue | sign-up, matching SwiftUI's `SignInWithAppleButton.Label`. */
+    public function label(string $label): static
+    {
+        $this->buttonProps['label'] = $this->oneOf($label, self::LABELS, 'label');
+
+        return $this;
+    }
+
+    /** auto | black | white | white-outline, matching SwiftUI's `SignInWithAppleButton.Style`. */
+    public function buttonStyle(string $style): static
+    {
+        $this->buttonProps['button_style'] = $this->oneOf($style, self::BUTTON_STYLES, 'button-style');
+
+        return $this;
+    }
+
+    /**
+     * Ask for the user's email and/or name: any of email, full-name.
+     *
+     * @param  list<string>  $scopes
+     */
+    public function scopes(array $scopes): static
+    {
+        $this->buttonProps['scopes'] = array_values(array_unique(array_map(
+            fn (string $scope): string => $this->oneOf($scope, self::SCOPES, 'scopes'),
+            array_filter(array_map('trim', $scopes), fn (string $scope): bool => $scope !== ''),
+        )));
+
+        return $this;
+    }
+
+    /**
+     * The nonce for this attempt, sent to Apple as given and echoed on the
+     * completed event. Pass the SHA-256 hex of a raw nonce you keep in memory:
+     * Apple's identity token carries the hash, your server checks it against
+     * the raw value, and the raw value never sits in the rendered tree.
+     */
+    public function nonce(string $nonce): static
+    {
+        $this->buttonProps['nonce'] = $nonce;
+
+        return $this;
+    }
+
+    /** An opaque value echoed back on both events. */
+    public function state(string $state): static
+    {
+        $this->buttonProps['state'] = $state;
+
+        return $this;
+    }
+
+    /**
+     * Corner radius in points. SwiftUI's button can only be clipped, so this
+     * rounds the corners more than the system does, up to a capsule at half
+     * the height or more. It can't make them squarer.
+     */
+    public function cornerRadius(float $radius): static
+    {
+        $this->buttonProps['corner_radius'] = max(0.0, $radius);
+
+        return $this;
+    }
+
+    public function disabled(bool $value = true): static
+    {
+        $this->buttonProps['disabled'] = $value;
+
+        return $this;
+    }
+
+    /**
+     * Called as the Apple ID request starts. Rides the props as `on_press`
+     * rather than the node's press field, so core doesn't wrap the button in
+     * a second tap gesture.
+     */
+    public function onPress(string $method): static
+    {
+        $this->pressCallback = $method;
+
+        return $this;
+    }
+
+    protected function resolveProps(CallbackRegistry $registry): array
+    {
+        $props = $this->buttonProps;
+
+        if ($this->pressCallback !== null) {
+            $props['on_press'] = $registry->register($this->pressCallback);
+        }
+
+        return $props;
+    }
+
+    /**
+     * Apple's guidelines fix the button's colours and shape, so per-instance
+     * styling (bg, border, shadow) is dropped, as it is for `<button>`.
+     */
+    public function getStyle(): array
+    {
+        return [];
+    }
+
+    public function getLayout(): array
+    {
+        $layout = parent::getLayout();
+        unset($layout['padding']);
+
+        return $layout;
+    }
+
+    /**
+     * Accepts the documented kebab-case value, or its snake_case or camelCase
+     * spelling, and sends snake_case on the wire.
+     *
+     * @param  list<string>  $allowed
+     */
+    private function oneOf(string $value, array $allowed, string $prop): string
+    {
+        $kebab = strtolower((string) preg_replace(['/(?<=[a-z])(?=[A-Z])/', '/_/'], '-', trim($value)));
+
+        if (! in_array($kebab, $allowed, true)) {
+            throw new InvalidArgumentException(
+                "SignInWithAppleButton `{$prop}` must be one of [".implode(', ', $allowed)."], got [{$value}]."
+            );
+        }
+
+        return str_replace('-', '_', $kebab);
+    }
+}
diff --git a/src/Events/SignInWithAppleCompleted.php b/src/Events/SignInWithAppleCompleted.php
new file mode 100644
index 0000000..64f3234
--- /dev/null
+++ b/src/Events/SignInWithAppleCompleted.php
@@ -0,0 +1,32 @@
+<?php
+
+namespace Native\Mobile\UI\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+use SensitiveParameter;
+
+/**
+ * Sent by `<native:sign-in-with-apple-button>` when Apple signs someone in.
+ *
+ * Apple only sends `email`, `givenName` and `familyName` the first time
+ * someone signs in to your app, and only for the scopes you asked for. After
+ * that you get the user id and the identity token, so store what you need.
+ */
+class SignInWithAppleCompleted
+{
+    use Dispatchable;
+
+    public function __construct(
+        public string $userId,
+        #[SensitiveParameter] public ?string $identityToken = null,
+        #[SensitiveParameter] public ?string $authorizationCode = null,
+        public ?string $email = null,
+        public ?string $givenName = null,
+        public ?string $familyName = null,
+        /** The nonce the button was given, which Apple's identity token also carries. */
+        #[SensitiveParameter] public ?string $nonce = null,
+        public ?string $state = null,
+        /** likely_real, unknown or unsupported. */
+        public string $realUserStatus = 'unsupported',
+    ) {}
+}
diff --git a/src/Events/SignInWithAppleFailed.php b/src/Events/SignInWithAppleFailed.php
new file mode 100644
index 0000000..0a39c45
--- /dev/null
+++ b/src/Events/SignInWithAppleFailed.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace Native\Mobile\UI\Events;
+
+use Illuminate\Foundation\Events\Dispatchable;
+
+/**
+ * Sent by `<native:sign-in-with-apple-button>` when the Apple ID request ends
+ * without signing anyone in, including when the person closes Apple's sheet.
+ */
+class SignInWithAppleFailed
+{
+    use Dispatchable;
+
+    /** The person closed Apple's sheet. */
+    public const Canceled = 'canceled';
+
+    /**
+     * Apple's catch-all (error 1000). On a phone it usually means it isn't
+     * signed in to an Apple Account, or the app lacks the Sign in with Apple
+     * entitlement. Simulator builds always get it.
+     */
+    public const Unknown = 'unknown';
+
+    public function __construct(
+        /** canceled, failed, invalid_response, not_handled, not_interactive or unknown. */
+        public string $code,
+        public string $message = '',
+        public ?string $state = null,
+    ) {}
+}
diff --git a/tests/CustomIconTest.php b/tests/CustomIconTest.php
new file mode 100644
index 0000000..74cef01
--- /dev/null
+++ b/tests/CustomIconTest.php
@@ -0,0 +1,141 @@
+<?php
+
+use Native\Mobile\Edge\CallbackRegistry;
+use Native\Mobile\Edge\ElementRegistry;
+use Native\Mobile\Edge\Elements\Icon as CoreIcon;
+use Native\Mobile\Edge\NativeElementCollector;
+use Native\Mobile\Edge\NativeTagPrecompiler;
+use Native\Mobile\Icon\AndroidSymbol;
+use Native\Mobile\Platform;
+use Native\Mobile\UI\Elements\Button;
+use Native\Mobile\UI\Elements\Chip;
+use Native\Mobile\UI\Elements\Icon;
+use Native\Mobile\UI\Elements\ListItem;
+use Native\Mobile\UI\Elements\OutlinedTextInput;
+use Native\Mobile\UI\Elements\Tab;
+
+/**
+ * App icons from `resources/icons/<name>.svg` travel as the string
+ * `custom:<name>` in every icon prop, and the renderers pick the asset
+ * from the prefix. These check that nothing on the PHP side lowercases,
+ * maps or drops that string on its way to the wire.
+ */
+enum CustomIconAndroid: string implements AndroidSymbol
+{
+    public function variant(): string
+    {
+        return 'outlined';
+    }
+
+    case Notifications = 'notifications';
+}
+
+beforeEach(function () {
+    NativeElementCollector::reset();
+    ElementRegistry::reset();
+    ElementRegistry::register('button', Button::class);
+    ElementRegistry::register('chip', Chip::class);
+    ElementRegistry::register('tab', Tab::class);
+    ElementRegistry::register('list_item', ListItem::class);
+    ElementRegistry::register('outlined_text_input', OutlinedTextInput::class);
+});
+
+afterEach(function () {
+    NativeElementCollector::reset();
+    ElementRegistry::reset();
+    Platform::set(null);
+});
+
+function compileNativeTag(string $blade): array
+{
+    $wasActive = NativeTagPrecompiler::setActive(true);
+
+    try {
+        $php = (new NativeTagPrecompiler)($blade);
+    } finally {
+        NativeTagPrecompiler::setActive($wasActive);
+    }
+
+    eval('?>'.$php);
+
+    return NativeElementCollector::collect()->toArray(new CallbackRegistry)['props'];
+}
+
+it('keeps a custom name on a Blade <native:icon>', function (string $element, ?string $platform) {
+    ElementRegistry::register('icon', $element);
+    Platform::set($platform);
+
+    $props = compileNativeTag('<native:icon name="custom:git-commit-vertical" size="20" />');
+
+    expect($props['name'])->toBe('custom:git-commit-vertical')
+        ->and($props['size'])->toBe(20.0)
+        ->and($props)->not->toHaveKey('material_variant');
+})->with([
+    'core element' => CoreIcon::class,
+    'plugin element' => Icon::class,
+])->with(['ios', 'android', null]);
+
+it('keeps a custom name on the Icon builder', function (string $element) {
+    $props = $element::make('custom:git-commit-vertical')->toArray(new CallbackRegistry)['props'];
+
+    expect($props['name'])->toBe('custom:git-commit-vertical');
+})->with([
+    'core element' => CoreIcon::class,
+    'plugin element' => Icon::class,
+]);
+
+it('keeps custom names in both button icon slots from Blade', function () {
+    Platform::set('ios');
+
+    $props = compileNativeTag(
+        '<native:button label="Commit" icon="custom:git-commit-vertical" icon-trailing="custom:arrow-up" />'
+    );
+
+    expect($props['leading_icon'])->toBe('custom:git-commit-vertical')
+        ->and($props['trailing_icon'])->toBe('custom:arrow-up')
+        ->and($props)->not->toHaveKey('leading_icon_variant');
+});
+
+it('lets a custom button icon sit beside a Material override', function (string $platform, string $icon, ?string $variant) {
+    Platform::set($platform);
+
+    $props = Button::make('Alerts')
+        ->icon('custom:bell', android: CustomIconAndroid::Notifications)
+        ->toArray(new CallbackRegistry)['props'];
+
+    expect($props['leading_icon'])->toBe($icon)
+        ->and($props['leading_icon_variant'] ?? null)->toBe($variant);
+})->with([
+    'ios draws the custom bell' => ['ios', 'custom:bell', null],
+    'android draws the material glyph' => ['android', 'notifications', 'outlined'],
+]);
+
+it('keeps custom names in every list item icon slot', function () {
+    Platform::set('android');
+
+    $props = ListItem::make('Commits')
+        ->leadingIcon('custom:git-commit-vertical')
+        ->trailingIconButton('custom:git-branch')
+        ->trailingActions([['method' => 'revert', 'label' => 'Revert', 'icon' => 'custom:undo']])
+        ->trailingBadges([['icon' => 'custom:pin']])
+        ->toArray(new CallbackRegistry)['props'];
+
+    expect($props['leading_value'])->toBe('custom:git-commit-vertical')
+        ->and($props['leading_icon'])->toBe('custom:git-commit-vertical')
+        ->and($props['trailing_value'])->toBe('custom:git-branch')
+        ->and(json_decode($props['trailing_actions_json'], true)[0]['icon'])->toBe('custom:undo')
+        ->and(json_decode($props['trailing_badges_json'], true)[0]['icon'])->toBe('custom:pin');
+});
+
+it('keeps custom names on chip, tab and text input icons', function (string $type, array $attrs, string $prop) {
+    Platform::set('ios');
+
+    NativeElementCollector::leaf($type, $attrs);
+    $props = NativeElementCollector::collect()->toArray(new CallbackRegistry)['props'];
+
+    expect($props[$prop])->toBe('custom:git-commit-vertical');
+})->with([
+    'chip' => ['chip', ['label' => 'Commits', 'icon' => 'custom:git-commit-vertical'], 'icon'],
+    'tab' => ['tab', ['label' => 'Commits', 'icon' => 'custom:git-commit-vertical'], 'icon'],
+    'text input' => ['outlined_text_input', ['leading-icon' => 'custom:git-commit-vertical'], 'leading_icon'],
+]);
diff --git a/tests/SignInWithAppleButtonTest.php b/tests/SignInWithAppleButtonTest.php
new file mode 100644
index 0000000..9fe6301
--- /dev/null
+++ b/tests/SignInWithAppleButtonTest.php
@@ -0,0 +1,220 @@
+<?php
+
+use Native\Mobile\Edge\CallbackRegistry;
+use Native\Mobile\Edge\ElementRegistry;
+use Native\Mobile\Edge\NativeElementCollector;
+use Native\Mobile\Edge\NativeTagPrecompiler;
+use Native\Mobile\Edge\TailwindParser;
+use Native\Mobile\UI\Elements\Button;
+use Native\Mobile\UI\Elements\SignInWithAppleButton;
+use Native\Mobile\UI\Events\SignInWithAppleCompleted;
+use Native\Mobile\UI\Events\SignInWithAppleFailed;
+
+/**
+ * Apple's Sign in with Apple button. iOS draws SwiftUI's button from `label`,
+ * `button_style` and `corner_radius`, runs the Apple ID request with `scopes`,
+ * `nonce` and `state`, fires `on_press` as it starts, and sends the answer
+ * back as a SignInWithAppleCompleted or SignInWithAppleFailed native event.
+ */
+beforeEach(function () {
+    NativeElementCollector::reset();
+    TailwindParser::clearCache();
+    ElementRegistry::reset();
+    ElementRegistry::register('sign_in_with_apple_button', SignInWithAppleButton::class);
+    ElementRegistry::register('button', Button::class);
+});
+
+afterEach(function () {
+    NativeElementCollector::reset();
+    ElementRegistry::reset();
+});
+
+function appleButtonTree(string $blade, CallbackRegistry $registry): array
+{
+    $wasActive = NativeTagPrecompiler::setActive(true);
+
+    try {
+        $php = (new NativeTagPrecompiler)($blade);
+    } finally {
+        NativeTagPrecompiler::setActive($wasActive);
+    }
+
+    eval('?>'.$php);
+
+    return NativeElementCollector::collect()->toArray($registry);
+}
+
+it('sends the label, style, corner radius and press handler from a Blade tag', function () {
+    $registry = new CallbackRegistry;
+    $tree = appleButtonTree(
+        '<native:sign-in-with-apple-button label="continue" button-style="white-outline" corner-radius="8" @press="signInWithApple" />',
+        $registry,
+    );
+
+    expect($tree['type'])->toBe('sign_in_with_apple_button')
+        ->and($tree['props'])->toMatchArray([
+            'label' => 'continue',
+            'button_style' => 'white_outline',
+            'corner_radius' => 8.0,
+        ])
+        ->and($registry->resolve($tree['props']['on_press']))->toBe(['method' => 'signInWithApple', 'args' => []]);
+});
+
+it('keeps the press handler off the node so core adds no second tap gesture', function () {
+    $tree = appleButtonTree('<native:sign-in-with-apple-button @press="signInWithApple" />', new CallbackRegistry);
+
+    expect($tree)->not->toHaveKey('on_press')
+        ->and($tree['props'])->toHaveKey('on_press');
+});
+
+it('leaves the defaults to the renderer', function () {
+    $tree = appleButtonTree('<native:sign-in-with-apple-button />', new CallbackRegistry);
+
+    expect($tree['props'] ?? [])->toBe([]);
+});
+
+it('accepts each label', function (string $label, string $wire) {
+    $tree = appleButtonTree("<native:sign-in-with-apple-button label=\"{$label}\" />", new CallbackRegistry);
+
+    expect($tree['props']['label'])->toBe($wire);
+})->with([
+    ['sign-in', 'sign_in'],
+    ['continue', 'continue'],
+    ['sign-up', 'sign_up'],
+    ['sign_up', 'sign_up'],
+    ['signUp', 'sign_up'],
+]);
+
+it('accepts each style', function (string $style, string $wire) {
+    $tree = appleButtonTree("<native:sign-in-with-apple-button button-style=\"{$style}\" />", new CallbackRegistry);
+
+    expect($tree['props']['button_style'])->toBe($wire);
+})->with([
+    ['auto', 'auto'],
+    ['black', 'black'],
+    ['white', 'white'],
+    ['white-outline', 'white_outline'],
+    ['whiteOutline', 'white_outline'],
+]);
+
+it('sends the scopes, nonce and state for the request', function () {
+    $tree = appleButtonTree(
+        '<native:sign-in-with-apple-button :scopes="[\'email\', \'full-name\']" nonce="hashed-nonce" state="link" />',
+        new CallbackRegistry,
+    );
+
+    expect($tree['props'])->toMatchArray([
+        'scopes' => ['email', 'full_name'],
+        'nonce' => 'hashed-nonce',
+        'state' => 'link',
+    ]);
+});
+
+it('takes scopes as a comma list in any spelling, once each', function () {
+    $tree = appleButtonTree('<native:sign-in-with-apple-button scopes="fullName, email, full_name" />', new CallbackRegistry);
+
+    expect($tree['props']['scopes'])->toBe(['full_name', 'email']);
+});
+
+it('rejects a scope Apple has no data for', function () {
+    SignInWithAppleButton::make()->scopes(['phone']);
+})->throws(InvalidArgumentException::class, 'SignInWithAppleButton `scopes` must be one of [email, full-name], got [phone].');
+
+it('sends results with the names the event constructors take', function (string $event, string $class) {
+    // The renderer builds each payload by hand, and core binds payload keys to
+    // constructor parameters by name, so a renamed key would silently be lost.
+    $swift = file_get_contents(dirname(__DIR__).'/resources/ios/NativeUISignInWithAppleButtonRenderer.swift');
+    preg_match_all('/send\?\('.$event.', \[(.*?)\]\)/s', $swift, $payloads);
+    $parameters = array_map(fn (ReflectionParameter $parameter): string => $parameter->getName(), (new ReflectionMethod($class, '__construct'))->getParameters());
+
+    expect($payloads[1])->not->toBeEmpty()
+        ->and(str_contains($swift, '"'.str_replace('\\', '\\\\', $class).'"'))->toBeTrue();
+
+    foreach ($payloads[1] as $payload) {
+        preg_match_all('/"(\w+)":/', $payload, $keys);
+
+        expect(array_diff($keys[1], $parameters))->toBe([]);
+    }
+})->with([
+    'completed' => ['completedEvent', SignInWithAppleCompleted::class],
+    'failed' => ['failedEvent', SignInWithAppleFailed::class],
+]);
+
+it('builds the events from a native payload', function () {
+    $completed = new SignInWithAppleCompleted(userId: '001234.abcd', identityToken: 'eyJ...', nonce: 'hashed-nonce', state: 'link', realUserStatus: 'likely_real');
+    $failed = new SignInWithAppleFailed(code: SignInWithAppleFailed::Canceled, message: 'The user canceled the authorization attempt.');
+
+    expect([$completed->userId, $completed->identityToken, $completed->email, $completed->nonce, $completed->state, $completed->realUserStatus])
+        ->toBe(['001234.abcd', 'eyJ...', null, 'hashed-nonce', 'link', 'likely_real'])
+        ->and([$failed->code, $failed->state])->toBe(['canceled', null]);
+});
+
+it('rejects a label Apple has no title for', function () {
+    SignInWithAppleButton::make()->label('Sign in with Apple');
+})->throws(InvalidArgumentException::class, 'SignInWithAppleButton `label` must be one of [sign-in, continue, sign-up], got [Sign in with Apple].');
+
+it('rejects an unknown style', function () {
+    SignInWithAppleButton::make()->buttonStyle('red');
+})->throws(InvalidArgumentException::class, 'SignInWithAppleButton `button-style` must be one of [auto, black, white, white-outline], got [red].');
+
+it('takes the corner radius from a rounded class, with the attribute winning', function () {
+    $fromClass = appleButtonTree('<native:sign-in-with-apple-button class="rounded-xl" />', new CallbackRegistry);
+    NativeElementCollector::reset();
+    $both = appleButtonTree('<native:sign-in-with-apple-button class="rounded-xl" corner-radius="4" />', new CallbackRegistry);
+
+    expect($fromClass['props']['corner_radius'])->toBe(12.0)
+        ->and($both['props']['corner_radius'])->toBe(4.0);
+});
+
+it('sizes through the layout and drops colours and padding', function () {
+    $tree = appleButtonTree('<native:sign-in-with-apple-button class="w-full h-12 p-4 bg-red-500" />', new CallbackRegistry);
+
+    expect($tree['layout'])->toMatchArray(['width' => 'fill', 'height' => 48.0])
+        ->and($tree['layout'])->not->toHaveKey('padding')
+        ->and($tree['style'] ?? [])->toBe([]);
+});
+
+it('can be disabled', function () {
+    $tree = appleButtonTree('<native:sign-in-with-apple-button :disabled="true" />', new CallbackRegistry);
+
+    expect($tree['props']['disabled'])->toBeTrue();
+});
+
+it('keeps children as the Android fallback', function () {
+    $tree = appleButtonTree(
+        '<native:sign-in-with-apple-button @press="signInWithApple"><native:button @press="signInWithApple">Sign in with Apple</native:button></native:sign-in-with-apple-button>',
+        new CallbackRegistry,
+    );
+
+    expect($tree['children'])->toHaveCount(1)
+        ->and($tree['children'][0]['type'])->toBe('button')
+        ->and($tree['children'][0]['props']['label'])->toBe('Sign in with Apple');
+});
+
+it('builds the same props fluently', function () {
+    $registry = new CallbackRegistry;
+    $props = SignInWithAppleButton::make()
+        ->label('sign-up')
+        ->buttonStyle('black')
+        ->cornerRadius(22)
+        ->onPress('signUpWithApple')
+        ->toArray($registry)['props'];
+
+    expect($props)->toMatchArray(['label' => 'sign_up', 'button_style' => 'black', 'corner_radius' => 22.0])
+        ->and($registry->resolve($props['on_press']))->toBe(['method' => 'signUpWithApple', 'args' => []]);
+});
+
+it('is registered in the manifest as a container element', function () {
+    $manifest = json_decode(file_get_contents(dirname(__DIR__).'/nativephp.json'), true);
+    $component = collect($manifest['components'])->firstWhere('type', 'sign_in_with_apple_button');
+
+    expect($component)->toMatchArray([
+        'element' => SignInWithAppleButton::class,
+        'blade' => Native\Mobile\UI\Components\SignInWithAppleButton::class,
+        'android_renderer' => 'com.nativephp.plugins.native_ui.ui.SignInWithAppleButtonRenderer',
+        'ios_renderer' => 'NativeUISignInWithAppleButtonRenderer',
+        'self_closing' => false,
+    ])
+        ->and(dirname(__DIR__).'/resources/ios/NativeUISignInWithAppleButtonRenderer.swift')->toBeFile()
+        ->and(dirname(__DIR__).'/resources/android/SignInWithAppleButtonRenderer.kt')->toBeFile();
+});