{"id":28817758,"url":"https://github.com/this-oliver/fist-bump","last_synced_at":"2026-04-28T16:03:22.989Z","repository":{"id":142518833,"uuid":"613090315","full_name":"this-oliver/fist-bump","owner":"this-oliver","description":"bump your package version automatically 👊","archived":false,"fork":false,"pushed_at":"2025-07-10T20:36:39.000Z","size":592,"stargazers_count":1,"open_issues_count":8,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-03T03:58:48.096Z","etag":null,"topics":["git","nodejs","npm","package-json","typescript","versioning"],"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/this-oliver.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-03-12T21:05:04.000Z","updated_at":"2025-07-10T20:36:43.000Z","dependencies_parsed_at":"2023-07-12T01:17:04.463Z","dependency_job_id":"9c33033a-f0f1-4ec6-afdd-674d523cacdc","html_url":"https://github.com/this-oliver/fist-bump","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/this-oliver/fist-bump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/this-oliver%2Ffist-bump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/this-oliver%2Ffist-bump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/this-oliver%2Ffist-bump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/this-oliver%2Ffist-bump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/this-oliver","download_url":"https://codeload.github.com/this-oliver/fist-bump/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/this-oliver%2Ffist-bump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32387923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T14:34:11.604Z","status":"ssl_error","status_checked_at":"2026-04-28T14:32:37.009Z","response_time":56,"last_error":"SSL_read: 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":["git","nodejs","npm","package-json","typescript","versioning"],"created_at":"2025-06-18T19:01:07.764Z","updated_at":"2026-04-28T16:03:22.984Z","avatar_url":"https://github.com/this-oliver.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fist-bump 👊\n\n\u003e Bump the version of your package.json based on your commit messages\n\n\u003e [!WARNING]\n\u003e Use [googleapis/release-please](https://github.com/googleapis/release-please) instaed - it's time tested and maintained unlike this hobby project ;)\n\n## features\n\n- [x] Bump the version of your package.json based on your commit messages\n- [x] Automatically ammend version update to the last commit\n- [ ] Integrate with git hooks (coming soon)\n\n## installation\n\n\u003e Recommended to install as a dev dependency\n\n```bash\nnpm install --save-dev fist-bump\n```\n\n## usage\n\n```bash\n# current version: 1.0.0\n\n# prefixing a commit message with the supported keywords\ngit commit -m 'feature: added new feature'\n\n# run fist bump to update the version of your package.json\nnpx fistbump\n\n# the new version =\u003e 1.1.0\n# the updated commit message =\u003e '[1.1.0] feature: added new feature'\n```\n\n*good to know:* `fist-bump` will skip any commits that have '[skip]' and '[wip]' or an existing version tag in the commit message.\n\n## configuration\n\nTo customize this `fist-bump`, all you have to do is add a `fistbump` property to your `package.json` file.\n\n```json\n{\n \"fistbump\": {\n  \"patch\": [ \"fix\", \"patch\" ], // `1.0.0` -\u003e `1.0.1`\n  \"minor\": [ \"feature\", \"config\", \"minor\" ], // `1.0.0` -\u003e `1.1.0`\n  \"major\": [ \"breaking\", \"release\", \"major\" ], // `1.0.0` -\u003e `2.0.0`\n  \"position\": \"start\" // `(v1.1.0) feature: added new feature`\n }\n}\n```\n\n\u003e Note: the example above shows the configuration values\n\n### versioning keywords\n\nThe `patch`, `minor`, `major` properties represent the type of version bump that will be applied to your package.json (see [semantic versioning](https://docs.npmjs.com/about-semantic-versioning) for more details):\n\n| type    | default keywords               | version bump       | description                               |\n| ------- | ------------------------------ | ------------------ | ----------------------------------------- |\n| `patch` | `fix`, `patch`                 | `1.0.0` -\u003e `1.0.1` | bug fix, backwards compatible             |\n| `minor` | `feature`, `config`, `minor`   | `1.0.0` -\u003e `1.1.0` | new feature, backwards compatible         |\n| `major` | `breaking`, `release`, `major` | `1.0.0` -\u003e `2.0.0` | breaking change, not backwards compatible |\n\nThe keywords are case sensitive and will be matched against the following pattern in your commit message: `\u003ckeyword\u003e:` or `[\u003ckeyword\u003e]`. For example, the following commit messages will be matched against the `patch` keyword:\n\n- `fix: fixed a bug` =\u003e the keyword is `fix` which belongs to the `patch` version type\n- `feature|major: a whole new way to do stuff` =\u003e the keyword is `feature` which belongs to the `minor` version type even though it also matches the `major` keyword\n\n\u003e Note: adding custom keywords to will completely override their default keywords, respectively. in other words, if you add a custom `patch` keyword, the default `fix` and `patch` keywords will no longer be supported.\n\n### configuring the tag position - `position`\n\nThe `position` property determins where the version tag will be placed in the commit message.\n\n| position | example commit message                |\n| -------- | ------------------------------------- |\n| `start`  | `(v1.1.0) feature: added new feature` |\n| `end`    | `feature: added new feature (v1.1.0)` |\n\n## contributing\n\nWant to contribute?\n\n1. read the [contributing doc](./docs/contributing.md)\n2. open an issue or submit a pull request with your changes\n\n## changelog\n\nTo see what has changed between versions, check out the [changelog](./docs/changelog.md).\n\n## security\n\nIf you discover a security vulnerability, feel free to open an issue at [github.com/this-oliver/fist-bump/issues](https://github.com/this-oliver/fist-bump/issues). All security vulnerabilities will be promptly addressed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthis-oliver%2Ffist-bump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthis-oliver%2Ffist-bump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthis-oliver%2Ffist-bump/lists"}