You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.