Skip to content

Releases

v3.1.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 01:46

Added

  • The swift-cli component, for a SwiftPM command line tool: make cli install, patch and deploy, version and changelog files, CI, and a cask or GitHub release workflow.
  • A manifest's [detect] can have none rules, which no file may match; it needs the templatr command release that reads them, so release the command first.

2.2.0

Choose a tag to compare

@armcknight armcknight released this 18 Nov 01:59

Added

  • templatr bootstrap and check read a manifest's [detect] none rules, and do not detect a component when one matches.

Changed

  • The repository is bootstrapped with its own swift-cli component. make cli build, test, install, uninstall, patch, minor, major, deploy and deploy-beta replace the root Makefile's targets of those names, and make cli install puts the dev build in Homebrew's bin, over the cask's link, in place of ~/.local/bin. The --templates help names make cli install.
  • templatr bootstrap sets the release workflow's MATCH_PASSWORD, MATCH_DEPLOY_KEY, NOTARY_KEY, NOTARY_KEY_ID and NOTARY_ISSUER_ID secrets from the owner's Keychain, as the swift-cli component declares them. 2.1.1 never reached the Homebrew cask: its release run failed before those secrets were set. This release is the first in the tap with a signed and notarized binary.

v3.0.1

Choose a tag to compare

@github-actions github-actions released this 07 Nov 01:44

Changed

  • The apple-app and vapor-fly components' human steps for the App Store
    Connect API keys and the Fly deploy token name templatr store-secrets,
    with its flags, in place of the templatr checkout's bin/store-secrets,
    which templatr 2.0.0 removes.

v3.0.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 01:08

Added

  • The github-repo component's private input, false by default, which
    templatr bootstrap --private records as true: the owner keeps the
    repository private and accepts that GitHub's free plan has no rulesets for
    it. Then the rulesets-available step does not run, so it is not a step for
    a person.

Changed

  • The supabase component needs SUPABASE_ACCESS_TOKEN and
    SUPABASE_DB_PASSWORD only when its migration_style is cli, with the
    manifests' new when. A fluent project no longer gets them as missing
    secrets or steps for a person, or in its README.

Fixed

  • The apple-app component's app-record and tester-group checks run with
    rbenv exec when rbenv is installed. They run with /bin/sh, whose PATH
    has no rbenv shims, so bundle exec used another Ruby than the project's,
    could not load its bundle, and the checks reported the app record and the
    tester group as missing.

2.1.1

Choose a tag to compare

@armcknight armcknight released this 07 Nov 02:33

Fixed

  • The cask's binary is signed with the Developer ID certificate and notarized,
    as tools, workr and superlinear are. 2.1.0's was not.

2.1.0

Choose a tag to compare

@armcknight armcknight released this 07 Nov 02:22

Added

  • templatr is a Homebrew cask in armcknight/homebrew-tools:
    brew install --cask armcknight/tools/templatr. Each release tag builds the
    binary and bumps the cask through armcknight/workflows'
    swiftpm-cask-release.yml. The cask's templatr keeps a clone of this
    repository in ~/Library/Application Support/templatr/templates, made on
    first use, with its tags fetched on each run, and checked out at the newest
    alias, so the components it reads are a release's; --templates and --tag
    choose another checkout or release. A build from a checkout, with
    swift run or make install, uses that checkout as before.
  • make uninstall removes the dev build from ~/.local/bin, so that the
    cask's templatr runs again.

v2.0.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 00:32

