Primors

Package library for common React functionalities.

View Documentation View Github

CI/CD

This project is set up with GitHub actions to trigger these actions on push to main with a new version tag.

Note: Every new version should be created using yarn version, see Release a new version.

Actions:

  • release: Triggers on push to the main branch with a new version tag.
    1. Creates a new GitHub release with release notes taken from CHANGELOG.md for the current version.
  • publish-package-and-deploy-docs: Triggers on each new release.
    1. Builds and publishes the library to the npm package registry.
    2. Builds and deploys the Storybook live documentation app to GH Pages.

To run these processes manually, please see Release below.

Development

Getting started

To install all dependencies, run:

yarn install

Local development

To build the functionalities locally, run:

yarn build

To run the Storybook app locally, which listens for changes and hotreloads, run:

yarn storybook

You can also build a production build of the Storybook app locally by running:

yarn build-storybook

Release

Release a new version

To create a new version ready for publish and deploy, run:

yarn version

Publishing npm package

To build and publish a new version of the package, run:

yarn version
yarn publish

yarn version automatically generates a new changelog in CHANGELOG.md based on all commits since last release, and bumps the version of the package in package.json and tags the release.

yarn publish deploys a new version to the NPM package registry.

Deploying Storybook app

To build and deploy the Storybook live documentation app, run:

yarn deploy-storybook
Commit format

This project uses auto-changelog to automatically generate a changelog. You can use several prefixes matching the regex specified here in your commit messages to categorize commits in your changelog:

  • Feat(ure)?:: New features, for the library. Changes to the Storybook app should be categorized under "Performance".
  • Fix:: Bug fixes.
  • Impr?(ovement)?:: General improvements.
  • Perf(ormance)?:: Performance improvements.
  • Doc(umentation|s)?:: Changes to documentation, e.g. README.md or the Storybook app.
  • Build:: Changes to the build or deploy environments.
  • Conf(ig)?(uration)?:: Changes to project configuration.
  • Any commits not matching one of these patterns will not be categorized.
Breaking changes

You can mark any commit as a breaking change by writing "BREAKING CHANGE" anywhere in your commit message.

Linting

To lint the project, I suggest installing the ESLint plugin in your editor, but to run it from terminal, run:

yarn lint