Stop building screens.
Start shipping your app.

Presentation modes, keyboard and scrims

dfPopupPresentation presents a popup in one of three modes: .overlay (default), .sheet (a real SwiftUI sheet for bottom-anchored popups, a full-screen cover for the rest, binding kept in sync both ways) or .window (a transparent UIWindow on iOS above sheets and navigation bars; a borderless child NSPanel on macOS; an overlay on visionOS). keyboard: .avoid (default) lifts the popup above the software keyboard. DFPopupScrim is .dim(_:), .blur(_:), .custom { } or .clear; .passingTouches() keeps a visible scrim from blocking the app. dfPopupWindow remains as shorthand for display: .window.

YourContentView().dfPopupPresentation(
    isPresented: $showPopup,
    display: .window,                        // .overlay (default) | .sheet | .window
    configuration: .floater(position: .top),
    keyboard: .avoid,                        // .avoid (default) | .ignore
    scrim: .blur(0.7),                       // .dim(0.3) | .blur(_:) | .custom { } | .clear
    motion: .zoom,
    pausesOnHold: true,
    chrome: .style,                          // .style wraps content in DFPopupStyle; .none draws it as-is
    haptic: .success,
    onDismiss: { reason in print(reason) }
) {
    Text("Hello")
}

// A visible scrim that lets touches reach the app
YourContentView().dfPopupPresentation(isPresented: $showPopup, scrim: .dim(0.2).passingTouches()) {
    Text("Non-blocking")
}

// Shorthand for display: .window
YourContentView().dfPopupWindow(isPresented: $showPopup, configuration: .toast(position: .top)) {
    Text("Above the sheet")
}

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Dismiss reasons, pause on hold and countdown

The Pro presenters (dfPopupPresentation, dfScrollPopup, DFPopupCenter.present and the rich popups and toasts below, except the live capsule, coachmarks and notification banners) deliver a DFPopupDismissReason (.timeout .tap .outsideTap .drag .programmatic .preempted) to onDismiss. dfPopupWindow keeps a plain () -> Void onDismiss, and notification banners report (item, reason). Content can close its own popup through @Environment(\.dfPopupDismiss). Resting a finger or pointer on an auto-dismissing popup pauses its timer. DFPopupCountdownBar and DFPopupCountdownRing follow the popup's live, pausable countdown.

struct CloseButton: View {
    @Environment(\.dfPopupDismiss) private var dismiss     // no-op outside a Pro popup
    @Environment(\.dfPopupCountdown) private var countdown // the auto-dismiss timer, if any

    var body: some View {
        VStack {
            DFPopupCountdownBar()
            Button("Done") { dismiss(.tap) }
        }
    }
}

YourContentView().dfPopupPresentation(
    isPresented: $showPopup,
    configuration: .floater(position: .bottom, autoDismissAfter: 5),
    pausesOnHold: true,
    onDismiss: { reason in
        if reason == .timeout { commitDelete() }
    }
) {
    HStack {
        DFPopupCountdownRing()
        Text("Message deleted")
    }
}

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Scroll popup

dfScrollPopup is a popup with a pinned header, scrolling body and optional pinned footer. Dragging dismisses only when the content is at its top, so the drag and the scroll never fight. detents: (.medium .large .fraction .height) snap the height; edge: adds .leading/.trailing side sheets on regular width (compact falls back to the bottom); headerStyle: is .plain .centered .prominent .closable; fromTop: true presents from the top edge.

YourContentView().dfScrollPopup(
    isPresented: $showPopup,
    edge: .automatic,
    detents: [.medium, .large],
    headerStyle: .closable,
    scrim: .dim(),
    onDismiss: { reason in print(reason) }
) {
    Text("Release notes")
} content: {
    Text("Long, scrollable content…")
} footer: {
    Button("Update now") { }
}

YourContentView().dfScrollPopup(isPresented: $showPopup, fromTop: true) {
    Text("Ticket #4821")
} content: {
    Text("Comments…")
}

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Popup Center: priority queue

DFPopupCenter puts many popups behind one presenter. One shows at a time; the rest wait by DFPopupPriority (.low .normal .high .critical). A higher priority preempts the current popup (its onDismiss gets .preempted and it re-queues), and presenting an id that is already showing or waiting replaces it. The optional haptic plays when the popup takes over.

YourContentView().dfPopupCenter(popups)     // popups: @StateObject DFPopupCenter

popups.present(id: "offline", priority: .high, configuration: .toast(),
               haptic: .warning, onDismiss: { reason in print(reason) }) {
    VStack {
        Text("You're offline")
        DFPopupCountdownBar()
    }
}
popups.dismiss(id: "offline")

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Celebration

DFCelebrationPopup: a hero icon springs in and a DFConfettiBurst fires from it. With Reduce Motion it fades only. Nothing needs image assets: everything is SF Symbols and theme gradients.

YourContentView().dfCelebrationPopup(
    isPresented: $showPopup,
    title: "Order placed!",
    message: "Tracking is on its way.",
    actionTitle: "Continue"
)

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Permission, promo, rating, input, consent and action popups

