{"id":20852821,"url":"https://github.com/wp-pwa/contribute","last_synced_at":"2026-04-12T19:50:06.605Z","repository":{"id":81806908,"uuid":"137904227","full_name":"wp-pwa/contribute","owner":"wp-pwa","description":"Style, test, commit and CI tools for the rest of » Frontity's repositories","archived":false,"fork":false,"pushed_at":"2018-09-26T08:40:27.000Z","size":994,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-19T06:27:10.573Z","etag":null,"topics":["commitizen","eslint","husky","jest","prettier","semantic-release","travis"],"latest_commit_sha":null,"homepage":"https://frontity.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wp-pwa.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-19T14:38:36.000Z","updated_at":"2019-02-26T11:18:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"786d94fb-9e7a-4e47-9788-ff867da3248e","html_url":"https://github.com/wp-pwa/contribute","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wp-pwa%2Fcontribute","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wp-pwa%2Fcontribute/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wp-pwa%2Fcontribute/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wp-pwa%2Fcontribute/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wp-pwa","download_url":"https://codeload.github.com/wp-pwa/contribute/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243222186,"owners_count":20256229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["commitizen","eslint","husky","jest","prettier","semantic-release","travis"],"created_at":"2024-11-18T03:19:00.242Z","updated_at":"2025-12-11T19:17:51.024Z","avatar_url":"https://github.com/wp-pwa.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Frontity - Contribution Guidelines\n\nThank you for thinking about contributing to a Frontity project!\n\nThese are the different steps needed to contribute to a Frontity project.\n\n[![Build Status](https://travis-ci.org/frontity/contribute.svg?branch=master)](https://travis-ci.org/frontity/contribute)\n\n## Contribution worflow\n\n#### 1. Open an issue\n\nFirst, open an issue in the relevant repository. Use the issue template to fill the required fields.\n\nWhile posting the issue, keep these notes in mind:\n- Try to add as much detail as possible. Be specific!\n- If you're requesting a new feature, explain why you'd like it to be added.\n- Search this repository for issues and pull requests and whether it has been fixed or reported already.\n- Ensure you are using the latest code before logging bugs.\n- Disable all WordPress plugins and/or Frontity extensions to ensure it's not a conflict issue.\n\n#### 2. Fork the repository and create a branch\n\nUse GitHub to fork the repository (or repositories). Create a branch for your pull request. The name should start with the issue number. For example, if the issue is `#17`, the branch should be something like `17-add-this-new-cool-feature` or `17-fix-this-ugly-bug`.\n\n#### 3. Clone the repo and setup the local environment\n\nClone your fork and follow the **Local Environment** instructions of that repository. It's possible that you need to clone other repositories in order to make it work. For example, if you want to contribute to a specific package, you'll need to clone `core` first, then clone your fork into the `packages` folder.\n\n#### 4. Make code changes and commit! :tada:\n\nThe fun part. Make some code changes and commit them to your newly created branch.\n\n##### Testing\n\nRemember to add tests for all the files you create/modify. We use the [jest](https://facebook.github.io/jest/) framework.\n\n##### Commit convention\n\nWe follow the [Angular Conventional Changelog](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#-git-commit-guidelines) for commits. Please, review it before commiting.\n\nTo make your life easier, you can use `npm run cz` instead of `git commit`. That will launch [commitizen](http://commitizen.github.io/cz-cli/) with the configuration we use, so you just have to answer to its questions.\n\n##### Commit hooks\n\nBe aware that we also use [husky](https://github.com/typicode/husky) to run tests and linting before validating a commit. If tests don't pass, or the commit message doesn't follow the *Angular Convential Changelog* the commit will fail.\n\n#### 5. Push the branch to your forked repository\n\nOnce you're done coding (or think you're done) push the branch to your forked repository. Don't worry if it's not finished yet. You can add more commits latter.\n\n#### 6. Submit a pull request to the original repository\n\nIn the PR description, mention the original issue. For example: `Fixes #17` or `Close #17`. Any [Github closing keyword](https://help.github.com/articles/closing-issues-using-keywords/) is valid.\n\n#### 7. Wait for the review and the merge\n\nThat's it! Now you just need to wait for a Frontity member to review your PR. She may comment on additional changes needed, or approve and merge the PR right away.\n\n## Starting a new Frontity project\n\nIf you are starting a new project for the Frontity org, please use this repository as reference for all the configuration files.\n\nYou should also include a `CONTRIBUTING.md` file pointing to this `README.md`.\n\n## License\n\nAll Node/JS Frontity projects are licensed under the Apache 2.0 license, and all contributions will be released under the Apache 2.0 license. You maintain copyright over any contribution you make, and by submitting a pull request, you are agreeing to release that contribution under the Apache 2.0 license.\n\nAll Wordpress/PHP Frontity projects are licensed under the GPLv3 license, and all contributions will be released under the GPLv3 license. You maintain copyright over any contribution you make, and by submitting a pull request, you are agreeing to release that contribution under the GPLv3 license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwp-pwa%2Fcontribute","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwp-pwa%2Fcontribute","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwp-pwa%2Fcontribute/lists"}