A Swift package for simple management of forms and their fields. Focused on SwiftUI.


A Swift package for simple management of forms and its fields. Focused on SwiftUI.


  • Declarative form and validation definition.
  • Single state for the whole form with its fields.
  • Support for non-String validations and fields like toggles, sliders, selection, multi-selection and more.
  • Cross-field validation, comparing values of more fields with each other (like password and password again fields).
  • Some standard built-in validations (required, empty, email and methods for combining validation rules).
  • Works nicely with the new @FocusState APIs.


You can define a form state like this as a simple struct instead of defining more state properies for each field:

struct SignupForm {
    var name: String
    var email: String
    var password: String
    var acceptedPrivacyPolicy: Bool

To setup prefilled values for the field you can use default property values (or some static instance if you prefer):

struct SignupForm {
    var name = String()
    var email = String()
    var password = String()
    var acceptedPrivacyPolicy = false

To declare validation logic for the form you can create an array of validations:

let validations: [FormValidation<SignupForm>] = [
    FormValidation(for: \.name, description: "Name must be filled in.", rule: .required),
    FormValidation(for: \.email, description: "Email must be filled in.", rule: .required),
    FormValidation(for: \.email, description: "Email is not in in valid format.", rule: .email),
    FormValidation(for: \.password, description: "Password is required.", rule: .required),
    FormValidation(for: \.password, description: "Password must be longer than 6 characters") { $0.count > 6 },
    FormValidation(for: \.acceptedPrivacyPolicy, description: "You need to accept privacy policy.", rule: .hasToBeOn)

And if you want to use the package for focus management you can define array of key paths as a field order.

let fieldOrder: [PartialKeyPath<Self>] = [\.name, \.email, \.password]

When you have your form declared you can you it in the view:

struct SignupView: View {
    @State private var state = FormState(form: SignupForm())

    @FocusState private var focus: PartialKeyPath<SignupForm>?

    var body: some View {
        Form {
            Section {
                TextField("Name", text: $
                    .focused($focus, equals: \.name)
                    .onSubmit {
                        state.submit(field: \.name, updating: &focus)
                ForEach(errors, id: \.self, content: Text.init)


            Section {
                Button(action: submit) {
                    Label("Submit", systemImage: "arrow.right")

    private func submit() {
        if state.validate() {
        } else {


When using Swift package manager install using Xcode 11+ or add following line to your dependencies:

.package(url: "", from: "0.1.0")


All contributions are welcome.

Current maintainer and main contributor is Matěj Kašpar Jirásek,


FormStateKit is available under the MIT license. See the LICENSE file for more information.


  • Swift Tools 5.3.0
View More Packages from this Author


  • None
Last updated: Mon Nov 14 2022 12:10:17 GMT-0500 (GMT-05:00)