WireMock in Hacktoberfest

Hacktoberfest is a month-long celebration of open source software which happens as a global online hackathon. As the official website states, “Hacktoberfest has grown from 676 participants in 2014 to nearly 147,000 participants last year”, and it is surely the most massive open source hackathon. The 2023 edition is presented by DigitalOcean, ILLA Cloud, and AppWrite.

This October the WireMock project will join the 10th edition of this worldwide event! Regardless of their experience and background, everyone can support open source by contributing changes. All contributors will receive special digital awards. In WireMock, we are also happy to offer special swag to the most active contributors to the WireMock open source ecosystem!

Get Started

  1. Sign-up to Hacktoberfest on the event website
  2. Join the WireMock Community Slack and the #help-contributing channel there. We will be using it for coordination and announcements
  3. IMPORTANT: Fill in the WireMock registration form to participate in the swag raffle or if you contribute to the repositories outside the official GitHub org
  4. Check out the WireMock contributing guidelines and look for the linked issues
  5. Join us for the grand opening event on October 2nd, or watch the recording!

Quick Issues

Here are quick issue search queries that help to find issues open for grabs:

We will do our best to replenish the issues as they get closed.

During Hacktoberfest 2023, we would like to focus on the following projects:

  • WireMock developer and operations experience - improving support for core use-cases including support for more configuration formats, observability, additional matchers, State Extension enhancements, etc., etc. Open Issues
  • WireMock 3 adoption and compatibility in downstream libraries and adapters
  • WireMock for Python projects - deeper Python ecosystem integrations in Python WireMock and other projects
  • WireMock and Testcontainers - Let’s make the existing Testcontainers modules better and create new ones for different technology stacks! (Open Issues)
  • API Mock Templates - Create new templates and improve the existing ones, enhance the Mock API Templates Library (HOWTO)
  • Documentation clean-up and improvements - We want to make user and developer documentation better, including new pages, styling and even new services for extension documentation. ( Good First Issues, All Open Issues, Contributing to Documentation)

Full Scope

Regardless of your expertise and time you could dedicate, there’re opportunities to participate and help the project! You can help make WireMock a better tool and community in a number of ways, Basically, anything -as-code counts if submitted via a pull request:

  • Contribute new features, bug fixes or enhancements
  • Adopt WireMock in your projects
  • Improve WireMock documentation; create new demos and guides
  • Publish new mock API templates (HOWTO)
  • Improve WireMock user and developer experience
  • Create cool artwork
  • … and anything else!

Here is a brief list of languages and technologies we have: Java, Kotlin, Python, Golang, Rust, Docker, Kubernetes, REST API, GraphQL, gRPC, Markdown, JUnit, Gradle, Maven, GitHub Actions, JSON, YAML. In fact, there are a lot more technologies within the WireMock Ecosystem.

We will also consider non-code contributions like helping users and contributors, doing code reviews, creating blog posts, etc. created during the event. Make sure to share these contributions on social media or the #help-contributing channel so that we do not miss them.

Where to contribute?

As a part of this event, the following components are in our scope:

  • All projects in the official WireMock organization on GitHub
  • WireMock Ecosystem projects marked with a “hacktoberfest” topic by their maintainers
  • Personal projects related to WireMock: usage in open source projects, demos, tutorials, etc.

For projects outside the official GitHub organization, our team cannot manage pull request labels or discover the contributors easily. Make sure to report those contributions in the #help-contributing channel or in the GitHub form.

Get WireMock Swag

The WireMock Inc, a key contributor to WireMock and a vendor of WireMock Cloud, will be sponsoring stickers, T-Shirts and other swag to a few dozens of the most active contributors. The team will judge contributions not only by the number, but also by the quality and value for the WireMock ecosystem and its end users. Make sure to sign-up using this form!

Examples of the swag we plan to distribute, worn by the proud WireMock engineering team!

Hacktoberfest Header

Code of Conduct

Hacktoberfest in WireMock is a community event. All participants and organizers are expected to follow our Code of Conduct, based on Contributor Covenant v.2.1. Please be kind!


Join us this October!