Skip to main content

Pivotal UI

About / Contributing


We encourage and appreciate all contributions, large and small, from the Pivotal community. Our code and documentation is open-source and located in the Pivotal UI GitHub repo. If you're interested in getting involved, here are some ways you can help.

Filing an issue

Found a typo in our documentation? Encountered a bug in one of our components? Have a feature request? Please file an issue to let us know about it! This is the quickest and easiest way to help out.

If you're comfortable making the change yourself, please read on for guidelines.

Submitting a pull request

To submit a pull request, we recommend forking the Pivotal UI repo. Make your changes to your fork and then submit a PR to bring the changes back to the main repo.

If you already have push access to the main repo, you can also create a branch and submit a PR from there.

For large pull requests, especially those that involve breaking changes, it's a good idea to reach out to the maintainers as early as possible to help us understand the change you'd like to make. This will make the process much easier for all involved.

Improving documentation

Text content & code examples are written in Markdown files located in the docs directory. Smaller changes to these files can be made directly on GitHub. Each page on this site also has a link to edit it on GitHub.

The style guide itself is a React app built using Gatsby. Source files live in the styleguide directory.

Improving components and styles

Pivotal UI components and styles live in the src directory.

If your team has built a component that you feel would be a good fit for Pivotal UI (i.e. it could be useful to several Pivotal teams), let the maintainers know via an issue or on Slack so we can figure out the best way to help.

Getting in touch

If you have questions or suggestions, or if you just want to chat about Pivotal UI, either file an issue or reach out to the maintainers on our Slack channel (#pivotal-ui).