\n\nWeaver runs from a central repo (e.g. your `.github` repo) and threads rendered\ntemplate content into marked sections of files across your other repos. It reads\nand writes through the GitHub API — no cloning — and opens a pull request per\nrepo with the changes.\n\nConsumer repos need zero workflow setup: they just add HTML comment markers to\nthe files they want managed.\n\n```html\n\n\n```\n\nWeaver replaces everything between a matching `START`/`END` pair with the\nrendered template whose name matches the block (`footer.md` → `weaver:footer`).\nFiles without markers are left untouched. Marker lines inside fenced code\nblocks (like the example above) are treated as documentation and ignored.\n\n## Usage\n\n```yaml\nname: Sync templates\non:\n push:\n branches: [main]\n paths: [\"templates/**\"]\n workflow_dispatch:\n\njobs:\n sync:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v4\n - id: weaver\n uses: allonsy-studio/actions-weaver@v3\n with:\n token: ${{ secrets.WEAVER_PAT }}\n templates: templates\n variables: |\n {\n \"org\": { \"website\": \"https://allons-y.studio\" }\n }\n - run: echo '${{ steps.weaver.outputs.pull-requests }}'\n```\n\n**Important:** The default `GITHUB_TOKEN` cannot write to other repos. Supply a\nfine-grained PAT or GitHub App token scoped to the target repos via `token`.\n\n## How it works\n\n1. Read every `*.md` file in the `templates` directory; each file's basename is\n its block name.\n2. Resolve the target repos (the running repo's owner is used as the org).\n3. For each repo, fetch the target file, render the templates with that repo's\n metadata, and replace the content between markers.\n4. If anything changed, push to a head branch and open (or reuse) one pull\n request per repo.\n5. Emit the list of pull requests as an output.\n\n## Templates\n\nTemplates use a minimal, logic-light syntax:\n\n| Syntax | Meaning |\n| --------------------- | ---------------------------------- |\n| `{{ key }}` | Value, HTML-escaped |\n| `{{{ key }}}` | Value, raw (for URLs and markdown) |\n| `{{#if key}}…{{/if}}` | Conditional inclusion |\n\nBuilt-in variables per repo: `repo.name`, `repo.full_name`, `repo.description`,\n`repo.url`, `repo.default_branch`, `repo.license`, `repo.language`,\n`repo.topics`, `org.name`, `org.url`. Anything you pass via the `variables`\ninput is merged on top.\n\n## Inputs\n\n| Name | Default | Description |\n| ------------------ | -------------------------------------------- | -------------------------------------------------------------------------------- |\n| `token` | `${{ github.token }}` | Token with write access to the target repos (PAT or GitHub App token). |\n| `templates` | `templates` | Directory of template `*.md` files; each basename becomes a block name. |\n| `target-file` | `README.md` | File to inject template blocks into within each target repo. |\n| `repos` | `*` | Comma/newline list of repo names, or `*` for every non-archived, non-fork repo. |\n| `exclude` | — | Repo names to skip (only applies when `repos` is `*`). |\n| `skip-forks` | `true` | Skip forked repos when listing the org. |\n| `skip-archived` | `true` | Skip archived repos when listing the org. |\n| `variables` | — | JSON object of template variables, merged over the built-ins. |\n| `managed-notice` | _(see action.yml)_ | Notice text inserted below each START marker. |\n| `commit-message` | `chore: sync templates via Weaver [skip ci]` | Commit message (supports template variables). |\n| `branch` | `weaver/sync-templates` | Head branch created in each target repo for the PR. |\n| `base` | _repo default branch_ | Base branch for the pull request. |\n| `pr-title` | `chore: sync templates via Weaver` | Pull request title (supports template variables). |\n| `pr-body` | _(see action.yml)_ | Pull request body (supports `{{ blocks }}`). |\n| `dry-run` | `false` | Render and diff without creating branches or pull requests. |\n| `max-value-length` | `1000` | Max length for an interpolated value before truncation. |\n| `fail-on-error` | `true` | Fail the job when a repo errors; set `false` to report failures without failing. |\n| `max-retries` | `3` | Retries for transient GitHub failures (secondary rate limits, 5xx) per repo. |\n\n## Outputs\n\n| Name | Description |\n| --------------- | ---------------------------------------------------------------------------------- |\n| `pull-requests` | JSON array of `{ repo, url, number }` for every PR opened or updated. |\n| `summary` | JSON object counting `opened` / `updated` / `skipped` / `dryRun` / `failed` repos. |\n\n## Development\n\n```sh\nyarn lint # eslint\nyarn test # jest\nyarn coverage # jest with the 80% coverage threshold\n```\n\n\n\n\n
![\"Brought](\"https://raw.githubusercontent.com/allonsy-studio/.github/main/assets/png/oss-banner.png\")
\n![\"Brought](\"https://raw.githubusercontent.com/allonsy-studio/.github/main/assets/png/oss-footer-light.png\")
\n