Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct.
Some thoughts to help you contribute to this project
Recommended communication style
- Always leave screenshots for visuals changes
- Always leave a detailed description in the Pull Request. Leave nothing ambiguous for the reviewer.
- Always review your code first. Do this by leaving comments in your coding noting questions, or interesting things for the reviewer.
- Always communicate. Whether it is in the issue or the pull request, keeping the lines of communication helps everyone around you.
TL;DR: forks are preferred.
git clone https://github.com/<your-name>/open-sauced
npm run build
For running the test suite, use the following command. Since the tests run in watch mode by default, some users may encounter errors about too many files being open. In this case, it may be beneficial to install watchman.
# the tests will run in watch mode by default
We actively welcome your pull requests, however linking your work to an existing issue is preferred.
- Fork the repo and create your branch from
- Name your branch something that is descriptive to the work you are doing. i.e. adds-new-thing or fixes-mobile
- If you've added code that should be tested, add tests.
- If you've changed APIs, update the documentation.
- If you make visual changes, screenshots are required.
- Ensure the test suite passes.
- Make sure you address any lint warnings.
- If you make the existing code better, please let us know in your PR description.
- A PR description and title are required. The title is required to begin with: "feat:" or "fix:"
- Link to an issue in the project. Unsolicited code is welcomed, but an issue is required for announce your intentions. PR's without a linked issue will be marked invalid and closed.
note for maintainers: All pull requests need a label to assist automation. See the template to guide which labels to use.
Examples for valid PR titles:
- fix: Correct typo.
- feat: Add support for Node 12.
- refactor!: Drop support for Node 6.
Note that since PR titles only have a single line, you have to use the ! syntax for breaking changes.
See Conventional Commits for more examples.
You can also experiment with conventional commits by doing:
npm run push
Work in progress
GitHub has support for draft pull requests, which will disable the merge button until the PR is marked as ready for merge.
If you plan to contribute a change based on an open issue, please assign yourself by commenting on the following word
.take. Issues that are not assigned are assumed open, and to avoid conflicts, please assign yourself before beginning work on any issues.
Also, all questions are welcomed.
The Triage team is inspired by expressjs/express. This team exists to create a path for making contributions to this project and open source. All Triage Team members are expected to follow this guide: TRIAGE_GUIDE.md
There are no minimum requirements to become a member of the Triage Team.
For those interested in getting involved in the project or just open source in general, please request an invite to the Triage Team in this discussion.
Open Sauced is a part of GitHub Sponsors. If you would like to contribute, please note the sponsor page for details on how funds are distributed. If you have made any contributions to the projectd directly or indirectly, please consider adding your profile to the funding.yml.
Do you have questions? Join the conversation in our Discord.
- Ask questions if you are stuck.
- Use CSS variables
- Always use rel="noreferrer" on all target="_blank" links.
By contributing to the Open Sauced project, you agree that your contributions will be licensed under its MIT license.