mirror of
https://github.com/MAKS-IT-COM/maksit-webui.git
synced 2026-09-30 04:08:09 +02:00
60 lines
2.6 KiB
Markdown
60 lines
2.6 KiB
Markdown
# MaksIT.WebUI
|
|
|
|
|
|
|
|
|
|
|
|
Shared React UI library for **maksit-certs-ui** and **maksit-vault** WebUI apps.
|
|
|
|
## Package
|
|
|
|
| npm package | Description |
|
|
|-------------|-------------|
|
|
| `@maks-it.com/webui` | Contracts, utilities (`deepDelta`, hooks, HTTP, SignalR), and React components |
|
|
|
|
Source lives under `src/` (`@maks-it.com/webui` — `contracts/`, `core/`, `components/`). Release automation lives under `utils/`.
|
|
|
|
## Local development
|
|
|
|
```bash
|
|
cd src
|
|
npm install
|
|
npm run build
|
|
npm test
|
|
npm run storybook
|
|
```
|
|
|
|
**Storybook** (`npm run storybook`) runs a local component catalog with Tailwind, React Router, autodocs, a11y checks, and **Vitest component tests** (testing widget + `npm run test-storybook`). Stories live under `src/stories/components/`; see `src/stories/README.md`.
|
|
|
|
Tests and coverage badges (shields.io URLs in this README): **`utils\Invoke-TestEngine.bat`** (plugin config in `utils\engines\test\scriptSettings.json`; uses `NpmJestTest` + `CoverageBadges` with `badgeFormat: shields`).
|
|
|
|
## Release to npmjs
|
|
|
|
1. Set **`RepoUtilsSecretsShared`** and **`RepoUtilsSecrets`** to JSON objects. Slots used here: **`Npm`** (npm automation token) and **`GitClone`** (GitHub token). The repo pack overrides the shared pack.
|
|
2. Bump **`src/package.json`** `version` (and tag `v{version}` on `main` when using the publish guard — `v1.2.3` or SemVer prerelease such as `v0.1.0-alpha.1`). Prerelease versions publish with npm dist-tag `alpha`/`beta`/`rc` and do not move `latest`.
|
|
3. Run **`utils\Invoke-ReleasePackage.bat`** (or `pwsh utils\engines\release\Invoke-ReleasePackage.ps1`).
|
|
|
|
Configured plugins (see `utils\engines\release\scriptSettings.json`):
|
|
|
|
| Plugin | Role |
|
|
|--------|------|
|
|
| `NpmReleaseVersion` | Read semver from `src/package.json` |
|
|
| `NpmBuild` | `npm ci` + `npm run build` |
|
|
| `ReleasePublishGuard` | Branch/tag checks before publish |
|
|
| `GitHub` | GitHub release (optional; `GitClone` slot in the secrets pack) |
|
|
| `NpmPublish` | Stage `@maks-it.com/webui` (`npm stage publish`). A maintainer approves with 2FA (`npm stage approve`). Requires npm CLI 11.15 or newer. |
|
|
|
|
Refresh shared utils from **[maksit-repoutils](https://git.maks-it.com/MAKS-IT/maksit-repoutils)** via local-copy sync (no Update-RepoUtils in product repos).
|
|
|
|
## Consume in product repos
|
|
|
|
```bash
|
|
npm install @maks-it.com/webui
|
|
```
|
|
|
|
See [assets/docs/NPM_CONSUMPTION.md](assets/docs/NPM_CONSUMPTION.md).
|
|
|
|
## License
|
|
|
|
MIT
|