# @opuscapita/dashboard-widgets

> Dashboard widgets components library.

Latest version **1.5.0** (published 2025-09-29) · 0 weekly downloads

## Install

```sh
npm install @opuscapita/dashboard-widgets
pnpm add @opuscapita/dashboard-widgets
yarn add @opuscapita/dashboard-widgets
bun add @opuscapita/dashboard-widgets
```

## Health

**Score 40/100 (D)** — status: maintenance-mode.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.5.0 |
| Published | 2025-09-29 |
| First published | 2022-11-09 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 248.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | OpusCapita |
| Maintainers | kuos, ocmachineuser, elaczapiewska, ocautomation, piotr.krzysztof.murdzia, dsbbl, smachnow, ariusz, ilhamkadduri |

## Links

- npm: https://www.npmjs.com/package/@opuscapita/dashboard-widgets
- npm.io page: https://npm.io/package/@opuscapita/dashboard-widgets

## Dependencies (1)

- [react-bootstrap](https://npm.io/package/react-bootstrap.md) ^2.10.10

## Recent versions

- 1.5.0 (latest) — 2025-09-29
- 1.4.1 — 2023-12-07
- 1.4.0 — 2023-12-06
- 1.3.0 — 2023-09-28
- 1.2.0 — 2023-01-13
- 1.1.0 — 2022-12-14
- 1.0.2 — 2022-11-09
- 1.0.1 — 2022-11-09
- 1.0.0 — 2022-11-09

## README

## Development

### Run library locally:
Make sure you use node 14 (node -v to check)
1. Run `npm install` to install dependencies
2. Run `npm run dev` to start the development server
3. In `local/index.tsx` there's a local playground for the library. Import the components you want to test and use them in the playground. Do not commit this file.

<br />

### Run tests
Make sure you use node 14 (node -v to check)
* Run `npm run test` to run the tests
* Run `npm run test:ui` to run UI for the tests

<br />

### Linting
* Run `npm run lint` to run the linter
* Run `npm run lint:fix` to run the linter and fix errors
* This library uses husky and lint-staged to run the linter on pre-commit

<br />

### Run package in other project
0. (Optionally) Run `npm run release:dry` to report what would have done, if you publish the package
1. Run `npm pack` to create a tarball
2. Go to the project you want to test the package in and run `npm i -D <path to tarball>`, e.g.: `npm i -D '~/Desktop/dashboard-widgets/dashboard-widgets-0.0.1.tgz'`

<br />

### Publishing
1. Make sure you are logged in to npm with the `npm whoami`, and you are added to **OpusCapita** npm registry
2. Make sure your working directory is clean
3. Run `npm run release` to publish the package
4. Follow the steps in the terminal

<br />

### Contributing
1. Create a branch `feature/BNAPP-<ticket number>_<short description>`
2. On the branch, make your changes
3. Create tests and stories for each new component / use case **if applicable**
4. Run `npm run test` to make sure all tests pass
5. Commit those changes and create meaningful pull request
6. After PR is approved, merge it to master
7. Release the package to npm according to the `Publishing` instruction above

---
_Source: https://npm.io/package/@opuscapita/dashboard-widgets · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._