{"id":14384381,"url":"https://github.com/atlassian/lerna-semantic-release","last_synced_at":"2025-08-23T17:31:49.927Z","repository":{"id":45289020,"uuid":"59081726","full_name":"atlassian/lerna-semantic-release","owner":"atlassian","description":"📦:🛠✨💥 – fully automated package publishing","archived":false,"fork":true,"pushed_at":"2024-04-17T02:58:39.000Z","size":836,"stargazers_count":684,"open_issues_count":39,"forks_count":36,"subscribers_count":36,"default_branch":"caribou","last_synced_at":"2024-12-17T00:25:26.531Z","etag":null,"topics":["lerna","semantic-release"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/lerna-semantic-release","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"semantic-release/semantic-release","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atlassian.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-18T04:23:41.000Z","updated_at":"2024-12-04T15:53:02.000Z","dependencies_parsed_at":"2023-02-09T10:16:41.279Z","dependency_job_id":null,"html_url":"https://github.com/atlassian/lerna-semantic-release","commit_stats":null,"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atlassian%2Flerna-semantic-release","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atlassian%2Flerna-semantic-release/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atlassian%2Flerna-semantic-release/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atlassian%2Flerna-semantic-release/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atlassian","download_url":"https://codeload.github.com/atlassian/lerna-semantic-release/tar.gz/refs/heads/caribou","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230716486,"owners_count":18269773,"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":["lerna","semantic-release"],"created_at":"2024-08-28T18:01:20.640Z","updated_at":"2024-12-21T12:30:30.335Z","avatar_url":"https://github.com/atlassian.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# lerna-semantic-release\n\nStatus:\n[![npm version](https://img.shields.io/npm/v/lerna-semantic-release.svg?style=flat-square)](https://www.npmjs.org/package/lerna-semantic-release)\n[![npm downloads](https://img.shields.io/npm/dm/lerna-semantic-release.svg?style=flat-square)](http://npm-stat.com/charts.html?package=lerna-semantic-release)\n[![Build Status](https://img.shields.io/travis/atlassian/lerna-semantic-release.svg?style=flat-square)](https://travis-ci.org/atlassian/lerna-semantic-release)\n\n\n[semantic-release](https://www.npmjs.com/package/semantic-release) for [lerna](http://lernajs.io)-based projects.\n\nBasically a semantic-release that orders commits based on which package they belong to (uses data from [cz-lerna-changelog](https://github.com/atlassian/cz-lerna-changelog)) and then determines on that what the next release should be.\n\n## Setup\n### Setting up commitizen\nInstall cz-lerna-changelog in your repository:\n\n```\nnpm install commitizen -g\n```\n\nNext, initialize your project to use the cz-lerna-changelog adapter by typing:\n\n```\ncommitizen init cz-lerna-changelog --save-dev --save-exact\n```\n\nSee the [commitizen-cli](https://github.com/commitizen/cz-cli) docs for more details on how to set up commitizen with the correct adapter.\n\n### Setting up the build\n\nYou'll need to set up your build in such a way that tags and commits can be pushed back to the repository. This is so that lerna can stay in sync with the NPM releases.\n\nYou'll also need to set the `NPM_TOKEN` environment variable so that npm can run `npm publish` on your components.\n\n#### Travis CI integration\n\nSee `.travis.yml` and `.travis/` in this repository for examples of how to set up lerna-semantic-release with Travis CI.\n\nThe following environment variables will need to be set:\n\n```\nNPM_CONFIG_EMAIL \nNPM_CONFIG_USERNAME \nNPM_TOKEN \nGH_TOKEN \nRELEASE_GH_TOKEN\nRELEASE_GH_USERNAME\n```\n\n## Releasing\n\nExecute these commands in your release process:\n\n```\n# Pre\nlerna-semantic-release pre # Set up the versions, tags and commits\n\n# Perform\nlerna-semantic-release perform # Publishes to npm\n\n# Post\nlerna-semantic-release post # Generates a changelog in each package in a file named CHANGELOG.md - will not commit or push that file any more after version 7.0.5 any more. If you want to do something with it, you will need to do this manually.\n\nThis will publish all npm packages, including creating commits and tags for each release, in the format that lerna expects for the `lerna updated` command.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatlassian%2Flerna-semantic-release","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatlassian%2Flerna-semantic-release","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatlassian%2Flerna-semantic-release/lists"}