ng-primitives

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 589 Open GitHub ↗

Headless, composable primitives for building accessible UI components in Angular.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Angular Primitives

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/ng-primitives/ng-primitives/.github%2Fworkflows%2Fci.yml)
![NPM Downloads](https://img.shields.io/npm/dt/ng-primitives)
![NPM Version](https://img.shields.io/npm/v/ng-primitives)
![GitHub Sponsors](https://img.shields.io/github/sponsors/ashley-hunter)
![GitHub contributors from allcontributors.org](https://img.shields.io/github/all-contributors/ng-primitives/ng-primitives)
[![Discord server](https://dcbadge.limes.pink/api/server/NTdjc5r3gC?style=flat)](https://discord.gg/NTdjc5r3gC)

Angular Primitives is a Headless UI library with a focus on accessibility, customization, and developer experience. Whether you're building a design system from scratch or looking to enhance your existing one, our primitives are here to support you every step of the way.

You can find our [documentation site here](https://angularprimitives.com).

If you would like to join our community, please join our [Discord server](https://discord.gg/NTdjc5r3gC).

This library is in active development, and we're working hard towards our 1.0 release. We'd love your help in testing, providing feedback, and contributing to the project in any way, no matter how small.

Until we reach 1.0 some APIs may change, and we may introduce breaking changes in minor versions, however, we'll do our best to keep these to a minimum.

## Installation

```bash
npm install ng-primitives
```

## Compatibility

The following table shows the compatibility between Angular Primitives and Angular versions:

| Angular Primitives | Angular        |
| ------------------ | -------------- |
| 0.1.0 - 0.18.0     | 18.x.x         |
| 0.19.0 - 0.89.x    | 19.x.x, 20.x.x |
| 0.90.0 - 0.120.x   | 20.x.x, 21.x.x |
| 0.121.0+           | 21.x.x, 22.x.x |

## Contributing

We welcome contributions from the community. Please refer to our [contributing guidelines](CONTRIBUTING.md) for more information.

## Contributors

<table>
 <tbody>
 <tr>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/ashley-hunter"><img src="https://avatars.githubusercontent.com/u/20795331?v=4?s=100" width="100px;" alt="Ashley Hunter"/> Ashley Hunter</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=ashley-hunter" title="Code">💻</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=ashley-hunter" title="Documentation">📖</a> <a href="#ideas-ashley-hunter" title="Ideas, Planning, & Feedback">🤔</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/matteo-nista/"><img src="https://avatars.githubusercontent.com/u/41578120?v=4?s=100" width="100px;" alt="Matteo Nista"/> Matteo Nista</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=Mattewn99" title="Code">💻</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=Mattewn99" title="Documentation">📖</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://paypal.me/tryharddood"><img src="https://avatars.githubusercontent.com/u/10364896?v=4?s=100" width="100px;" alt="Benjamin Forrás"/> Benjamin Forrás</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=benjaminforras" title="Code">💻</a> <a href="#ideas-benjaminforras" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=benjaminforras" title="Documentation">📖</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/Abodawoud"><img src="https://avatars.githubusercontent.com/u/109487123?v=4?s=100" width="100px;" alt="Yousef Farouk Abodawoud"/> Yousef Farouk Abodawoud</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=Abodawoud" title="Code">💻</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=Abodawoud" title="Documentation">📖</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://twitter.com/otodockal"><img src="https://avatars.githubusercontent.com/u/2613273?v=4?s=100" width="100px;" alt="Oto Dočkal"/> Oto Dočkal</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=otodockal" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://fr.linkedin.com/in/edoh-kodjo/en"><img src="https://avatars.githubusercontent.com/u/22994414?v=4?s=100" width="100px;" alt="kedevked"/> kedevked</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=kedevked" title="Code">💻</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=kedevked" title="Documentation">📖</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/IceDevelop74"><img src="https://avatars.githubusercontent.com/u/114682402?v=4?s=100" width="100px;" alt="Guillaume G."/> Guillaume G.</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=IceDevelop74" title="Code">💻</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/ayush-seth"><img src="https://avatars.githubusercontent.com/u/24858182?v=4?s=100" width="100px;" alt="Ayush Seth"/> Ayush Seth</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=ayush-seth" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/dennis-ackolad"><img src="https://avatars.githubusercontent.com/u/55143772?v=4?s=100" width="100px;" alt="dennis-ackolad"/> dennis-ackolad</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=dennis-ackolad" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/adriankopytko"><img src="https://avatars.githubusercontent.com/u/15912513?v=4?s=100" width="100px;" alt="Adrian Kopytko"/> Adrian Kopytko</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=adriankopytko" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/MGREMY"><img src="https://avatars.githubusercontent.com/u/126514209?v=4?s=100" width="100px;" alt="GREMY Miguel"/> GREMY Miguel</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=MGREMY" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/Ruudt"><img src="https://avatars.githubusercontent.com/u/1218555?v=4?s=100" width="100px;" alt="Ruud Walraven"/> Ruud Walraven</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=Ruudt" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://paddlingspots.com/"><img src="https://avatars.githubusercontent.com/u/8985933?v=4?s=100" width="100px;" alt="Marc Stammerjohann"/> Marc Stammerjohann</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=marcjulian" title="Code">💻</a> <a href="#ideas-marcjulian" title="Ideas, Planning, & Feedback">🤔</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/Harshit-Prasad"><img src="https://avatars.githubusercontent.com/u/130169629?v=4?s=100" width="100px;" alt="Harshit-Prasad"/> Harshit-Prasad</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=Harshit-Prasad" title="Code">💻</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.28%"><a href="https://eurusik.medium.com"><img src="https://avatars.githubusercontent.com/u/789033?v=4?s=100" width="100px;" alt="Eugene Rusakov"/> Eugene Rusakov</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=eurusik" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/ido-g-coralogix"><img src="https://avatars.githubusercontent.com/u/122212383?v=4?s=100" width="100px;" alt="Ido Golan"/> Ido Golan</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=ido-g-coralogix" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/kostetskyroma"><img src="https://avatars.githubusercontent.com/u/12156197?v=4?s=100" width="100px;" alt="Roman Kostetskyi"/> Roman Kostetskyi</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=kostetskyroma" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/TrieBr"><img src="https://avatars.githubusercontent.com/u/348719?v=4?s=100" width="100px;" alt="Brad Triebwasser"/> Brad Triebwasser</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=TrieBr" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/JoshuaNitschke"><img src="https://avatars.githubusercontent.com/u/33307206?v=4?s=100" width="100px;" alt="Joshua Nitschke"/> Joshua Nitschke</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=JoshuaNitschke" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://ramonmartinez.dev"><img src="https://avatars.githubusercontent.com/u/39868803?v=4?s=100" width="100px;" alt="Ramon Martinez"/> Ramon Martinez</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=RaimonxDev" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/shaharkazaz"><img src="https://avatars.githubusercontent.com/u/17194830?v=4?s=100" width="100px;" alt="Shahar Kazaz"/> Shahar Kazaz</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=shaharkazaz" title="Code">💻</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/bboehm86"><img src="https://avatars.githubusercontent.com/u/1027091?v=4?s=100" width="100px;" alt="Benny Böhm"/> Benny Böhm</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=bboehm86" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="http://alazizsoftwares.com"><img src="https://avatars.githubusercontent.com/u/104660890?v=4?s=100" width="100px;" alt="Zagham Nadeem"/> Zagham Nadeem</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=zagham-nadeem" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/immohammadjaved"><img src="https://avatars.githubusercontent.com/u/31125009?v=4?s=100" width="100px;" alt="Mohammad Javed"/> Mohammad Javed</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=immohammadjaved" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/liranmizrahi1"><img src="https://avatars.githubusercontent.com/u/212209501?v=4?s=100" width="100px;" alt="liranmizrahi1"/> liranmizrahi1</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=liranmizrahi1" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/BennyPLS"><img src="https://avatars.githubusercontent.com/u/77506823?v=4?s=100" width="100px;" alt="BennyPLS"/> BennyPLS</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=BennyPLS" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/arastorhuiev"><img src="https://avatars.githubusercontent.com/u/114357806?v=4?s=100" width="100px;" alt="Andrii Rastorhuiev"/> Andrii Rastorhuiev</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=arastorhuiev" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/heddendorp"><img src="https://avatars.githubusercontent.com/u/3612748?v=4?s=100" width="100px;" alt="Lukas Heddendorp"/> Lukas Heddendorp</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=heddendorp" title="Code">💻</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/ainsly"><img src="https://avatars.githubusercontent.com/u/1775015?v=4?s=100" width="100px;" alt="ainsly"/> ainsly</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=ainsly" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/abiramcodes"><img src="https://avatars.githubusercontent.com/u/131433061?v=4?s=100" width="100px;" alt="Abiram"/> Abiram</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=abiramcodes" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://alexknipfer.com"><img src="https://avatars.githubusercontent.com/u/1299646?v=4?s=100" width="100px;" alt="Alex"/> Alex</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=alexknipfer" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/zecka"><img src="https://avatars.githubusercontent.com/u/18116930?v=4?s=100" width="100px;" alt="zecka"/> zecka</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=zecka" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/janek64"><img src="https://avatars.githubusercontent.com/u/56741217?v=4?s=100" width="100px;" alt="Janek Berg"/> Janek Berg</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=janek64" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="http://ciesielski.co"><img src="https://avatars.githubusercontent.com/u/17651898?v=4?s=100" width="100px;" alt="Alexander Ciesielski"/> Alexander Ciesielski</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=alexciesielski" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="http://jeremyzacharia.com/"><img src="https://avatars.githubusercontent.com/u/30392170?v=4?s=100" width="100px;" alt="Jeremy Zacharia"/> Jeremy Zacharia</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=jczacharia" title="Code">💻</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/undsoft"><img src="https://avatars.githubusercontent.com/u/1481270?v=4?s=100" width="100px;" alt="Evgeny Stepanovych"/> Evgeny Stepanovych</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=undsoft" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/gourlaouenp"><img src="https://avatars.githubusercontent.com/u/233624243?v=4?s=100" width="100px;" alt="gourlaouenp"/> gourlaouenp</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=gourlaouenp" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/clementloridan"><img src="https://avatars.githubusercontent.com/u/15263596?v=4?s=100" width="100px;" alt="Clément Loridan"/> Clément Loridan</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=clementloridan" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/mumenthalers"><img src="https://avatars.githubusercontent.com/u/3604424?v=4?s=100" width="100px;" alt="Simon Mumenthaler"/> Simon Mumenthaler</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=mumenthalers" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/antoine-delahaye"><img src="https://avatars.githubusercontent.com/u/46669439?v=4?s=100" width="100px;" alt="Antoine Delahaye"/> Antoine Delahaye</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=antoine-delahaye" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/mvanhorn"><img src="https://avatars.githubusercontent.com/u/455140?v=4?s=100" width="100px;" alt="Matt Van Horn"/> Matt Van Horn</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=mvanhorn" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/Kokkinis99"><img src="https://avatars.githubusercontent.com/u/77012231?v=4?s=100" width="100px;" alt="Kokkinis99"/> Kokkinis99</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=Kokkinis99" title="Code">💻</a></td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/MRinaldi9"><img src="https://avatars.githubusercontent.com/u/23497095?v=4?s=100" width="100px;" alt="Marco Rinaldi"/> Marco Rinaldi</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=MRinaldi9" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://www.zonaibhassan.com"><img src="https://avatars.githubusercontent.com/u/48220328?v=4?s=100" width="100px;" alt="Zonaib Bokhari"/> Zonaib Bokhari</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=xonaib" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/AntonPieper"><img src="https://avatars.githubusercontent.com/u/94118572?v=4?s=100" width="100px;" alt="Anton Pieper"/> Anton Pieper</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=AntonPieper" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://paulbarahona.com"><img src="https://avatars.githubusercontent.com/u/72539686?v=4?s=100" width="100px;" alt="Paul Barahona"/> Paul Barahona</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=pauldvlp" title="Code">💻</a></td>
 <td align="center" valign="top" width="14.28%"><a href="https://github.com/rikeshchhunju-sketch"><img src="https://avatars.githubusercontent.com/u/246430216?v=4?s=100" width="100px;" alt="Rikesh Chhunju"/> Rikesh Chhunju</a> <a href="https://github.com/ng-primitives/ng-primitives/commits?author=rikeshchhunju-sketch" title="Code">💻</a></td>
 </tr>
 </tbody>
</table>

## License

Angular Primitives is licensed under the [Apache License 2.0](LICENSE).

ng-primitives

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README