Local development

Build the library:

pnpm build

Storybook (port 6006):

pnpm storybook

Watch mode:

pnpm start

Testing a local build in another project

In the consuming project's package.json, point at the local path:

"@xqmsg/ui-core": "file:../ui-core"

After any change, rebuild and reinstall:

pnpm run build
rm -rf node_modules/@xqmsg && pnpm i

Creating a PR

Branch off master with a descriptive name. Commit with a signed message so changes are attributable.

Releasing a new version

1. Update the changelog — add a summary entry to CHANGELOG.md and a dated detail file to Changelog/. See existing entries for the format.
2. Bump the version in package.json manually, or:

   npm version [patch|minor|major] --no-git-tag-version

3. Commit and tag:

   git add CHANGELOG.md Changelog/ package.json
   git commit -m "chore: release vX.Y.Z"
   git tag vX.Y.Z
   git push origin && git push origin --tags

Do not use the release:patch / release:minor / release:major scripts — they auto-generate and overwrite CHANGELOG.md, breaking the manual Changelog/ workflow.

Publishing to npm

From master, after a clean install:

pnpm run clean && pnpm install && pnpm run build && npm publish