• Project information: README.md
  • Help us! How to contribute: CONTRIBUTING.md
  • Work with us! How we work: docs/how-we-work.md
  • Shipkit release notes: docs/release-notes.md
• User guides
  • Getting started: docs/getting-started.md
  • How Shipkit works: docs/how-shipkit-works.md
  • FAQ: docs/faq.md

You will be more productive if your releases are fully automated and happen on every change. You will build great product if you can focus on code & features, but not on the release overhead. Shipkit will make it happen. Shipkit is a toolkit for shipping it.

Every team should be empowered to develop with rapid velocity, frictionless releases and semantic versioning just like we do it in Mockito. Shipkit enables Mockito to automatically publish new versions to 2M Mockito users!

Using Shipkit? Submit a pull request and add your project to the list!

• Mockito: https://github.com/mockito/mockito
• Powermock: https://github.com/powermock/powermock
• Shipkit: https://github.com/mockito/shipkit
• rx-tasks: https://github.com/ashdavies/rx-tasks/
• Shipkit example: https://github.com/mockito/shipkit-example

If the vision of the project connects with you help us!!!

• Open a new GitHub ticket to start the conversation. We love feedback, brainstorming and discussions.
• Drop a comment to one of the existing "help wanted" tickets, and tell us that you are interesting in implementing it.
• Try out Shipkit in your project and give feedback
• If you like emails, join the mailing list, but be warned that we rarely use emails, and prefer GitHub tickets.
• Spread the word about Shipkit, let us know about other projects with similar goals.

Currently, Shipkit offers Gradle plugins for automating releases of Java libraries and Gradle plugins. Basic use case is simple: You have code that wants to be delivered to your customers, Shipkit has tools to help you out:

• automatic version bumps in "version.properties" file - don’t waste time managing your version manually
• automatically generated release notes in markdown - offer your customer clean information what changed and why
• automatic including contributors in pom.xml - appreciate the community
• release notes that highlight each individual contributor by name - build engaged community
• avoiding publishing binaries if nothing changed - respect your customers’ time
• automatic shipping to Bintray and Maven Central - use every opportunity to give your product to the hands of customers
• keeping secure tokens safe - masks sensitive values from logging and error messages from underlying tools like git
• and all that in a sweet little package, fully integrated, neatly automated, easy to roll out

For details see "How Shipkit Works?"

Add Gradle plugin:

plugins {
  // TODO: Use latest version from https://plugins.gradle.org/plugin/org.shipkit.java
  id "org.shipkit.java" version "2.0.0" // use 1.0.12 if you still need Java 6/7 and/or Gradle 2/3 support
}

Initialize:

./gradlew initShipkit

Perform release:

./gradlew performRelease

For more and detailed information see docs/getting-started.md

• 2014, August - we set up automated continuous delivery for Mockito project, every merged pull requested produced release notes and new version in Maven Central. We still do it today in Mockito!
• 2016, November - we pushed out the release automation toolkit to a separate project in GitHub, called "mockito-release-tools". We really needed to do that! As much as useful the toolkit was to drive Mockito releases, we needed to make it reusable, well documented, and packaged as a separate binary.
• 2017, February - Marcin Stachniuk joins the team, implements automatic fetching of contributors from GitHub and starts working on automatic e2e testing of library clients.
• 2017, March - Shipkit mentioned in DevoxxUS'17 conference in San Jose, "Great tools for engineers: even cleaner tests with Mockito 2" talk (video)
• 2017, March - Wojtek Wilk joins the team, implements release avoidance when binaries aren't changed in comparison to previous release, starts driving API compatibility validation and Shipkit dogfooding.
• 2017, April - we found a neat name for our project: "Shipkit", a toolkit for shipping it! We registered the domain: http://shipkit.org
• 2017, May - there are 5 contributors in total, we expanded the vision of the project, and currently working on killer features like: automated e2e testing with library consumers + automated pushes of version upgrades #85, A/B testing of build results when upgrading dependencies.
• 2017, June - "Ship every change to production!" presentation at Software Architecture conference in Santa Clara, CA (abstract).
• 2017, June - Szczepan includes information about Shipkit in his presentation at Gradle Summit conference in Palo Alto, CA. (abstract, slides, video)
• 2017, July - Shipkit presented at Confitura '17 conference in Warsaw (abstract, slides, video)
• 2017, July/August - Shipkit presentations at JUG meetups in Poland: all abstracts, Krakow (slides), Wroclaw (slides), and Bielsko-Biala (slides).
• 2017, October - Shipkit mentioned at JavaOne '17 conference in San Francisco in 2 talks:
  • "You Deserve Great Tools: Commit-to-Production Automation at LinkedIn" (summary, video, slides)
  • "You Deserve Great Tools: Mockito 2 for Cleaner Tests and Enhanced Productivity" (summary, slides). There was no video taken at JavaOne but this talk was recorded at DevoxxUS'17 conference (video).
• 2017, November - Shipkit mentioned at QCon '17 conference in San Francisco:
  • "CI/CD at scale: lessons from LinkedIn and Mockito" talk (slide clip, video)
• 2017, December - 1.0 release! See the release notes.
• 2018, February - Shipkit 2.0, upgrade to Java8 and Gradle4. 2.0.0 is 100% compatible with 1.0.12 feature-wise, the only change is minimum Java+Gradle version requirement (#624)
• 2018, March - we started working on our Q2 milestone, a set of improvements that make Shipkit more compelling for new projects.

Want to include your event? Submit a pull request!

• 2018, Q3 - Make Shipkit the standard tool for Gradle plugin CI/CD (#255)
• 2018, Q1-Q4 - work on getting the community adopt Shipkit while adding CI/CD features
• 2019, support OSS and enterprise in transition into CI/CD model