Feedback/DSAlert

DSAlert

feedback

since v1.0

Inline alert banner with an icon, title, optional message, and a dismiss button. Non-modal.

iOS 17+macOS 14+

Purpose

Contextual feedback inside forms or sections, without interrupting the full screen.

Interactive Reference

Live showroom

Need the full visual surface?

Screenshots do not scale well across every component, state, and variant. For the real interactive reference, import the package and launch DSShowcaseRoot().

Best for exploring:

variants, states, categories, and real app examples in one place.

Variants

.info

Neutral information. Blue tint.

.success

Action confirmed. Green tint.

.warning

Requires attention. Yellow tint.

.error

Failure or validation error. Red tint.

Props

Prop	Type	Default	Description
titlereq	String	—	Alert heading.
message	String?	nil	Optional body text.
style	DSToastStyle	.info	Semantic style.
isDismissable	Bool	true	Shows a close button.

Examples

Form validation banner

Error alert shown when form submission fails.

swift

if viewModel.hasError {
    DSAlert(
        title: "Submission failed",
        message: viewModel.errorMessage,
        style: .error
    )
}

Success confirmation

Persistent success message in a form.

swift

VStack(alignment: .leading, spacing: DSSpacing.md) {
    if formSubmitted {
        DSAlert(
            title: "Form submitted successfully",
            message: "We'll review your application and get back to you within 48 hours.",
            style: .success
        )
    }
    
    // Form fields...
}

Composition: Warning with action

Alert with inline action button.

swift

DSAlert(
    title: "Storage almost full",
    message: "You're using 95% of your storage. Upgrade to get more space.",
    style: .warning,
    isDismissable: false
)

DSButton("Upgrade Now", variant: .primary) {
    showUpgradeModal = true
}