We welcome all input and contributions to BundleWrap. If you’ve never done this sort of thing before, maybe check out But don’t be afraid to make mistakes, nobody expects your first contribution to be perfect. We’ll gladly help you out.

Submitting bug reports

Please use the GitHub issue tracker and take a few minutes to look for existing reports of the same problem (open or closed!).


If you’ve found a security issue or are not at all sure, just contact

Contributing code


Before working on new features, try reaching out to one of the core authors first. We are very concerned with keeping BundleWrap lean and not introducing bloat. If your idea is not a good fit for all or most BundleWrap users, it can still be included as a plugin.

Here are the steps:

  1. Write your code. Awesome!
  2. If you haven’t already done so, please consider writing tests. Otherwise, someone else will have to do it for you.
  3. Same goes for documentation.
  4. Set up a virtualenv and run pip install -r requirements-tests.txt.
  5. Make sure you can connect to your localhost via ssh without using a password and that you are able to run sudo.
  6. Run fab run_tests
  7. Review and sign the CAA by adding your name and email to the AUTHORS file. (This step can be skipped if your contribution is too small to be considered intellectual property, e.g. spelling fixes)
  8. Open a pull request on GitHub.
  9. Feel great. Thank you.


If at any point you need help or are not sure what to do, just drop by in #bundlewrap on Freenode or poke @bundlewrap on Twitter.