Swiftpack.co - ShabanKamell/SwiftUIFormValidator as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by ShabanKamell.
ShabanKamell/SwiftUIFormValidator 0.20.0
Declarative form validator for SwiftUI.
⭐️ 46
🕓 2 weeks ago
iOS macOS tvOS
.package(url: "https://github.com/ShabanKamell/SwiftUIFormValidator.git", from: "0.20.0")

Gray shape shifter


The world's easiest, most clean SwiftUI form validation.

Stargazers repo roster for @ShabanKamell/SwiftUIFormValidator


A declarative SwiftUI form validation. Clean, simple, and customizable.

Discuss it on Product Hunt 🦄

Form Screenshot

Table of contents

:zap: Usage

Basic Setup

  // 1 
import FormValidator

// 2
class FormInfo: ObservableObject {
    @Published var firstName: String = ""
    // 3
    lazy var form = {
        FormValidation(validationType: .immediate)
    // 4
    lazy var firstNameValidation: ValidationContainer = {
        $firstName.nonEmptyValidator(form: form, errorMessage: "First name is not valid")

struct ContentView: View {
    // 5
    @ObservedObject var formInfo = FormInfo()

    var body: some View {
        TextField("First Name", text: $formInfo.firstName)
                .validation(formInfo.firstNameValidation) // 6
  1. Import FormValidator.
  2. Declare an ObservableObject for the form with any name, for example, FormInfo, LoginInfo, or any name.
  3. Declare FormValidation object and choose a validation type.
  4. Declare a ValidationContainer for the field you need to validate.
  5. In your view, declare the FormValidation object.
  6. Declare validation(formInfo.firstNameValidation) with the validation of the field.

Congratulation!! your field is now validated for you!

Custom Error View

You can provide your own custom error view by providing the view with the validation modifier

TextField("First Name", text: $formInfo.firstName)
        .validation(formInfo.firstNameValidation) { message in

Inline Validation

For fast validation, you can use InlineValidator and provide your validation logic in line:

 lazy var lastNamesValidation: ValidationContainer = {
    $lastNames.inlineValidator(form: form) { value in
        // Put validation logic here

Validation Types

You can choose between 3 different validation types: FormValidation(validationType: .immediate) and FormValidation(validationType: .deffered) FormValidation(validationType: .silent)

  1. immediate: the validation is triggered every time the field is changed. An error message will be shown in case the value is invalid.
  2. deferred: in this case, the validation will be triggered manually only using FormValidation.triggerValidation() The error messages will be displayed only after triggering the validation manually.
  3. silent: In this case, no validation message is displayed, and it's your responsibility to display them using FormValidation.validationMessages().

Manual Validation

You can trigger the form validation any time by calling FormValidation.triggerValidation(). After the validation, each field in the form will display error message if it's invalid.

React to Validation Change

You can react to validation change using FormValidation.$allValid and FormValidation.$validationMessages

VStack {
} // parent view of the form
        .onReceive(formInfo.form.$allValid) { isValid in
            self.isSaveDisabled = !isValid
        .onReceive(formInfo.form.$validationMessages) { messages in

:tada: Installation

Swift Package Manager

Xcode Projects

Select File -> Swift Packages -> Add Package Dependency and enter https://github.com/ShabanKamell/SwiftUIFormValidator.git.

Swift Package Manager Projects

You can add SwiftUIFormValidator as a package dependency in your Package.swift file:

let package = Package(
        dependencies: [
            .package(url: "https://github.com/ShabanKamell/SwiftUIFormValidator.git", .upToNextMajor(from: "0.18.1"))

From there, refer to SwiftUIFormValidator in target dependencies:

targets: [
            name: "YourLibrary",
            dependencies: [
                .product(name: "FormValidator", package: "SwiftUIFormValidator"),
    // ...

Then simply import SwiftUIFormValidator wherever you’d like to use the library.


Use the following entry in your Podfile:

pod 'SwiftUIFormValidator'

Then run pod install.


Accio is a dependency manager based on SwiftPM which can build frameworks for iOS/macOS/tvOS/watchOS. Therefore the integration steps of SwiftUIFormValidator are exactly the same as described above. Once your Package.swift file is configured, run accio update instead of swift package update.

Don't forget to add import FormValidator to use the framework.


Carthage users can point to this repository and use generated SwiftUIFormValidator framework.

Make the following entry in your Cartfile:

github "ShabanKamell/SwiftUIFormValidator"

Then run carthage update.

If this is your first time using Carthage in the project, you'll need to go through some additional steps as explained over at Carthage.


Validator Description
NonEmptyValidator Validates if a string is empty or blank
EmailValidator Validates if the email is valid.
DateValidator Validates if a date falls within after & before dates.
PatternValidator Validates if a patten is matched.
InlineValidator Validates if a condition is valid.
PasswordValidator Validates if a password is valid.
PrefixValidator Validates if the text has a prefix.
SuffixValidator Validates if the text has a suffix.

Custom Validators

In easy steps, you can add a custom validator:

// 1
public class NonEmptyValidator: StringValidator {
    public var publisher: ValidationPublisher!
    public var subject: ValidationSubject = .init()
    public var onChanged: [OnValidationChange] = []

    public var errorMessage: StringProducerClosure = {
    public var value: String = ""

    public func validate() -> Validation {
        if value.trimmingCharacters(in: .whitespaces).isEmpty {
            return .failure(message: errorMessage())
        return .success

// 2
extension Published.Publisher where Value == String {
    func nonEmptyValidator(
            form: FormValidation,
            errorMessage: @autoclosure @escaping StringProducerClosure = ""
    ) -> ValidationContainer {
        let validator = NonEmptyValidator()
        let message = errorMessage()
        return ValidationPublishers.create(
                form: form,
                validator: validator,
                for: self.eraseToAnyPublisher(),
                errorMessage: !message.isEmpty ? message : form.messages.required)
  1. Implement FormValidator protocol.
  2. Add the validator logic in an extension to Published.Publisher.


NonEmptyValidator is a built-in validator in the library.

Validation Messages

You can provide a validation message for every field by providing errorMessage

$firstName.nonEmptyValidator(form: form, errorMessage: "First name is not valid")

If you don't provide a message, a default one will be used for built-in providers. All default messages are located in DefaultValidationMessages class.

$firstName.nonEmptyValidator(form: form) // will use the default message

In this example, DefaultValidationMessages.required will be used.

Overriding Default Validation Messages

You can override the default validation messages by inheriting from DefaultValidationMessages

class ValidationMessages: DefaultValidationMessages {
    public override var required: String {
        "Required field"
    // Override any message ...

Or if you need to override all the messages, you can implement ValidationMessagesProtocol.

And provide the messages to FormValidation

FormValidation(validationType: .immediate, messages: ValidationMessages())


Validation with SwiftUI & Combine

:clap: Contribution

All Pull Requests (PRs) are welcome. Help us make this library better.


Look at Changelog for release notes.


click to reveal License
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.


Stars: 46
Last commit: 3 weeks ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

3 weeks ago

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics