How to Publish Org Starter Workflows in GitHub

Starter workflows live in the org .github repo and appear as suggestions when any repo opens the Actions tab.

Put a workflow file plus a .properties.json under workflow-templates/ in your org-level .github repository. GitHub surfaces it as a one-click starter for every repo in the org.

Steps

• Create (or open) the org-level repository literally named .github.
• Add workflow-templates/node-ci.yml with your pipeline.
• Add workflow-templates/node-ci.properties.json describing it.
• Use the $default-branch placeholder so the copy targets the new repo default branch.

Template properties

{
  "name": "Node CI (paved road)",
  "description": "Lint, test, and build for Node services",
  "iconName": "example",
  "categories": ["Node", "Continuous integration"],
  "filePatterns": ["package.json$"]
}

Gotchas

• The template file and its .properties.json must share the same base name.
• filePatterns decides which repos see the suggestion; match on a marker file like package.json.

Related guides