🛳 Ship.js

Take control of what is going to be your next release.
https://community.algolia.com/shipjs/

## Features - Automated - Minimize your effort for release and make less mistakes. - Asynchronous - You don't have to release on your local machine. Do it asynchronously and continue your work. - Collaborative - Don't sweat it alone. Review the next release on pull request with your colleagues. ## Installation Running the following command will guide you to set it up interactively. ```bash npx shipjs setup ``` This interactive CLI will help you install Ship.js into your package and create a tailored config file for your project. ![npx shipjs setup](./website/guide/setup.png) ## Why 🤷🏻‍ Coding is fun, debugging and testing are okay, but releasing is NOT. When releasing, you go through something like the following: - Update the version in `package.json` - Update the changelog - Actually release it (e.g. `npm run build && npm publish`) - Create a git tag - Create a release on GitHub ### What could go wrong? - You might make mistakes during the release. - Environments are different across your team members. - You're releasing alone because the whole process happens on your local machine. - It's not your everyday-job. Mistakes can happen. - You are blocked and cannot do anything else until it's done. - Even if you have a release script, you need to watch until the script finishes well. - You don't want to switch to another feature branch and work there until the script finishes. ## How to solve them❓ In Ship.js, the release process consists of three parts. ### Part 1. Preparation (`shipjs prepare`) ![Preview](./website/guide/preview.gif) Run `shipjs prepare` and it will briefly do the following: - Figure out next version. - Update the version and changelog. - Create a pull request. It takes less than a couple of minutes. ### Part 2. Review - Review the PR by yourself, or with your colleagues. - Add more commits to the PR if you want. - You can hold the release, build from the staging branch and test it manually. - If you want to cancel the release, just close the PR and delete the staging branch. When you think it's ready to release, merge the PR. ### Part 3. Trigger a release (`shipjs trigger`) Run `shipjs trigger` and it will briefly do the following: - Run a final test (unit, e2e, etc). - Release it to NPM (or elsewhere as you configure it). - Create a git tag for the version. - Create a release for the tag on GitHub. You can manually run `shipjs trigger` on the base branch after the PR is merged. However you can also configure your CI service(e.g. CircleCI) to do this for you. It means the longest process is on the CI service asynchronously, not occupying your working environment. ## Getting Started Let's move on to the [guide](https://community.algolia.com/shipjs/guide/getting-started.html). Or, you can watch this video if you prefer. [![Getting Started with Ship.js](https://img.youtube.com/vi/FPj7urChN_E/0.jpg)](https://www.youtube.com/watch?v=FPj7urChN_E) ## How is it different from semantic-release? **semantic-release** is a tool for `fully automated version management and package publishing`. Ship.js gives you more control over the release process. Ship.js automatically creates a PR before publishing every release, so that you can: - Confirm the next version is correct. - Confirm which commits are going to be released and discuss them with colleagues. - Edit the automatically generated changelog for clarity & readability. - Run any automated tests on the package release candidate. - Build a release candidate automatically (with [Pika CI](https://github.com/marketplace/pika-ci-cd) or [CodeSandbox](https://github.com/apps/codesandbox)). ## How to Contribute? [Read Contribution Guide →](https://community.algolia.com/shipjs/guide/contributing.html) ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

_{Eunjae Lee} 💻 📖	_{Fred K. Schott} 📖	_{Yasuaki Uechi} 💻 📖	_{Dmitry Ivakhnenko} 💻 📖	_{James George} 💻 📖	_{kazuya kawaguchi} 💻 📝	_tyankatsu 💻 📖
_{Haroen Viaene} 💻	_{Shinya Ohyanagi} 💻	_{Donghoon Song} 💻	_{Miyata Jumpei} 💻	_lulzneko 💻 📖	_{Vinayak Kulkarni} 💻

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! ## Badge [![deploy](https://img.shields.io/badge/deploy-🛳%20Ship.js-blue?style=flat)](https://github.com/algolia/shipjs) Show the world you're using Ship.js ```md [![deploy](https://img.shields.io/badge/deploy-🛳%20Ship.js-blue?style=flat)](https://github.com/algolia/shipjs) ``` ```html

```

	Stars	Issues	Version	Updated	Created
gh-pages	3,187	120	6.1.1	5 months ago	10 years ago
publish-please			5.5.2	4 years ago	8 years ago
release-it	7,601	21	17.2.1	22 days ago	10 years ago
shipit-cli			5.3.0	4 years ago	9 years ago
shipjs	766	17	0.26.3	a year ago	5 years ago

gh-pages vs publish-please vs release-it vs shipit-cli vs shipjs

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past