@ardoq/shared-ui

Ardoq Shared UI

Re-usable components for ardoq's front-end applications.

For now the storybook is published from the ardoq-front repository, but we aim to move the stories here soon.

Contributing

Write commit messages as changelog entries

While the library is still considered unstable, the git history serves as the canonical list of changes between versions. So please write self-contained commits, with subjects and descriptions which allow users of the library to easily see and understand what has changed and why.

Prepare pull requests for dependent projects

Since we do not yet have meaningful semantic versioning of this library, if a change modifies an external interface, it is advisable to prepare in advance any PRs necessary to update dependent projects (eg. ardoq-front, ardoq-surveys) for the modifications being made. Link these when creating your PR for shared-ui.

Using yarn link to test the library without publishing a new version

1. In the root folder of this project, run yarn watch. This will continuously build the package when you make changes in /src.
2. In the /dist folder of this project, run yarn link. This allows yarn to install the package via symlinks.
3. In the root folder of the repostiory that you would like to link (i.e. ardoq-front), run yarn link @ardoq/shared-ui. This tells yarn to install the package from the dist folder.

Now any changes that you make in /src should be automatically reflected in the repository where you linked the package. Later, you might want to use the published version of the package again. Run yarn unlink @ardoq/shared-ui from within the linked repo (i.e. ardoq-front).

Publishing a new version of the package

1. Verify that "it works": yarn lint && yarn check-types
2. Bump the version yarn version
3. Publish (DO NOT BUMP THE VERSION HERE!): yarn run publish