Contribute to NgNova UI
Help improve Angular components, accessibility, documentation, tests, and developer tooling. Contributions are reviewed against the same standards used for every NgNova UI release.
Community
Respectful collaboration
Participation is governed by the Code of Conduct. Be constructive, inclusive, and specific when opening issues or reviewing changes.
Read the Code of ConductSecurity
Report vulnerabilities privately
Do not disclose a suspected vulnerability in a public issue or pull request. Use the repository's private security-advisory channel.
Report a vulnerabilityContribution workflow
From idea to pull request
Choose a focused change
Start with an existing issue when possible. For larger ideas, open an issue before implementation so maintainers can confirm the direction.
Fork and create a branch
Fork the repository, clone your fork, and create a descriptive branch from the latest main branch.
git switch -c feat/your-changeInstall and develop
Install dependencies and run the documentation application while implementing the smallest complete change.
npm.cmd install
npm.cmd startAdd evidence
Update behavior tests, documentation, accessibility guidance, API details, and visual baselines whenever the change affects them.
Run the release gate
Validate formatting, lint, contracts, tests, production builds, package contents, and clean consumer applications.
npm.cmd run release:checkOpen a pull request
Describe the consumer impact, link the issue, include the checks you ran, and respond to review feedback.
Engineering standard
What a complete contribution includes
- Angular 22 standalone architecture with OnPush change detection.
- Typed, semver-aware public APIs and focused package entry points.
- Keyboard, ARIA, forms, disabled-state, and regression tests where relevant.
- Matching live documentation, code examples, API details, and testing guidance.
- A Changeset for user-facing package changes.
Contribution license
Contributions remain open source
By submitting a contribution, you agree that it will be licensed under the project's MIT License and confirm that you have the right to submit it. No contributor license agreement is currently required.
Read the complete repository policy