Skip to content

Latest commit

聽

History

History
80 lines (42 loc) 路 4.37 KB

CONTRIBUTING.md

File metadata and controls

80 lines (42 loc) 路 4.37 KB
Raw

Contributing

Thanks for your interest in contributing to Ionicons! 馃帀

Contributing Etiquette

Please see our Contributor Code of Conduct for information on our rules of conduct.

Creating an Issue

  • If you have a question about using Ionicons, please ask on the Ionic Forum or in the Ionic Discord.

  • It is required that you clearly describe the steps necessary to reproduce the issue you are running into. Although we would love to help our users as much as possible, diagnosing issues without clear reproduction steps is extremely time-consuming and simply not sustainable.

  • The issue list of this repository is exclusively for bug reports and feature requests. Non-conforming issues will be closed immediately.

  • If you think you have found a bug, or have a new feature idea, please start by making sure it hasn't already been reported. You can search through existing issues to see if there is a similar one reported. Include closed issues as it may have been closed with a solution.

  • Next, create a new issue that thoroughly explains the problem.

Creating a Pull Request

  • We appreciate you taking the time to contribute! Before submitting a pull request, we ask that you please create an issue that explains the bug or feature request and let us know that you plan on creating a pull request for it. If an issue already exists, please comment on that issue letting us know you would like to submit a pull request for it. This helps us to keep track of the pull request and make sure there isn't duplicated effort.

  • Looking for an issue to fix? Make sure to look through our issues with the help wanted label!

Adding or Modifiying Icons

While we appreciate all contributions, please note that we do not accept contributions that add or modify icon SVG assets. All SVG asset modifications are done by Ionic's in-house design team to ensure design consistency across the entire icon set. If there is an icon you need added or an existing icon you need modified please create a new issue.

Contributions that fix bugs in or add features to the ion-icon component are welcome!

Setup

  1. Download the installer for the LTS version of Node.js. This is the best way to also install npm.
  2. Fork this repository.
  3. Clone your fork.
  4. Create a new branch from main for your change.
  5. Run npm install from the root directory to install dependencies for this package.
  6. Run npm run build to perform a first time build.
  7. Modify the Icon Component if desired.
  8. Or, modify and preview the site.

Modifying Components

  1. Navigate to the src/components/ directory and open the icon component to modify.
  2. Make any changes to the icon component and then preview the changes.

Preview Component Changes

  1. Run npm start from the root directory to start a local version of the icon test.
  2. Modify the icon test as needed in the index.html file.
  3. If you are modifying icons, you can run npm run build.files to re-run the SVG optimization script to verify there are no changes after optimizing the SVG.

Submit Pull Request

  1. Create a new pull request with the main branch as the base. You may need to click on compare across forks to find your changes.
  2. See the Creating a pull request from a fork GitHub help article for more information.
  3. Please fill out the Pull Request template to the best of your ability and include any issues that are related.

Updating Documentation

The documentation site for Ionicons is located in the ionicons-site repository.

License

By contributing your code to the ionic-team/ionicons GitHub Repository, you agree to license your contribution under the MIT license.