Added

  • The static-site component: a website in site/, built with Jekyll, Hugo,
    Vite or nothing, served from a private S3 bucket through CloudFront. One
    CloudFormation template, components/static-site/cloudformation/site.yml,
    owns the bucket, the certificate, the distribution (with the managed
    security headers, a 404 page, and a viewer-request function for directory
    indexes, the trailing-slash redirect and the www redirect) and the DNS
    records; the hosting-stack step deploys it, and templatr check compares
    the stack with it. make/static-site.mk has build, serve,
    endserve, deploy, bust-cache, invalidations, stack and status.
    make site deploy refuses uncommitted changes, uploads the build, clears
    CloudFront, and commits site/DEPLOYED, the commit that is live, as
    deploy(site): <commit>; https://<domain>/DEPLOYED is the same file. The
    scaffold's site/README.md is the checklist of what a site needs before
    and after it is deployed: titles, descriptions, canonical links, Open Graph
    tags, icons, 404.html, robots.txt, the sitemap, Search Console, Bing,
    the link-preview debuggers and the quality checks. Old domains in the
    redirect_from input, such as armcknight.com tworingsoft.com, each get a
    stack from redirect.yml: a certificate for the domain and its www, and a
    distribution whose function answers every request with a permanent redirect
    to the same path on the site; make site redirects makes them, and
    templatr check checks them and that each domain redirects. The manifest's
    shared pieces have a new kind, template.
  • The linear-workspace component links the Linear workspace from the README's
    "Further reading". Its new input linear_workspace is the workspace's URL
    key, the path after linear.app/, which its script reads from the API with
    print workspace when the key is in the environment. A project that already
    uses the component gets the input on its next bootstrap.
  • The root Makefile downloads its fragments to .templatr/make/, next to the
    components' CLAUDE.md copies, and no longer to .superlinear/make/. The
    base component's .gitignore check and fix follow. A project with the old
    directory can delete it: the fragments download again on first use.
  • The root README's "How this project is built" section sits between
    <!-- templatr:begin how-this-is-built --> and <!-- templatr:end -->, the
    same family as the component sections, and no longer superlinear:begin. A
    README that has the old markers must be edited, or bootstrap adds a second
    section at its end.
  • The Keychain items that every component's secrets come from are named
    templatr.<name>, such as templatr.asc.key-id and
    templatr.fly.<app>.deploy-token, and no longer superlinear.<name>. An
    item stored under the old name must be moved by hand: security has no
    rename, so read it with find-generic-password -w, add it under the new
    name, and delete the old one.
  • The mcknight-io-listing component, for a project listed on mcknight.io's
    projects page: the SITE_DISPATCH_TOKEN repository secret, a fine-grained
    personal access token for armcknight/mcknight.io only, from the Keychain item
    templatr.mcknight-io.dispatch-token and made again each year, and a step
    that checks that each job that calls a workflow in armcknight/workflows has
    secrets: inherit, so that the shared workflows' notify step can ask the
    site to refresh. It is opt-in: it is detected only when .templatr.toml
    lists it.
  • The apple-app component's ASC_ADMIN_KEY_ID, ASC_ADMIN_ISSUER_ID and
    ASC_ADMIN_KEY_P8_BASE64 local secrets: the App Store Connect API key with
    the Admin role, which match needs to make or renew certificates and
    profiles. templatr check reports them as missing until they are in the
    Keychain.

