Whether you want to send us feedback, fix a problem, create a new addon, or something else, you are welcome to contribute! Our code is open source.
You can learn more about the types of contributions you can make here.
Be sure to follow our code of conduct.
Found a bug? Have an idea? You can open an issue to report bugs and send feedback! But first, be sure to search for existing issues. If there are no similar issues, you can create a new one. You can also open a discussion to suggest ideas or ask questions. We will take a look at it.
We also have a feedback form on our website, which you can access by clicking "Send Feedback" in Scratch Addons' settings page.
If you are familiar with JavaScript, HTML, and CSS, you can contribute by fixing bugs or adding features. Just follow the steps below to propose your changes which we can then add to Scratch Addons.
If you're making your first new addon, follow our "Creating an Addon" guide.
Check our reference for details about our APIs and addon manifest structure.
We recommend using Git to commit changes. If you prefer GUIs, you can also set up GitHub Desktop. If you don't want to install anything, you can use the GitHub website, but we strongly recommend one of the other options to speed up the process.
In order to fork the repository and open a pull request, you'll need a GitHub account.
New to contributing? octocat/Spoon-Knife and this guide are good resources to learn the process.
Looking for a code editor? We recommend Visual Studio Code.
Testing changes once you have downloaded the source code is very easy and you don't need any additional software to do so. See how to run the source code for Scratch Addons in our documentation.
We format our code with Prettier to make sure all of it follows the same style and looks nice and neat. To have your code automatically formatted, enable Actions on your fork of the repository (in the Actions tab). If your pull request has formatting issues, don't worry, we can also fix it for you.
It's a good idea to check "allow edits from maintainers" so that we can make adjustments and help fix things (like formatting) for you.
If you're working on changes and something looks outdated, sync your branch with the upstream repository to make sure you're all caught up.
Make sure you have thoroughly tested any changes you want to contribute.
- If you have something in mind, it's best if you create or find an issue first (see above). That way, we can discuss it before you start a pull request.
- Fork this repository if you haven't already.
- Clone your fork and load it into your browser so you can make and test your changes.
- Create a new branch, specifying
upstream/masteras the source branch:Branching makes things easier later on if you have multiple pull requests open at once or ever want to contribute again. You can always delete a branch.git checkout -b BRANCH-NAME upstream/master
- Make and test your changes.
- Commit and push your changes to the branch.
- Go to the website to create a pull request in the source repository (ScratchAddons/ScratchAddons). There should be a banner with a button to open a pull request.
(If you don't see it, you can manually open a pull request by navigating to the "Pull requests" tab, clicking "New pull request", then clicking "Compare across forks" and selecting your fork and branch next to "head repository". Then click "Create pull request" to go to the next step.) - Finally, fill out the form. Remember to check "allow edits from maintainers" in case we need to make adjustments. Once you're done, click "Create pull request"!
Once your pull request is open, we will review and discuss the changes and any necessary adjustments.