Version compatibility
Use compatible Angular packages before installing @angular-bootstrap/ngbootstrap. This guide describes the published v2.5.0 package.
| Dependency | Supported range | When needed |
|---|---|---|
| Angular core, common and forms | 21.x or 22.x | Required. Keep Angular packages on matching versions. |
| RxJS | ^7.8.0 | Required peer dependency. |
| Bootstrap CSS | 5.x | Required base styles. Bootstrap JavaScript is not needed. |
| Chart.js | >=4.4.0 <5.0.0 | Optional; needed for grid-chart features. |
| Tailwind CSS | 4.x | Optional; needed to compile Tailwind utilities, not to use the Tailwind palette. |
Check an existing app
Run npm ls @angular/core @angular/common @angular/forms rxjs and resolve peer-dependency conflicts before upgrading. Select a Node.js version supported by your Angular CLI. Components and directives are standalone imports.
Angular Material is not required for any palette. Theme integration explains the optional CSS-variable mappings.