Changed

  • The apple-app component's app_name is the name people see, which can have
    spaces, such as Bae Today: it is inferred from the display name
    (INFOPLIST_KEY_CFBundleDisplayName, else APP_DISPLAY_NAME) before
    PRODUCT_NAME. The staging IPA, apple/fastlane/Fastfile's
    APPLE_APP_NAME and a new app's PRODUCT_NAME are the name without spaces,
    and a new app's display name is the name as given. The shared stage lane
    also removes spaces from APPLE_APP_NAME. A project whose name has no
    spaces changes nothing.
  • The make/*.mk fragments write their logs to a logs/ directory in the
    component's directory, such as apple/logs/deploy-beta-44.log and
    server/logs/vapor-fly-deploy-abc1234.log, and no longer next to the
    project files. The scaffolds' .gitignore files ignore logs/, and the
    supabase component's gitignore step checks for it. APPLE_APP_LOG_DIR,
    VAPOR_FLY_LOG_DIR and SUPABASE_LOG_DIR change the directory.

2.0.0

Choose a tag to compare

@armcknight armcknight released this 07 Nov 01:42

Changed

  • bin/store-secrets is now the subcommand templatr store-secrets, with the
    same flags, so it runs from the installed command in any directory, and no
    longer from a checkout of this repository. --check runs templatr check
    directly, not swift run. The apple-app and vapor-fly manifests' human
    texts name the subcommand with its flags.

Removed

  • bin/store-secrets.

1.1.0

Choose a tag to compare

@armcknight armcknight released this 07 Nov 01:08

Added

  • A manifest's secret or step can have when, such as
    { input = "migration_style", equals = "cli" }: the component needs it only
    when the input has that value. With another value, bootstrap and check
    do not read, set, run or report it, and the README does not list it. The
    validator rejects a when whose input the component does not declare.
  • templatr bootstrap and check take --private and --no-private: they
    set the github-repo component's private input, which bootstrap records
    in .templatr.toml and check uses for that run only. Without either, a
    repository is public, or keeps the recorded value.

Fixed

  • A component's step and certificate commands get the values of its local
    secrets that are in the Keychain, in their environment. Before, templatr check only looked for the Keychain items, so apple-app's app-record and
    tester-group checks ran without the App Store Connect API key, stopped
    with "Missing ASC_KEY_ID.", and were reported as steps for a person. A
    variable that the environment already has, such as one from .envrc, keeps
    its value. The values go only to the commands' environment, never to their
    arguments or a report.

1.0.0

Choose a tag to compare

@armcknight armcknight released this 07 Nov 00:33

Added

  • templatr bootstrap sets a project up from its components, and
    templatr check reports what it still needs.
  • The Keychain items that bootstrap and bin/store-secrets write and read are
    named templatr.<name>, such as templatr.asc.key-id, and no longer
    superlinear.<name>.
  • templatr --version prints the version.
  • A manifest's shared pieces can be of the kind template, such as the
    static-site component's CloudFormation template.
  • {{inputs.<name>.compact}} is an input's value without white space, for a
    name people see, such as Bae Today, where a file or an identifier needs
    BaeToday.
  • make install builds with the git commit in the version: templatr --version
    prints 0.1.0+<commit>, and .dirty when the working tree had changes. A
    release build prints the version alone.
  • make patch, minor and major bump the version, and make deploy and
    make deploy-beta tag a release and make its GitHub release.
  • A detect or infer rule with root = true reads from the repository root
    instead of the component's directory, so that a component can be detected
    and its inputs found from another part of the project.
  • bin/store-secrets stores the App Store Connect API keys and the Fly deploy
    tokens in the Keychain, under the item names that the manifests give.
  • A build-setting infer rule with separator reads a list setting, such as
    SUPPORTED_PLATFORMS: it maps each word, drops a value that is already in
    the list, and joins the values with separator.
  • templatr check reports signing certificates, provisioning profiles and
    other files that expire within 30 days, from a manifest's optional
    certificates, whose list command prints each one with its expiry. The
    report's new certificateExpiries has them. The apple-app component lists
    the certificates and profiles in the fastlane match repository.
  • An infer rule with from = "command" takes an input's value from what a
    shell command prints, for a value that is not in a file, such as one a
    service's API gives. It runs in the component's directory, or at the root
    with root = true, with the templates and templates.tag placeholders
    filled in.
  • A manifest's optional links are links to the project's own pages for the
    component, such as its Linear workspace, with placeholders in their URLs.
    bootstrap writes them under "Further reading" in the README's section, and
    leaves out a link whose input has no value.
  • The supabase component is detected from the root also, before its
    supabase/ exists: from a server/Package.swift with
    fluent-postgres-driver, or a .envrc.example with a Supabase host. It
    infers project_ref from .envrc.example, fly_app from server/fly.toml,
    product from server/Package.swift, ca_cert_path from the certificate
    that server/Dockerfile copies, and ca_cert_env from server/fly.toml's
    [env].

Changed

  • templatr check and bootstrap read only the templates' major-version
    aliases, such as v1, and pin new components to the newest one; --tag
    still takes a full tag, such as v1.0.1. A component is behind when a newer
    alias exists, so v1 is behind v2 but not v1.0.1.