fosmvvm-generators

FOSUtilities

There are multiple libraries provided by the FOSUtilities package: FOSFoundation, FOSMVVM, FOSTesting, FOSTestingUI, FOSMVVMVapor, FOSTestingVapor.

Documentation

For guides, articles, and API documentation see the library's documentation on the Web or in Xcode.

FOSFoundation

FOSFoundation is a library of protocols, patterns, types and routines that I have found generally useful in my projects. Support areas include:

• Extensions to URL for one-line REST-Style requests
• Extensions to JSONEncoder and JSONDecoder for single-statement encoding/decoding of Codables
  • Along with standardized support for handling various Date and DateTime styles
    • ISO 8601
    • JSON
• Extensions to Collection for throttling execution of requests when servers restrict the number of requests per any time period
• Extensions on String such as:
  • CamelCase / snake_case conversion
  • Hexadecimal String to/from UInt64, Int64, UInt, and Int
  • Cleaning and standardizing user-provided input
  • Generating random and unique Strings
  • Swift Range support
  • String obfuscation/revealing (e.g., ROT 13/ROT 47)

For guides, articles, and API documentation see the library's documentation on the Web or in Xcode.

FOSMVVM

FOSMVVM is a library that implements the Model-View-ViewModel pattern for binding SwiftUI projects to Vapor web services.

For guides, articles, and API documentation see the library's documentation on the Web or in Xcode.

• Getting Started with FOS MVVM

Quick Glance

Here is an example of setting up a new Model-View-ViewModel-based client application

View Model

@ViewModel
public struct LandingPageViewModel: RequestableViewModel {
    public typealias Request = LandingPageRequest

    @LocalizedString public var pageTitle

    public var vmId = ViewModelId()

    public init() {}

    public static func stub() -> Self { .init() }
}

View

struct LandingPageView: ViewModelView {
    let viewModel: LandingPageViewModel

    var body: some View {
        VStack {
            Text(viewModel.pageTitle)
                .font(.headline)
                .padding(.bottom, 30)
        }
        .padding()
    }
}

Client Application Main

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            LandingPageView.bind()
        }
        .environment(
             MVVMEnvironment(
                 currentVersion: .currentApplicationVersion,
                 appBundle: Bundle.main,
                 deploymentURLs: [
                    .production, .init(serverBaseURL: URL(string: "http://api.mywebserver.com")!),
                    .staging, .init(serverBaseURL: URL(string: "http://staging-api.mywebserver.com")!),
                    .debug, .init(serverBaseURL: URL(string: "http://localhost:8080")!)
                 ]
            )
        )
    }
}

Vapor Server Application

public func configure(_ app: Application) async throws {
    // uncomment to serve files from /Public folder
    // app.middleware.use(FileMiddleware(publicDirectory: app.directory.publicDirectory))
    // register routes
    try routes(app)

    try app.initYamlLocalization(
        bundle: Bundle.module,
        resourceDirectoryName: "Resources"
    )
}

func routes(_ app: Application) throws {
    app.routesregister(viewModel: LandingPageViewModel.self)
}

Claude Code Integration

This repository includes Claude Code skills for generating FOSMVVM architecture components. These skills help automate the creation of ViewModels, Fields protocols, DataModels, ServerRequests, and Leaf Views following FOSMVVM patterns.

Available Skills