MAKS-IT/maksit-webui
1
0
Fork 0
mirror of https://github.com/MAKS-IT-COM/maksit-webui.git synced 2026-06-30 20:06:43 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity
0f2638d439
maksit-webui/README.md
Maksym Sadovnychyy 003018df9f
Some checks failed
Storybook tests / storybook-tests (push) Has been cancelled
Details
(feature): add useWebUiHub
2026-05-31 19:58:46 +02:00

2.5 KiB
Raw Blame History

MaksIT.WebUI

Line Coverage Branch Coverage Method Coverage

Shared React UI library for maksit-certs-ui and maksit-vault WebUI apps.

Packages

npm package Description
@maks-it.com/webui-contracts Shared TypeScript contracts (paging, gallery types, patch ops, scopes)
@maks-it.com/webui-core Utilities (deepDelta, enum helpers, ACL parsers) and useFormState
@maks-it.com/webui-components React components, layout, editors, DataTable, auth shell

Source lives under src/ (npm workspaces). Release automation lives under utils/src/ (from maksit-repoutils).

Local development

cd src
npm install
npm run build
npm test
npm run storybook

Storybook (npm run storybook) runs a local catalog of @maks-it.com/webui-components with Tailwind, React Router, autodocs, a11y checks, and Vitest component tests (testing widget + npm run test-storybook). Stories live under src/stories/components/ (mirroring component folders); see src/stories/README.md for story conventions and testing.

Tests and coverage badges: utils/src/Invoke-TestEngine.bat (plugin config in utils/src/engines/test/scriptSettings.json; uses NpmJestTest).

Release to npmjs

  1. Set NPMJS_MAKS_IT to your npm automation token (same pattern as NUGET_MAKS_IT for NuGet).
  2. Bump src/package.json version (and tag vX.Y.Z on main when using the publish guard).
  3. Run utils/src/Invoke-ReleasePackage.bat (or pwsh utils/src/engines/release/Invoke-ReleasePackage.ps1).

Configured plugins (see utils/src/engines/release/scriptSettings.json):

Plugin Role
NpmReleaseVersion Read semver from src/package.json; sync packages/*/package.json
NpmBuild npm ci + npm run build
ReleasePublishGuard Branch/tag checks before publish
GitHub GitHub release (optional; needs GITHUB_MAKS_IT_COM)
NpmPublish Publish workspace packages in dependency order

Refresh shared utils from repoutils: utils/src/Update-RepoUtils.bat.

Consume in product repos

npm install @maks-it.com/webui-contracts @maks-it.com/webui-core @maks-it.com/webui-components

Wrap the app with WebUiProvider and pass axios/redux adapters — see assets/docs/NPM_CONSUMPTION.md.

License

MIT