Each is a public view plus a presenting modifier. The celebration, permission, promo, rating, input, consent and action popups and the undo and progress toasts accept display: and a reason-style onDismiss:; the live capsule accepts display: but has no onDismiss; coachmarks and notification banners have neither display: nor the reason-style onDismiss (banners report (item, reason)). The card-style ones follow the environment DFPopupStyle. Permission prompt: pre-permission priming; you trigger the system prompt in onAllow. Promo: media area (.symbol, .gradient, .image), badge and CTA. Rating: stars, then a feedback step below the threshold or a review nudge at or above it. Input: validated, keyboard-aware, auto-focused. Consent: a sheet of toggleable categories. Action: rows with normal, destructive and cancel roles, centered, as a bottom sheet, or anchored to a view.

YourContentView().dfPermissionPrompt(isPresented: $showPopup, kind: .notifications,
                                     onAllow: { /* trigger the system prompt */ }, onDecline: { })

YourContentView().dfPermissionPrompt(
    isPresented: $showPopup, icon: "heart.fill", title: "Health data", message: "Why we ask",
    benefits: [DFPermissionBenefit(icon: "figure.walk", title: "Track steps", detail: "Stays on device")],
    onAllow: { }
)

YourContentView().dfPromoPopup(
    isPresented: $showPopup, badge: "New", media: .symbol("sparkles"),
    title: "Meet Focus mode", message: "Silence the noise.",
    actionTitle: "Try it", secondaryTitle: "Later", onAction: { }
)

YourContentView().dfRatingPrompt(
    isPresented: $showPopup, appName: "Orbit", threshold: 4,
    onSubmit: { stars, feedback in }, onRequestReview: { }
)

YourContentView().dfInputPopup(
    isPresented: $showPopup, title: "Rename folder", initialText: "Projects",
    validators: [DFRequiredValidator(), DFMaxLengthValidator(maxLength: 40)],
    onSubmit: { name in }
)

YourContentView().dfConsentSheet(isPresented: $showPopup, categories: DFConsentCategory.standard,
                                 onSave: { enabledIDs in })

YourContentView().dfActionPopup(isPresented: $showPopup, title: "Photo", actions: [
    DFActionPopupItem("Share", systemImage: "square.and.arrow.up") { },
    DFActionPopupItem("Delete", systemImage: "trash", role: .destructive) { },
    DFActionPopupItem("Cancel", role: .cancel) { },
], anchor: .bottom)            // .center | .bottom | .target(id)

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Undo, progress, notification banners and live capsule

DFUndoToast: message plus Undo with a live countdown ring (or .bar); holding pauses it, and onExpire fires only on .timeout, so it is the place to commit the destructive action. DFProgressToast: the ring morphs from progress to a success check or failure cross, with Cancel while running and Retry on failure. DFNotificationBanner: push-style banners stacked with depth, newest in front, swipe up to dismiss. DFLiveCapsule: a Dynamic-Island-style pill that expands with matched geometry.

YourContentView().dfUndoToast(
    isPresented: $showPopup, message: "Photo deleted", duration: 5, indicator: .ring,
    onUndo: { }, onExpire: { }
)

YourContentView().dfProgressToast(
    isPresented: $showPopup, state: uploadState, title: "Uploading photo", detail: "3.2 of 8 MB",
    onCancel: { }, onRetry: { }
)   // state: .progress(Double?) | .success | .failure

YourContentView().dfNotificationBanners(items: $banners, onTap: { item in })

YourContentView().dfLiveCapsule(isPresented: $showPopup, isExpanded: $isExpanded, label: "Recording") {
    Image(systemName: "waveform")
} trailing: {
    Text("0:42")
} expanded: {
    Text("Recording voice memo")
}

banners.insert(
    DFNotificationBannerItem(icon: .symbol("message.fill"), title: "Maya", message: "Lunch tomorrow?", timestamp: "now"),
    at: 0
)

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Coachmark tour

Mark targets with .dfPopupAnchor(_:) and run a DFCoachmarkTour over the view that contains them. The dim gets a spotlight cut-out (spotlight: false for a plain scrim) and the callout arrow points at the target. .dfCoachmark shows a single step.

VStack {
    Button("Share") { }.dfPopupAnchor("share")
}
.dfCoachmarkTour(tour, spotlight: true)

// tour: DFCoachmarkTour(steps: [DFCoachmarkStep(target: "share", title: "Share", message: "Send it to a friend.")])
// tour.start()   .next()   .back()   .skip()   .finish()

YourContentView().dfCoachmark(isPresented: $showPopup, target: "share",
                              title: "Share", message: "Send it to a friend.")

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).

Motion and haptics

DFPopupMotion replaces the theme's ease with a spring or a choreography: .snappy .bouncy .gentle springs, .zoom .zoomOut .drop .slideFade .elastic (scale, blur and fade; Reduce Motion falls back to a fade) or .custom(Animation). .motion(_:enterFrom:exitTo:) lets a popup enter from one edge and leave toward another. DFPopupHaptic plays a tactile cue and is a no-op on visionOS (the Simulator produces no haptics, so none are shown here).

YourContentView().dfPopupPresentation(isPresented: $showPopup, motion: .elastic) {
    Text("Bouncy")
}

let bouncy = DFPopupConfiguration.floater(position: .bottom)
    .motion(.bouncy, enterFrom: .bottom, exitTo: .trailing)

DFPopupHaptic.success.play()     // .light .medium .selection .success .warning .error

Recorded from the DFPlayground Popup Lab running on iOS 26 (light/dark, DesignFoundation presets).