Use this template as a starting point for any Swift 5 module that you want other people to include in their projects.

STATUS: This template is ready and works in production code, compatible with Xcode 15.2 (15C500b)

Your new Swift 5 module will immediately have working, compilable code, and implement these best practices:

• Ability to be used from Swift Package Manager
• Clean folder structure
• MIT license
• Testing as a standard
• Turnkey access to GitHub Actions testing
• Semantic versioning and a CHANGELOG
• Included example/demo app using SwiftUI
• Use a Xcode project to manage your code

Clone or download a release and run the ./configure.rb program. It will ask you some questions and generate a project.

You then add all the interesting features you want your module to have.

To skip interactive prompts in the ./configure script, use these environment variables:

For example, you may use: export SMT_ORGANIZATION_NAME='Awesome Org' before running ./configure.

graph LR
    subgraph Contributors to this project
    X[Use Xcode] --> R[Update Recipe.md]
    R --> T[Update template]
    end
    T --> C
    subgraph End users of this project
    C[Run ./configure.rb] --> M[Use your own module]
    end

See the file Recipe.md for the complete steps (e.g. Open Xcode, make new project, click here, type that, …) of how we made the template.