Contributing

Component Contribution #

Design #

TBD

Code #

To make code changes in our Design System please first read the CONTRIBUTING.md in our Dialtone repository.

Adding Icons and Illustrations #

If you need to add an icon into Dialtone, here’s how you would go about doing that.

For System Icons #

1. Create a new branch starting with "feat/" in the name.

2. Place the exported SVG file(s) in the appropriate folder category inside packages/dialtone-icons/src/svg/icons/

3. If you need to add keywords related to the icon.

   • Add the icon name to packages/dialtone-icons/src/keywords-icons.json into the correct category.
   • Add the keywords array as the value. e.g.

   {
      "arrows": {
        "arrow-left": ["arrow", "left", "direction"],
        ...
      }
   }
   

4. Commit and push your branch.

5. Open a pull request.

6. Once approved it can be merged into staging and will go out in the next release.

For System Illustrations #

1. Create a new branch starting with "feat/" in the name.

2. Place the exported SVG file(s) in the appropriate folder category inside packages/dialtone-icons/src/svg/illustrations/

3. If you need to add keywords related to the illustration.

   • Add the illustration name to packages/dialtone-icons/src/keywords-illustrations.json into the correct category.
   • Add the keywords array as the value. e.g.

   {
      "spot-illustrations": {
        "blank-space": ["blank", "space"],
        ...
      }
   }
   

4. Commit and push your branch.

5. Open a pull request.

6. Once approved it can be merged into staging and will go out in the next release.