Contribute to SFRA

Fix or report a bug or contribute to the SFRA cartridges.

If you find a bug, let us know by entering the bug for the Storefront Reference Architecture repository.

Do you have some extra time and want to contribute? This section talks about the process of working on issues or adding functionality.

  1. Fork the Storefront Reference Architecture repository.
  2. Clone your fork to your local machine.
  3. Set your Git upstream to the Storefront Reference Architecture repository.
  4. Create a branch and add your code.
  1. Make sure to run eslint to lint your code before committing. If you want to contribute regularly, consider adding a Git hook to automatically lint your code before you commit.
  2. Run the automation tests locally.
  1. Push your changes.
  2. Submit the pull request to the main branch.
  3. Give read access permission for your fork to the Jenkins account and the testing team. See following section.
  4. Check whether the pull request has passed the automated testing.
  1. In GitHub, go to the page for your fork.
  2. In the left sidebar, click Settings.
  3. Click User and group access.
  4. Grant read access to the following users: sg-jenkins.

B2C Commerce Engineering reviews your pull request to determine if it's something we can pull into the code. If the change isn't accepted, the request is declined with a comment. If the change is accepted and passes all tests, the change is merged into the SFRA main branch.

If further changes are needed before the pull request to be accepted, Engineering leaves a comment on the pull request.

If you have a question about the status of a pull request, contact Engineering by adding a comment to the pull request.

If your pull request fails tests, you can troubleshoot the problem and change the pull request. You can test failures, but to be able to debug, you must request Engineering to send you the log from the test failures. When you have committed your changes, rebase and remove the extra commit message.