@martinsura/ui

React UI component library built on Tailwind CSS v4.

Development

Start the local preview app:

npm start

Build the library for publishing:

npm run build

Publishing Workflow

Source code lives in a private GitHub repository:

• GitHub: https://github.com/martinsura/ui
• npm package: @martinsura/ui

Publishing to npm is handled by GitHub Actions in publish.yml.

Push changes to GitHub only

If you want to save work to GitHub without creating an npm release, push only the branch:

git add .
git commit -m "Update components"
git push origin main

This does not publish anything to npm.

Publish a new npm version

1. Update the version in package.json.
2. Commit and push the branch.
3. Create a Git tag with the same version prefixed by v.
4. Push the tag.

Example for version 0.1.1:

git add .
git commit -m "Release 0.1.1"
git push origin main

git tag v0.1.1
git push origin v0.1.1

Important:

• package.json version should match the tag version
• example: package.json = 0.1.1, Git tag = v0.1.1
• the npm publish runs only when the tag is pushed

Emergency local publish

If you ever need an emergency hotfix without waiting for GitHub Actions, you can publish directly from your machine:

npm run build
npm publish --access public

Important:

• always bump the version in package.json first
• npm does not allow publishing the same version twice
• this should be used only as a fallback, not as the default release workflow

GitHub Actions Setup

Before the first npm release, add this repository secret in GitHub:

• NPM_TOKEN

That token is used by the publish workflow to run:

npm publish