{"id":22180027,"url":"https://github.com/ngworker/angular-versions-action","last_synced_at":"2026-03-16T08:36:10.122Z","repository":{"id":40280908,"uuid":"302494054","full_name":"ngworker/angular-versions-action","owner":"ngworker","description":"Github Action that modifies the package.json and match dependency versions for a given base Angular version","archived":false,"fork":false,"pushed_at":"2023-01-07T21:43:28.000Z","size":1299,"stargazers_count":13,"open_issues_count":12,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-03-15T15:21:20.955Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/ngworker.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-09T00:37:22.000Z","updated_at":"2023-04-18T12:42:28.000Z","dependencies_parsed_at":"2023-01-11T17:21:51.351Z","dependency_job_id":null,"html_url":"https://github.com/ngworker/angular-versions-action","commit_stats":{"total_commits":92,"total_committers":7,"mean_commits":"13.142857142857142","dds":0.5434782608695652,"last_synced_commit":"789aa282d502cbd0f4a1eaab070205f1e72a52f4"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":"actions/typescript-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngworker%2Fangular-versions-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngworker%2Fangular-versions-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngworker%2Fangular-versions-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngworker%2Fangular-versions-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ngworker","download_url":"https://codeload.github.com/ngworker/angular-versions-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227700442,"owners_count":17806365,"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":[],"created_at":"2024-12-02T09:16:35.848Z","updated_at":"2026-03-16T08:36:10.094Z","avatar_url":"https://github.com/ngworker.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Action - Match Angular Versions\n\nThis GitHub Action (written in JavaScript) modifies the root `package.json` of a project and replaces the version of all **Angular** related dependencies for given base version.\n\nWhen necessary it updates the angular.json to use the correct builder.\n\n[![ngworker](https://img.shields.io/badge/ngworker-%40-red)](https://github.com/ngworker/)\n\n## Usage\n\n### Pre-requisites\n\nCreate a workflow `.yml` file in your repositories `.github/workflows` directory. An [example workflow](#example-workflow---match-Angular-versions) is available below. For more information, reference the GitHub Help Documentation for [Creating a workflow file](https://help.github.com/en/articles/configuring-a-workflow#creating-a-workflow-file).\n\n### Inputs\n\n- `angular-version`: The base Angular version used to match the dependency version. Ex: 8.0.x, 10.0.x. To check the full list of supported versions, see [supported versions](#Supported-Angular-versions).\n- `root-path`: The path to the root folder of the project where the `package.json` and `angular.json` files are located. Defaults to `./`.\n\n### Example workflow - match Angular versions\n\n```yaml\nname: CI workflow\n\non:\n  push:\n    branches:\n      - main\n  pull_request:\n    branches:\n      - main\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n\n    strategy:\n      matrix:\n        angular-version:\n          - 6.0.x\n          - 6.1.x\n          - 7.0.x\n          - 7.1.x\n          - 7.2.x\n          - 8.0.x\n          - 8.1.x\n          - 8.2.x\n          - 9.0.x\n          - 9.1.x\n          - 10.0.x\n          - 10.1.x\n          - 10.2.x\n          - 11.0.x\n          - 11.1.x\n          - 11.2.x\n          - 12.0.x\n          - 12.1.x\n          - 12.2.x\n          - 13.0.x\n\n    steps:\n      - uses: actions/checkout@v2\n      - name: Use Node.js 12.x\n        uses: actions/setup-node@v2\n        with:\n          node-version: 12.x\n      - name: Use Angular ${{ matrix.angular-version }}\n        uses: ngworker/angular-versions-action@v4\n        with:\n          angular-version: ${{ matrix.angular-version }}\n\n      - run: yarn install\n      - run: yarn lint\n      - run: yarn build\n      - run: yarn test\n```\n\nThis example use the github matrix to build, lint and test your code against different versions of `Angular`. This should be specially useful for library authors.\n\n### Supported Angular versions\n\nAt the moment this actions supports a limited set of Angular versions listed below.\n\n- 6.0.x\n- 6.1.x\n- 7.0.x\n- 7.1.x\n- 7.2.x\n- 8.0.x\n- 8.1.x\n- 8.2.x\n- 9.0.x\n- 9.1.x\n- 10.0.x\n- 10.1.x\n- 10.2.x\n- 11.0.x\n- 11.1.x\n- 11.2.x\n- 12.0.x\n- 12.1.x\n- 12.2.x\n- 13.0.x\n\n### Managed packages\n\nThe following packages are managed by this action:\n\n- `@angular/animations`\n- `@angular/cdk`\n- `@angular/cli`\n- `@angular/common`\n- `@angular/compiler`\n- `@angular/compiler-cli`\n- `@angular/core`\n- `@angular-builders/jest`\n- `@angular-devkit/build-angular`\n- `@angular-devkit/build-ng-packagr`\n- `@angular-devkit/schematics-cli`\n- `@angular/elements`\n- `@angular/forms`\n- `@angular/google-maps`\n- `@angular/material`\n- `@angular/platform-browser`\n- `@angular/platform-browser-dynamic`\n- `@angular/router`\n- `@angular/youtube-player`\n- `@types/node`\n- `codelyzer`\n- `ng-packagr`\n- `rxjs`\n- `tsickle `\n- `tslib`\n- `tslint`\n- `ts-node`\n- `typescript`\n- `zone.js`\n\n### Additional features\n\n- Replace the `angular.json` library builder (ng-packagr) based on the angular version.\n  - Use `@angular-devkit/build-ng-packagr:build` for version prior (\u003c) Angular 10.1\n  - Use `@angular-devkit/build-angular:ng-packagr` for version post (\u003e=) Angular 10.1\n- Remove `allowedCommonJsDependencies` options on Angular versions under 10\n\n## Contributing\n\nWe would love you to contribute to `@ngworker/angular-versions-action`, pull requests are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) for more information.\n\n## Contributors\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/NachoVazquez\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/9338604?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eNacho Vazquez\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#question-NachoVazquez\" title=\"Answering Questions\"\u003e💬\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/issues?q=author%3ANachoVazquez\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#business-NachoVazquez\" title=\"Business development\"\u003e💼\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=NachoVazquez\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=NachoVazquez\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"#example-NachoVazquez\" title=\"Examples\"\u003e💡\u003c/a\u003e \u003ca href=\"#ideas-NachoVazquez\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"#infra-NachoVazquez\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e \u003ca href=\"#maintenance-NachoVazquez\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e \u003ca href=\"#projectManagement-NachoVazquez\" title=\"Project Management\"\u003e📆\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/pulls?q=is%3Apr+reviewed-by%3ANachoVazquez\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e \u003ca href=\"#security-NachoVazquez\" title=\"Security\"\u003e🛡️\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=NachoVazquez\" title=\"Tests\"\u003e⚠️\u003c/a\u003e \u003ca href=\"#tool-NachoVazquez\" title=\"Tools\"\u003e🔧\u003c/a\u003e \u003ca href=\"#userTesting-NachoVazquez\" title=\"User Testing\"\u003e📓\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://dev.to/layzee\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/6364586?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eLars Gyrup Brink Nielsen\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ngworker/angular-versions-action/issues?q=author%3ALayZeeDK\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=LayZeeDK\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=LayZeeDK\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"#example-LayZeeDK\" title=\"Examples\"\u003e💡\u003c/a\u003e \u003ca href=\"#ideas-LayZeeDK\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"#infra-LayZeeDK\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e \u003ca href=\"#maintenance-LayZeeDK\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e \u003ca href=\"#mentoring-LayZeeDK\" title=\"Mentoring\"\u003e🧑‍🏫\u003c/a\u003e \u003ca href=\"#platform-LayZeeDK\" title=\"Packaging/porting to new platform\"\u003e📦\u003c/a\u003e \u003ca href=\"#plugin-LayZeeDK\" title=\"Plugin/utility libraries\"\u003e🔌\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/pulls?q=is%3Apr+reviewed-by%3ALayZeeDK\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e \u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=LayZeeDK\" title=\"Tests\"\u003e⚠️\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"http://timdeschryver.dev\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/28659384?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eTim Deschryver\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=timdeschryver\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://blog.profanis.me/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/7045092?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eprofanis\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ngworker/angular-versions-action/commits?author=profanis\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n\n## License\n\nThe scripts and documentation in this project are released under the [MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngworker%2Fangular-versions-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fngworker%2Fangular-versions-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngworker%2Fangular-versions-action/lists"}