How do I change the alert colors in CleanyModal?

Create a custom subclass of CleanyAlertViewController and set styleSettings properties like tintColor or destructiveColor in the initializer, as shown in the README example for applying themes easily.

CleanyModal or UIAlertViewController: which should I use?

Choose CleanyModal if you need extensive visual customization, custom content, or dark/light mode tweaks; use UIAlertViewController for simple, native alerts where minimal setup and default iOS styling are sufficient.

Can I use CleanyModal in a SwiftUI project?

Yes, but it requires bridging via UIViewControllerRepresentable since CleanyModal is UIKit-based, adding complexity compared to native SwiftUI modal solutions.

How to add a text field to a CleanyModal alert?

Leverage the content UIStackView feature mentioned in the README to easily integrate text fields or custom views, allowing for interactive input within alerts.

Does CleanyModal automatically support dark mode?

Yes, it has built-in support for dark and light modes in iOS 13 and above, with default implementations that adapt to system settings without extra code.

Is CleanyModal compatible with iOS 15 or later?

It supports iOS 9.0+ and Swift 4.2+, so it should work with newer iOS versions, but check the GitHub repo for updates on specific compatibility or issues.

Open-Awesome

CleanyModal

MITSwift

A Swift UI Kit for presenting clean, customizable modal alerts and action sheets with iOS 13+ dark/light mode support.

GitHub

485 stars26 forks0 contributors

What is CleanyModal?

CleanyModal is a Swift UI Kit designed to present clean, highly customizable modal alerts and action sheets in iOS applications. It provides a drop-in replacement for UIAlertViewController with enhanced styling options, support for custom views, and built-in dark/light mode compatibility. The library solves the problem of limited customization in native iOS alerts while maintaining a familiar API.

Target Audience

iOS developers building applications that require branded, visually consistent modal alerts and action sheets beyond the default UIAlertViewController capabilities.

Value Proposition

Developers choose CleanyModal for its balance of simplicity and customization—it offers a clean API similar to UIAlertViewController but with extensive theming options, support for custom components, and automatic iOS 13+ dark/light mode adaptation without extra configuration.

Overview

Swift UI Kit to present clean modal/alert

Use Cases

Best For

Replacing UIAlertViewController with branded alert designs
Adding custom views or text fields to modal alerts
Implementing action sheets with consistent app styling
Presenting fully custom components as modals
Ensuring dark/light mode compatibility in alerts
Swift-based iOS projects needing lightweight UI customization

Not Ideal For

Projects fully built with SwiftUI that require native modal components without UIKit bridging
Teams needing pre-styled, out-of-the-box alert designs with no configuration, such as those using comprehensive UI libraries
Applications where minimizing third-party dependencies is a priority, and native UIAlertViewController meets all functional needs

Pros & Cons

Pros

Familiar API Integration

Uses the same API as UIAlertViewController, reducing the learning curve for iOS developers and making it easy to drop into existing codebases.

Extensive Visual Customization

Allows deep theming through style settings, enabling brand-consistent alerts with properties like tintColor and destructiveColor, as demonstrated in the example code.

Custom Content Support

Supports adding text fields or custom views via a content UIStackView, expanding alert functionality beyond standard native options.

Modern iOS Features

Built-in dark and light mode compatibility for iOS 13+, ensuring alerts adapt automatically to system themes without extra configuration.

Cons

Subclassing Overhead

Theming requires creating custom subclasses, such as MyAlertViewController, adding boilerplate code compared to configuration-based or declarative alternatives.

UIKit-Only Limitation

Lacks native SwiftUI support, making it less suitable for modern iOS projects adopting Apple's declarative UI framework without additional bridging code.

Dependency Management

Primarily distributed via CocoaPods, with no explicit mention of Swift Package Manager or Carthage, which could complicate integration in projects using other dependency managers.

Frequently Asked Questions

Related Projects

SwiftMessages

A very flexible message bar for UIKit and SwiftUI.

Stars7,556

Forks765

Last commit3 months ago

Alerts & Pickers

Advanced usage of UIAlertController and pickers based on it: Telegram, Contacts, Location, PhotoLibrary, Country, Phone Code, Currency, Date...

Stars5,759

Forks708

Last commit2 years ago

BulletinBoard

General-purpose contextual cards for iOS

Stars5,351

Forks302

Last commit4 years ago

SCLAlertView-Swift

Beautiful animated Alert View. Written in Swift

Stars5,319

Forks753