Haxor is a community effort to help devtools maintainers remove friction from their developer experience (DX). Haxor is like a bug bounty but differs in a couple of ways:
- Participants submit feedback in addition to bugs. Feedback can be anything that causes you friction when completing the goal, like confusing documentation or time-wasting errors.
- Participants attach screen recording clips to issues.
Hello and welcome to the Haxor DX Bounty! Here you get to try new dev tools, help make them better, and earn prizes! Every bug we find helps the next developer save time! The feedback you provide helps maintainers improve their DX.
Try to complete the challenges below. As you complete a challenge, you can file any feedback or bugs you find as issues in the challenge repo. Once you complete the challenge, you can make a pull request adding yourself to the leaderboard! Check out this example of quality feedback.
In order to earn points for an issue or pull, you'll need to attach a desktop replay clip using Replayable. Replays help maintainers understand the context of your feedback and they help our moderators validate you submissions.
This guide will use the example challenge, but you should choose one from the list of challenges below..
Fork the repository and clone it.
git clone https://github.com/your-name/haxor-challenge-example
cd haxor-challenge-example
mkdir solutions/your-name
cd solutions/your-name
Follow the challenge instructions. Every challenge will be unique. See some example instructions here.
This is the whole point of Haxor! When you encounter friction, confusion, or bugs, open GitHub issues on the base repository. Every issue is worth 10 points and you can get rewarded up to 3x per challenge!
gh issue create -l "feedback" -w -b "`replayable --md`"
When you've completed the challenge, make a pull request to add your solution to the base repository. Successful solutions are worth 5 points.
gh pr create -w -t "I Completed the Haxor Challenge" -b "`replayable --md`"
Join our Discord community to meet other Haxors and get help solving challenges!
Type !signup [your github username]
in the #bot
channel to get the Haxor
role and personalized notificiations in our Discord.
You can earn up to 35 points per challenge. You'll get 10 points for submitting feedback and 5 bonus points for completing the challenge. Redeem points for items the Haxor shop and other special prizes!
Represent your 1337 skills with Haxor branded merch.
Hundreds of shirts that were programatically generated! Every design has multiple varients. Each shirt features the Haxor logo on the sleeve.
There aren't enough challenges to earn this many points yet, but these are the kinds of prizes we dream of offering! Help us grow! Add your own challenge.
Our feedback sessions are called challenges. Every challenge asks you to build a small app or add a single feature using a developer tool. Each challenge takes between 15 minutes to 2 hours and you complete them on your own machine.
Mostly everything happens on GitHub (but you should also join our Discord!). You can see a list of challenges below. Each challenge will include it's own time estimate and goal.
Replayable makes it simple to add context to bugs and pull requests without ruining your flow. Instead of spending time trying to reproduce a bug in a new screencast, Replayable lets you add footage from when you encountered it the first time. It works full pull requests and demos too! Check out our CLI and Chrome Extension for GitHub and Jira.
In order to earn points for your submission, it must contain a 30-second or longer screencast demoing the bug, feedback, or feature.
10 points per GitHub Issue, 30 points max per challenge
Giving feedback to maintainers is the whole point of Haxor. It's as easy as opening a GitHub issue against the Haxor challenge repo. You can file feedback for anything that you feel is "friction" to completing your task
- Things you expected to work that didn't
- Confusing or outdated instructions
- Spelling and syntax errors in documentation and code samples
- Website UI that doesn't work
Your experience will help maintainers improve their tools and remove friction for the next developer. And remember, developer experience uses many tools and is different for everyone.
Check out this example of quality feedback.
The following shell script will open a GitHub issue with a clip of the last 30 seconds of your screen.
gh issue create -w -t "My Feedback" -b "`replayable --md`"
5 Points and Hall of Fame!
While Haxor is all about giving feedback, we still want to award those to complete the challenge successfully!
Every challenge will include some exit criteria that marks it as "complete." Once you successfully complete the challenge, you'll get added to the "Hall of Fame" via https://contrib.rocks/.
In order to get your github profile on the scoreboard and earn points for completing the challenge, you must:
- Open a pull request that adds your name to the leaderboard
- Attach a replay of you demonstrating the exit criteria to the PR
gh pr create -w -t "I Completed the Haxor Challenge" -b "`replayable --md`"
Haxor moderators get pinged on new submissions to the repositories and will comment on the issue or pull request to confirm your points.
Once you've earned enough points for a prize, you can cash out by simply emailing the Haxor staff with the prize you want, size (if appropriate), and your address.
Points will be deducted from your total (you can see this on in our leaderboard) and you'll get shipping notifications in your inbox.
Note that all feedback should include a Replayable replay as well as a short description of your problem and experience.
- Identify specific areas where you struggled, such as with understanding documentation or debugging an error
- Provide concrete suggestions for improving the developer experience, such as adding more examples to the documentation or clarifying ambiguous language
- Offer suggestions for alternative approaches or tools that may be more effective
- Be respectful and constructive, rather than critical or dismissive
Check out this example of quality feedback. You can find some more examples below, but remember your bugs, issues, and feedback need to include Replayable replays!
At first, I tried installing through the gradle plugin, but it kept throwing errors, despite installing it how the documentation said to. Then I switched to a maven project which, admittedly, I am not familiar with. Even then following documentation and examples online, it was not allowing me to download and execute the example getting started code.
Using my existing account/number/service plan didn't work through Java SDK, but does work through the button click online interface. When I released that account/number/service plan and created a fresh one, sending an SMS through the Java SDK worked.
Setting up the virtual number is confusing. Not sure if my phone number will suffix or do I really need a virtual number. Also, its not exactly clear how to create the virtual number on the site.
Message is always "This is a test message from your account", regardless of what message I put in when using the Java SDK. Is this a limitation of the trial account/free account? Or is it a bug? If the former, I didn't see it documented clearly anywhere.
Haxor isn't really about completing challenges, it's about the feedback we give maintainers. Sure, you could copy feedback and solutions, but that's why we use Replayable to validate submissions.
At the end of the day this is a community effort. Points and prizes are a cool thing we can do to reward community members. We reserve the right to refuse submissions, ban participants, revoke your points, etc.
See our code of conduct here.
Currently the only languages we support are Javascript and Java.
Haxor started when I wondered "how can we reward developers for participating in open source?" Then I realized that developer experience in itself was valuable to the maintainers of dev tools, but there wasn't a great way for developers to share their experience. So I started Haxor, an developer experience agency while building Replayable, a tool that makes sharing context instant.
For 3 years Haxors has privately been helping open-source projects and companies like AWS, Snap, and Mailchimp get feedback from developers who try their tools. Now we're excited to bring Haxor to the larger open-source community with the help of our scren recording tool, Replayable.
Looking for feedback on yoru own API, SDK, or developer tool?
- Fork the haxor-challenge-example repo.
- Make a new repo called
haxor-challenge-${your-tool}
- Replace the readme in your template with your own challenge details.
- Make a pull request to the list above linking to your tool
- We will approve or request changes to your challenge
- We will supply you with a webhook to add to your repo. This tells Haxor moderators to review submissions and award points.
- Developers will be notified of your new challenge!
- You'll get GitHub notifications of new issues!
You will be responsible for maintaining your challenge.
Your challenge:
- Must be entirely self-service and publicly available
- Must not require payment details to complete
- Must target Javascript or Java developers (for now)