Skip to content

Documentation

Contribute

Learn how to support us and how to make Bonjourr better.

Bonjourr is built and maintained by just the two of us in our spare time. We love working on it, and our goal is to spend even more time improving the project in the future.

Donations help cover project costs, support ongoing development, and bring us a little closer to making open source work a larger part of our lives. Every contribution, no matter the amount, makes a difference (and will get your name in Bonjourr next month!).

Leaving a review is one of the easiest ways to support Bonjourr. Positive reviews help more people discover the project and encourage browser stores to recommend it to new users.

You can also tell your friends and family about Bonjourr, because if you love it, they probably will too!

Thanks to our contributors, Bonjourr is currently available in 43 languages!

You might find that these translations aren’t always perfect, especially when we update Bonjourr. Good news though: you can probably help!

Translations are located in the /_locales/ folder on Github. Each language folder contains these three files:

  • translations.json for the main translation.
  • messages.json for the extension’s title and subtitle.
  • overview.md for the full description on store pages.

To add a new language, copy the en folder to your desired language. You also need to add the country code and name to the list in /src/scripts/langs.ts. If you are familiar with GitHub, you can create a pull request. If not, you can directly send us the modified files via email or to our Discord server.

This is an optional part, but if you want to see what your translation looks like in Bonjourr, you can follow these steps.

  1. Go to online.bonjourr.fr and select your language.

  2. Using one of the following keybinds: F12, Ctrl + Shift + J, or Ctrl + Shift + I.

  3. Add your translation to this command and paste it into the console:

    const myTranslationFile = "/* copy and paste translations.json here */";
    localStorage.translations = JSON.stringify(myTranslationFile)
  4. You should see your new strings!

You have some coding skills and and would like to contribute to Bonjourr’s codebase? Check out the issues on GitHub to see if something inspires you, or create a new one so we can discuss of your new feature’s implementation.

If you’re feeling creative, you can also suggest or create CSS snippets & custom profiles.