{"id":37048429,"url":"https://github.com/ewingjm/power-version","last_synced_at":"2026-01-14T05:38:39.408Z","repository":{"id":211873773,"uuid":"719953375","full_name":"ewingjm/power-version","owner":"ewingjm","description":"A NuGet package to version Power Apps solutions at build-time using Git.","archived":false,"fork":false,"pushed_at":"2025-09-23T10:53:35.000Z","size":42,"stargazers_count":8,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-05T22:39:07.580Z","etag":null,"topics":["dynamics-365","dynamics365","git","gitversion","msbuild","msbuild-task","nuget","power-apps","power-platform","powerapps","powerplatform","semver","versioning"],"latest_commit_sha":null,"homepage":"","language":"C#","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/ewingjm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2023-11-17T09:00:52.000Z","updated_at":"2025-11-27T06:31:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"63d36a15-d895-4586-ac89-6e31361e0e97","html_url":"https://github.com/ewingjm/power-version","commit_stats":null,"previous_names":["ewingjm/power-version"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ewingjm/power-version","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewingjm%2Fpower-version","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewingjm%2Fpower-version/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewingjm%2Fpower-version/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewingjm%2Fpower-version/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ewingjm","download_url":"https://codeload.github.com/ewingjm/power-version/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ewingjm%2Fpower-version/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28410960,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T05:26:33.345Z","status":"ssl_error","status_checked_at":"2026-01-14T05:21:57.251Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["dynamics-365","dynamics365","git","gitversion","msbuild","msbuild-task","nuget","power-apps","power-platform","powerapps","powerplatform","semver","versioning"],"created_at":"2026-01-14T05:38:38.778Z","updated_at":"2026-01-14T05:38:39.401Z","avatar_url":"https://github.com/ewingjm.png","language":"C#","readme":"# PowerVersion![](https://raw.githubusercontent.com/ewingjm/power-version/main/docs/images/logo.svg)\n\nVersion your Power Apps solutions at build-time automatically with Git.\n\n## Table of contents\n\n- [PowerVersion](#powerversion)\n  - [Table of contents](#table-of-contents)\n  - [Introduction](#introduction)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n  - [Usage](#usage)\n    - [Version increments](#version-increments)\n      - [Metadata commits](#metadata-commits)\n      - [Non-metadata commits](#non-metadata-commits)\n      - [Version tags](#version-tags)\n    - [Branch types](#branch-types)\n      - [Configuration](#configuration)\n      - [Mainline branches](#mainline-branches)\n      - [Release branches](#release-branches)\n      - [Topic branches](#topic-branches)\n  - [Contributing](#contributing)\n\n\n## Introduction\n\nGenerating [Semantic Versions](https://semver.org/)  from Git history is often a sensible approach to versioning artifacts. It is also made incredibly easy thanks to tools such as [GitVersion](https://github.com/GitTools/GitVersion) and [semantic-release](https://github.com/semantic-release/semantic-release). \n\nPower Apps solutions have some unique challenges when applying this approach:\n\n- Multiple solutions often need to be versioned independently within the same repository\n- Solution versions do not conform fully to the Semantic Versions specification\n\n**PowerVersion** is designed to address these challenges and provide similar functionality to the tools mentioned above.\n\n## Prerequisites\n\n\n- You must have a solution project created with the Power App CLI\n- Your solution project must exist within a Git repository\n- Your Git workflow must be similar to Microsoft's [Release flow](https://learn.microsoft.com/en-us/devops/develop/how-microsoft-develops-devops#microsoft-release-flow)\n\n## Installation\n\nInstall the [PowerVersion.MSBuild](https://www.nuget.org/packages/PowerVersion.MSBuild) NuGet package into your solution project (_.cdsproj_).\n\n```shell\ndotnet add package PowerVersion.MSBuild\n```\n\n## Usage\n\nSimply build the solution project and the outputted solution's version will be set by PowerVersion based on the Git history.\n\n### Version increments\n\nThis section describes the different mechanisms in place to increment the solution version for a commit.\n\nThe starting version for the calculation is either the version in the _Solution.xml_ (if no [version tag](#version-tags) is found) or the version in the latest version tag. It is recommended to set the version in the _Solution.xml_ to `0.0.0` to ensure that all versioning is handled by PowerVersion - if have an existing solution project, create a version tag to ensure version calculation is started at the correct version.\n\n#### Metadata commits\n\nMetadata commits are commits that make updates under the solution metadata directory. By default, this is the `src` folder in the project created by the Power Apps CLI with `pac solution init`.\n\nThese commits will automatically increment the solution version. The kind of increment depends on the commit message title and is based on [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/):\n\n- A commit message with an `!` after the Conventional Commits type is a major increment (`refactor!: delete obsolete components`)\n- A commit message with a Conventional Commits type of `feat` is a minor increment (`feat: create an application`)\n- A commit message containing anything else is a patch increment (`fix: contact form script error`)\n\n#### Non-metadata commits\n\nNon-metadata commits are commits that don't make any changes under the solution metadata directory but _do_ update files that are mapped into the solution at build-time with the Solution Packager. Typically, these will relate to code components such as web resources and plug-in assemblies. \n\nThese kinds of commits do **not** automatically increment the solution version as it is not possible to determine which solutions have been updated. You must explicitly bump the solution manually using the following in the commit message body:\n\n\u003e +semver(\\\u003csolution-unique-name\\\u003e): \\\u003cincrement\\\u003e\n\n- An `\u003cincrement\u003e` of `major` or `breaking` is a major increment\n- An `\u003cincrement\u003e` of `minor` or `feature` is a minor increment\n- An `\u003cincrement\u003e` of `patch` or `fix` is a patch increment\n\nAn explicit version increment of this type will take precedence if the same commit also increments the version as a metadata commit.\n\n#### Version tags\n\nIt's possible to override the version calculated for a given commit using a Git tag:\n\n\u003e \\\u003csolution-unique-name\\\u003e/#.#.#\n\nThe version calculation will start at the most recent version tag for the solution (or the first commit if no tags are found). It is recommended to periodically create a version tag to improve the performance of the version calculation.\n\n### Branch types\n\nThe version calculation differs based on the branch type.\n\n#### Configuration\n\nThere are two MSBuild properties that can be set to configure how the branch type is determined for a given branch.\n\n```xml\n\u003cPropertyGroup\u003e\n  \u003cMainlineBranch\u003emaster\u003c/MainlineBranch\u003e\n  \u003cReleaseBranchPrefix\u003erelease/\u003c/ReleaseBranchPrefix\u003e\n\u003c/PropertyGroup\u003e\n```\n\n#### Mainline branches\n\nThe mainline branch is `master` by default but this is configurable with the `MainlineBranch` MSBuild property.\n\nThe version of the mainline branch is calculated by determining the type of increment for each commit and applying each increment in order.\n\n#### Release branches\n\nA release branch is any branch that is prefixed by `release/` by default but this is configurable with the `ReleaseBranchPrefix` MSBuild property.\n\nThe version is calculated by taking the mainline version (for the commit the release branch is based on) and setting the revision part of the version to the total number of commits on the release branch that increment the solution version. Only release branches generate a revision version (e.g. `#.#.#.#` rather than `#.#.#`) and this avoids hotfix versions clashing with mainline versions.\n\n#### Topic branches\n\nA topic branch is a branch that is neither the mainline branch nor does it match the release branch prefix.\n\nThe version of a feature branch is calculated by taking the mainline version (for the commit the feature branch is based on) and incrementing this by the highest increment found on the feature branch.\n\n## Contributing\n\nRefer to the contributing [guide](./CONTRIBUTING.md).","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fewingjm%2Fpower-version","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fewingjm%2Fpower-version","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fewingjm%2Fpower-version/lists"}