{"id":27373806,"url":"https://github.com/johnnyhuy/versioneer","last_synced_at":"2026-05-01T21:33:25.360Z","repository":{"id":122634979,"uuid":"451223670","full_name":"johnnyhuy/versioneer","owner":"johnnyhuy","description":"🏆 Standalone tool version your Git repos following conventional-commits","archived":false,"fork":false,"pushed_at":"2024-05-05T06:27:39.000Z","size":694,"stargazers_count":1,"open_issues_count":10,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-27T17:44:42.432Z","etag":null,"topics":["conventional-commits","git","github-actions","semantic-version","standard-version","version"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/johnnyhuy.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,"zenodo":null}},"created_at":"2022-01-23T20:33:03.000Z","updated_at":"2024-05-05T06:27:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"92f3315c-4e20-47ed-88d2-3358a22d0d3f","html_url":"https://github.com/johnnyhuy/versioneer","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/johnnyhuy/versioneer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnnyhuy%2Fversioneer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnnyhuy%2Fversioneer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnnyhuy%2Fversioneer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnnyhuy%2Fversioneer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnnyhuy","download_url":"https://codeload.github.com/johnnyhuy/versioneer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnnyhuy%2Fversioneer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32513685,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["conventional-commits","git","github-actions","semantic-version","standard-version","version"],"created_at":"2025-04-13T11:28:52.445Z","updated_at":"2026-05-01T21:33:25.334Z","avatar_url":"https://github.com/johnnyhuy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Versioneer\n\nAn *opinionated* standalone tool used to quickly version Git repos that wraps around [Conventional Changelog](https://github.com/conventional-changelog) projects.\n\nThe goal of this project is to make versioning a portable as possible.\n\n### It's yet another versioning tool\n\nThis is a learning experience to distribute a CLI package across different platforms.\n\n### Alternatives\n\nThis tool may not suit your project. However, there are plenty of more mature open source projects that solve version release management.\n\n- [`release-it/release-it`](https://github.com/release-it/release-it#git)\n- [`semantic-release/semantic-release`](https://github.com/semantic-release/semantic-release)\n- [`conventional-changelog/standard-version`](https://github.com/conventional-changelog/standard-version)\n\n## 🏆 Features\n\n- Bumps Git tags based on [Conventional commits](https://www.conventionalcommits.org/en/v1.0.0/)\n- Commits version bumps to `package.json`\n- Version rollback\n- Purges all tags\n- Multi-platform - MacOS x64 \u0026 ARM, Windows x64, Linux x64, Docker\n\n## 🚀 Getting Started\n\n\n### Prerequisites\n\n- [Git](https://git-scm.com/)\n\n### Installation\n\n#### Homebrew\n\n```bash\nbrew install johnnyhuy/homebrew-repo/versioneer\n```\n\n#### Linux\n\n```bash\ncurl -L https://github.com/johnnyhuy/versioneer/releases/download/v1.0.0/versioneer-linux-x64.tar.gz -O - | tar -xf /usr/local/bin/versioneer\n```\n\n#### Windows\n\n```bash\nchoco install -y versioneer\n```\n\n#### Docker\n\n```bash\ndocker run -v $PWD:/opt/workspace --rm johnnyhuy/versioneer\n```\n\n### Usage\n\n```text\nUsage: versioneer [options] [command]\n\nOptions:\n  -d --debug       Show debugging messages\n  -h, --help       display help for command\n\nCommands:\n  apply [options]  Version this directory\n  purge [options]  Purge all versions from this directory\n  help [command]   display help for command\n```\n\n## 🐈 Default behaviour\n\n### `versioneer apply`\n\n1. Asks to bump the current directory Git tag\n2. Detects a `package.json` and bump the version\n3. Bumps local Git tag\n\n(Optional) Use the `--push` option to sync changes to the remote.\n\n### `versioneer rollback` - WIP\n\n1. Asks to rollback the latest version in the current directory\n2. Deletes latest local Git tag\n4. Hard Git reset to last known SerVer Git tag\n\n(Optional) Use the `--push` option to sync changes to the remote.\n\n### `versioneer purge`\n\n1. Asks to delete all SemVer Git tags in the current directory\n2. Deletes all local tags\n\n(Optional) Use the `--push` option to sync changes to the remote.\n\n## 📜 Configuration\n\nVersioneer will use **environment variables first** before looking for a versioneer configuration file.\n\n### Environment variables\n\n```env\nVERSIONEER_DEBUG=true\n```\n\n### Configuration file `.versioneer.yaml`\n\nAliases include `.versioneer.yaml`, `.versioner`\n\n```yaml\ndebug: true\n\napply:\n  force: true\n  dryRun: true\n\nrelease:\n  force: true\n  dryRun: true\n\nrollback:\n  force: true\n  dryRun: true\n\npurge:\n  dryRun: true\n```\n\n## ✍️ Contributing\n\nAny feedback is welcome! Fork out and raise a pull request.\n\nWe can use [VSCode dev containers](https://code.visualstudio.com/docs/remote/containers) to quickly spin up a NodeJS environment through [Docker](https://docs.docker.com/get-docker/). Once the environment is setup, just install Node packages.\n\n```bash\nnpm i\n```\n\nUse the VSCode JavaScript Terminal to start debugging!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnnyhuy%2Fversioneer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnnyhuy%2Fversioneer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnnyhuy%2Fversioneer/lists"}