Installations
npm install @ng-bootstrap/ng-bootstrapScore
63.8
Supply Chain
96.3
Quality
82.4
Maintenance
100
Vulnerability
96.4
License
Developer
Developer Guide
Module System
ESM
Min. Node Version
Typescript Support
No
Node Version
20.14.0
NPM Version
10.7.0
Statistics
8,223 Stars
2,433 Commits
1,554 Forks
243 Watching
16 Branches
172 Contributors
Updated on 28 Nov 2024
Languages
TypeScript (95.99%)
HTML (1.99%)
EJS (1.2%)
JavaScript (0.42%)
SCSS (0.26%)
CSS (0.12%)
Shell (0.02%)
Total Downloads
Cumulative downloads
Total Downloads
123,006,884
Last day
-6.2%
105,427
Compared to previous day
Last week
-6.3%
596,660
Compared to previous week
Last month
26.1%
2,796,523
Compared to previous month
Last year
7.7%
25,850,150
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
1
NG Bootstrap - Angular-powered Bootstrap widgets
Angular widgets built from the ground up using only Bootstrap 5 CSS with APIs designed for the Angular ecosystem.
Please check our demo site and the list of issues to see all the things we are working on. Feel free to make comments there.
Table of Contents
- Demo
- Dependencies
- Installation
- Supported browsers
- Getting help
- Do you think you've found a bug?
- Contributing to the project
- Code of conduct
Demo
Please check all components we have in action at https://ng-bootstrap.github.io
Dependencies
The only dependencies are Angular, Bootstrap 5 CSS, and Popper.
Angular and Popper are explicitly listed as peer dependencies, while Bootstrap is not, as they don't release their CSS separately. The table below simply lists the exact version of Bootstrap CSS against which the corresponding versions of ng-bootstrap are tested.
| ng-bootstrap | Angular | Bootstrap CSS | Popper |
|---|---|---|---|
| 1.x.x | ^5.0.2 | 4.0.0 | |
| 2.x.x | ^6.0.0 | 4.0.0 | |
| 3.x.x | ^6.1.0 | 4.0.0 | |
| 4.x.x | ^7.0.0 | 4.0.0 | |
| 5.x.x | ^8.0.0 | 4.3.1 | |
| 6.x.x | ^9.0.0 | 4.4.1 | |
| 7.x.x, 8.x.x | ^10.0.0 | 4.5.0 | |
| 9.x.x | ^11.0.0 | 4.5.0 | |
| 10.x.x | ^12.0.0 | 4.5.0 | |
| 11.x.x | ^13.0.0 | 4.6.0 | |
| 12.x.x | ^13.0.0 | 5.0.0 | ^2.10.2 |
| 13.x.x | ^14.1.0 | 5.2.0 | ^2.10.2 |
| 14.x.x | ^15.0.0 | 5.2.3 | ^2.11.6 |
| 15.x.x | ^16.0.0 | 5.2.3 | ^2.11.6 |
| 16.x.x | ^17.0.0 | 5.3.2 | ^2.11.8 |
| 17.x.x | ^18.0.0 | 5.3.2 | ^2.11.8 |
Installation
We strongly recommend using Angular CLI for setting up a new project. If you have an Angular CLI project, you could simply use our schematics to add ng-bootstrap library to it.
Just run the following:
1ng add @ng-bootstrap/ng-bootstrap
It will install ng-bootstrap for the default application specified in your angular.json.
If you have multiple projects and you want to target a specific application, you could specify the --project option:
1ng add @ng-bootstrap/ng-bootstrap --project myProject
If you prefer not to use schematics and install everything manually, please refer to the manual installation instructions on our website.
Supported browsers
We support the same browsers and versions supported by both Bootstrap 4 and Angular, whichever is more restrictive. See Angular browser support and Bootstrap browser support for more details.
Our code is automatically tested on all supported browsers.
Getting help
Please, do not open issues for the general support questions as we want to keep GitHub issues for bug reports and feature requests. You've got much better chances of getting your question answered on StackOverflow where maintainers are looking at questions tagged with ng-bootstrap.
StackOverflow is a much better place to ask questions since:
- there are hundreds of people willing to help on StackOverflow
- questions and answers stay available for public viewing so your question/answer might help someone else
- Stack Overflow's voting system assures that the best answers are prominently visible.
To save your and our time we will be systematically closing all the issues that are requests for general support and redirecting people to StackOverflow.
Do you think you've found a bug?
We want to fix it ASAP! But before fixing a bug we need to reproduce and confirm it.
We ask you to respect two things:
- fill the GitHub issue template by providing the bug description and appropriate versions of Angular, ng-bootstrap and TypeScript
- provide a use-case that fails with a minimal reproduction scenario using StackBlitz (you can start by forking one from our demo page)
A minimal reproduction scenario allows us to quickly confirm a bug (or point out a coding problem) as well as confirm that we are fixing the right problem.
Please note that we will be insisting on a minimal reproduction scenario in order to save maintainers time and ultimately be able to fix more bugs. We'll mark the issue as non-actionable without it and close if not heard from the reporter.
Interestingly, from our experience users often find coding problems themselves while preparing a minimal StackBlitz. We understand that sometimes it might be hard to extract essential bits of code from a larger code-base but we really need to isolate the problem before we can fix it.
Contributing to the project
Please check DEVELOPER.md for documentation on running the project locally and CONTRIBUTING.md for contribution guidelines.
Code of conduct
Please take a moment and read our Code of Conduct
No vulnerabilities found.
Reason
no dangerous workflow patterns detected
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
no binaries found in the repo
Reason
7 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 6
Reason
Found 6/16 approved changesets -- score normalized to 3
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: no topLevel permission defined: .github/workflows/ci.yml:1
- Warn: no topLevel permission defined: .github/workflows/saucelabs.yml:1
- Info: no jobLevel write permissions found
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'master'
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/ci.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/ci.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/saucelabs.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/saucelabs.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/saucelabs.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/saucelabs.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/saucelabs.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/saucelabs.yml/master?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/saucelabs.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/saucelabs.yml/master?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/saucelabs.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/ng-bootstrap/ng-bootstrap/saucelabs.yml/master?enable=pin
- Info: 0 out of 8 GitHub-owned GitHubAction dependencies pinned
- Info: 0 out of 3 third-party GitHubAction dependencies pinned
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 24 are checked with a SAST tool
Reason
23 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-8hc4-vh64-cxmj
- Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7
- Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x
- Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
- Warn: Project is vulnerable to: GHSA-phwq-j96m-2c2q
- Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6
- Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx
- Warn: Project is vulnerable to: GHSA-8mmm-9v2q-x3f9
- Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97
- Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j
- Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27
- Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
- Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
- Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
- Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
- Warn: Project is vulnerable to: GHSA-44c6-4v22-4mhx
- Warn: Project is vulnerable to: GHSA-4x5v-gmq8-25ch
- Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
- Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
- Warn: Project is vulnerable to: GHSA-3g92-w8c5-73pq
- Warn: Project is vulnerable to: GHSA-4vvj-4cpr-p986 / GHSA-64vr-g452-qvp3
- Warn: Project is vulnerable to: GHSA-9cwx-2883-4wfx
- Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Score
3.3
/10
Last Scanned on 2024-11-18
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More