Hi everyone,
I’m Keith Grant on the Ansible UI team at Red Hat. I’m pleased to share that the Ansible UI source code has been synchronized to the ansible/ansible-ui repository and all development work is now happening upstream.
What is Ansible UI?
The Ansible UI provides a graphical interface for Ansible projects such as AWX, Event Driven Ansible (EDA), and Galaxy.
What’s changed
The ansible/ansible-ui repository has a new devel branch that reflects the current state of the codebase. From now on all active development on the Ansible UI takes place on the devel branch. With this in mind, there are a few things to be aware of:
- The devel branch is a development branch. You should expect to find rough edges, incomplete features, and things that simply do not work. This is normal for active upstream development.
- The previous main branch no longer reflects the current state of the project. If you had clones or forks, you should rebase your work on devel.
- The codebase has changed significantly since the repository was last active. Take some time to familiarize yourself with the current structure before you dive in.
- Testing is now done with Vitest (for unit/component testing) and Playwright (for integration testing).
Getting started
Set up a development environment by following the getting started guide in the project README at: GitHub - ansible/ansible-ui: The UIs for Ansible Projects such as AWX, EDA, and HUB. · GitHub
Contributions we’d like to see
We welcome contributions of all kinds! Some areas we’re especially interested in:
- Bug reports! Try setting up the Ansible UI, try the workflows, and let us know what’s broken. Issues filed now are especially valuable while we stabilize the upstream codebase.
- Documentation improvements. Help us improve the developer setup guides, contributor documentation, and inline code comments.
- Test coverage. Additional tests help us move faster and catch regressions.
- Accessibility. We’d love to see improvements to keyboard navigation, screen reader support, and ARIA attributes.
How to contribute
- Open issues in the repository if you find bugs or have ideas for improvements.
- Open pull requests against the devel branch.
- Join the discussion on the Ansible forum with the ansible-ui tag.
Updating your PRs
If you have a pull request against the old main branch, you’ll need to rebase it against devel (this will likely involve manually cherry-picking changes into a new branch, as devel has significantly diverged from main). The codebase has changed substantially, so some PRs might need to be reworked quite a bit. If you have trouble, open an issue or ask on the forum. We’ll help you get sorted.
We’re looking forward to collaborating with you!