Swiftpack.co - yhkaplan/scaffold as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by yhkaplan.
yhkaplan/scaffold 0.3.0
Tool for generating code from Stencil templates, similar to rails gen
⭐️ 31
🕓 1 week ago
.package(url: "https://github.com/yhkaplan/scaffold.git", from: "0.3.0")


Swift Version

Scaffold is a tool for generating code from Stencil templates, similar to rails gen. It happens to be written in Swift, but it can output source files for any language.

Here's how it works:

$ scaffold --template ViewModel --name Search # Output one specific template
🏭 Rendering templates...
🔨 SearchViewModel.swift created at Sources/Search/SearchViewModel.swift
✅ Complete

$ scaffold --group Feature --name Search # Output multiple templates at the same time
🏭 Rendering templates...
🔨 SearchViewController.swift created at Sources/Search/SearchViewController.swift
🔨 SearchViewModel.swift created at Sources/Search/SearchViewModel.swift
🔨 SearchRouter.swift created at Sources/Search/SearchRouter.swift
🔨 SearchViewModelTests.swift created at Tests/ViewModels/SearchViewModelTests.swift
✅ Complete

Templates are written in a language called Stencil:

//  {{ name }}ViewModel.swift

import Foundation
import RxSwift
import RxRelay

protocol {{ name }}ViewModelInputs {
    func fooButtonDidTap()
protocol {{ name }}ViewModelOutputs: AutoTestableOutputs {
    var fooButtonIsEnabled: Driver<Bool> { get }
    var shouldHideKeyboard: Signal<Bool> { get }
protocol {{ name }}ViewModelType {
    var inputs: {{ name }}ViewModelInputs { get }
    var outputs: {{ name }}ViewModelOutputs { get }

final class {{ name }}ViewModel: {{ name }}ViewModelType, {{ name }}ViewModelOutputs {

Also, you can use extensions to Stencil defined in StencilSwiftKit.



$ brew tap yhkaplan/scaffold https://github.com/yhkaplan/scaffold.git
$ brew install scaffold


$ git clone git@github.com:yhkaplan/scaffold.git
$ cd scaffold
$ make install



  1. Make some templates (The Stencil documentation is very helpful)
  2. Define templates and groups in a .scaffold.yml file (see Configuration)
  3. You're ready to go!

If you want to pass in complex values from the your local development environment, a Makefile like below can be useful.

SCAFFOLD_CONTEXT="name=$(name),user=$$(git config user.name),date=$$(date -u +"%Y/%m/%d")"

	scaffold --group Feature --context $(SCAFFOLD_CONTEXT)

	scaffold --template $(template) --context $(SCAFFOLD_CONTEXT)

To use it, just call make template template=View name=Hoge or make feature name=Search


Config file

templates: # Required (array of Templates)
  - name: ViewController # Required (string)
    templatePath: Templates/ # Required (string)
    fileName: "{{ name }}ViewController.swift" # Required (string)
    outputPath: Sources/Controllers/ # Optional (string)
  - name: ViewModel
    templatePath: Templates/
    fileName: "{{ name }}ViewModel.swift"
    outputPath: Sources/ViewModels/
groups: # Optional (array of TemplateGroups)
  - name: Feature # Required (string)
    templateNames: # Required (array of template names as strings)
    - ViewController
    - ViewModel
    outputPath: # Optional (string)

Command line options

  -d, --dry-run           Print the output without writing the file(s) to disk.
                          Default is false.
  -o, --output-path <output-path>
                          Path to output folder(s).
  -t, --template <template>
                          Single template or comma-separated list of templates
                          to generate from the config file
  -g, --group <group>     Group from config file with list of templates
  --config-file-path <config-file-path>
                          Path to config file. Default is .scaffold.yml
  -n, --name <name>       Value to pass to the name variable in the stencil
  -c, --context <context> String with context values to pass to template
                          (overrides name).
  -C, --context-file-path <context-file-path>
                          Path to JSON file with context values to pass to
                          template (overrides name)
  -h, --help              Show help information.


Xcode's templates

Articles like those below discuss how to make custom templates for Xcode, but the biggest issues with custom Xcode templates are as below. That said, they may be enough for you.

  1. The format can change with any new version of Xcode, breaking your templates
  2. There's a limited range of variables and customizability available
  3. Sharing templates with team members involves awkward scripts that symlink to the correct folder
  4. They can't be used from the command line (more of a personal preference)


Genesis also uses Stencil for templating, but it seems more focused on new projects and interactive commands whereas Scaffold is more focused on continual use.


Kuri does not use Stencil for templating, instead choosing an Xcode-like DSL. This is enough for many use-cases, but I wanted something with the flexibility of Stencil where I could feed in any kind of information I want into the templates. Also, Kuri has a nice feature where it can add generated files to Xcode automatically. I may add this feature in later, but I am still considering whether I should.


  • Stencil for a delightful templating language
  • StencilSwiftKit for a powerful Stencil library
  • Sourcery for its deeply thought-out example of StencilSwiftKit
  • Yams for effortless yml parsing
  • PathKit for easy-to-use path operations
  • ArgumentParser for Swifty argument-parsing
  • Genesis for inspiration on balancing config and template files
  • Kuri for inpiration of how the CLI should work and config file should look
  • pointfree.co and their episodes on Parser combinators, a very direct inspiration for the Parser target


Licensed under MIT license. See LICENSE for more info.


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

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