Open source

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 Conduct

Security

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 vulnerability

Contribution workflow

From idea to pull request

01

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.

02

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-change
03

Install and develop

Install dependencies and run the documentation application while implementing the smallest complete change.

npm.cmd install
npm.cmd start
04

Add evidence

Update behavior tests, documentation, accessibility guidance, API details, and visual baselines whenever the change affects them.

05

Run the release gate

Validate formatting, lint, contracts, tests, production builds, package contents, and clean consumer applications.

npm.cmd run release:check
06

Open 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