{"id":15107146,"url":"https://github.com/nitzano/semantic-release-github-milestones","last_synced_at":"2025-10-23T02:31:02.985Z","repository":{"id":36972906,"uuid":"407824248","full_name":"nitzano/semantic-release-github-milestones","owner":"nitzano","description":"Sync github milestones with semantic release 🚩🚀","archived":false,"fork":false,"pushed_at":"2024-05-06T05:25:30.000Z","size":1913,"stargazers_count":5,"open_issues_count":13,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-30T16:52:44.074Z","etag":null,"topics":["github","semantic-release","semantic-release-plugin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nitzano.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-18T10:06:14.000Z","updated_at":"2024-11-28T02:17:24.000Z","dependencies_parsed_at":"2023-12-30T14:22:46.570Z","dependency_job_id":"99151c0a-e102-4898-a074-7717129bbf54","html_url":"https://github.com/nitzano/semantic-release-github-milestones","commit_stats":{"total_commits":80,"total_committers":2,"mean_commits":40.0,"dds":0.08750000000000002,"last_synced_commit":"1a4ab065f891fe5fa95dbd0a5bab30b21191c09d"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitzano%2Fsemantic-release-github-milestones","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitzano%2Fsemantic-release-github-milestones/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitzano%2Fsemantic-release-github-milestones/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitzano%2Fsemantic-release-github-milestones/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nitzano","download_url":"https://codeload.github.com/nitzano/semantic-release-github-milestones/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237278038,"owners_count":19283934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github","semantic-release","semantic-release-plugin"],"created_at":"2024-09-25T21:04:46.105Z","updated_at":"2025-10-23T02:30:57.435Z","avatar_url":"https://github.com/nitzano.png","language":"TypeScript","readme":"\u003ch1 align=\"center\" style=\"border-bottom: none;\"\u003e semantic-release-github-milestones🚩🚀\u003c/h1\u003e\n\u003ch2 align=\"center\"\u003eSync \u003ca href=\"https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/about-milestones\"\u003eGithub milestones\u003c/a\u003e with \u003ca href=\"https://github.com/semantic-release/semantic-release\"\u003esemantic-release\u003c/a\u003e\u003c/h2\u003e\n\n\n\u003cdiv align=\"center\"\u003e\n\n[![npm latest version](https://img.shields.io/npm/v/semantic-release-github-milestones/latest.svg)](https://www.npmjs.com/package/semantic-release-github-milestones)\n[![npm next version](https://img.shields.io/npm/v/semantic-release-github-milestones/next.svg)](https://www.npmjs.com/package/semantic-release-github-milestones)\n[![npm beta version](https://img.shields.io/npm/v/semantic-release-github-milestones/beta.svg)](https://www.npmjs.com/package/@semantic-release/github)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n[![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/xojs/xo)\n\n\u003c/div\u003e\n\n| Step               | Description                                                                                                                        |\n| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `verifyConditions` | Verify github tokens are present and valid.                                                                                         |\n| `verifyRelease`    | Display information regarding the github milestone.                                                               |\n\u003c!-- | `success`          | [TBD] Close the target [GitHub milestone](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/about-milestones). |\n| `fail`             | [TBD] Show a descriptive message to why the release failed                                                                               | --\u003e\n\n## Highlights\n\n*  Shows [Github milestones](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/about-milestones) summary information when releasing a new version.\n* Matches milestones either by:\n  * Next release version (`v1.1.0`, `2.2.0`, ...)\n  * Channel name (`next`, `beta`, ...)\n  * Branch name ( `master`, `next-major`, ...)\n\n\n### Future versions\n\n* Appends milestone data to Github Releases \n* Automatically closes milestones after releasing\n* Protects against releasing milestones with open issues\n  \n## Examples\n\n### Milestone with open issues\n\n```\n[semantic-release-github-milestones] › ℹ  🚩 Github Milestone: v1.0.1  🚩\n[semantic-release-github-milestones] › ℹ  (https://github.com/owner1/repo1/milestone/1)\n[semantic-release-github-milestones] › ℹ  6 total issues\n[semantic-release-github-milestones] › ℹ  ⚠️ ⚠️  2 open issues ⚠️ ⚠️\n```\n\n### Milestone without open issues\n\n```\n[semantic-release-github-milestones] › ℹ  🚩 Github Milestone: next  🚩\n[semantic-release-github-milestones] › ℹ  (https://github.com/owner1/repo1/milestone/7)\n[semantic-release-github-milestones] › ℹ  15 total issues\n[semantic-release-github-milestones] › ℹ  No open issues ✔️\n```\n\n\n\n## Install\n```\nnpm install --save-dev semantic-release-github-milestones\n```\n\n\n## Usage\n\nThe plugin can be configured in the [**semantic-release** configuration file](https://github.com/semantic-release/semantic-release/blob/master/docs/usage/configuration.md#configuration):\n\n```json\n{\n  \"plugins\": [\n    \"@semantic-release/commit-analyzer\",\n    \"@semantic-release/release-notes-generator\",\n    \"semantic-release-github-milestones\",\n  ]\n}\n```\n\n## Configuration\n\nGithub authentication  is **required** and can be set via [environment variables](#environment-variables).\n\n### Environment variables\n\n| Variable                                           | Description                                               |\n| -------------------------------------------------- | --------------------------------------------------------- |\n| `GH_TOKEN` or `GITHUB_TOKEN`                       | **Required.** The token used to authenticate with GitHub. |\n\n\n\u003c!-- ## Options\n\nTBD --\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitzano%2Fsemantic-release-github-milestones","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnitzano%2Fsemantic-release-github-milestones","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitzano%2Fsemantic-release-github-milestones/lists"}