`npm i -S @loophq/component-library`
npm install @loophq/component-librarynpm i -S @loophq/component-library
Components can be imported by importing the component individually:
import BaseCard from '@loophq/component-library/BaseCard';
This is preferred because it allows for better code-splitting
Components can be imported via named imports:
import { BaseCard } from '@loophq/component-library';
To import all and register globally (not recommended), run this in your main.js:
`` js
import LoopComponents from '@loophq/component-library';
Vue.use(LoopComponents);
`
npm i
`Local component testing
`
npm run dev
`Unit tests
`
npm run vitest
`$3
`
npm run storybook
`$3
`
npm run library:build
`$3
`
npm run library:publish --
`Compiles and minifies docs
`
npm run build-storybook
`Releasing
0. If this is your first time releasing, ask in the engineering team channel to be added to the loop npm organization. Make sure you log in to npm in your terminal as well.
1. On your machine, check out the branch you'd like to release. This can either be a feature branch or a release branch if you have multiple features to package together as a release. This branch should be PRed into
main and be approved by a peer before releasing.
2. Compile the component library
`
npm run library:build
`
(Optional) Commit any file changes the build script made. This is not always necessary but when adding new components this will generally be necessary.3. Figure out the version number this release will be. We follow SemVer, and the general rule of thumb is that if you're adding new components, bump the minor version, everything else should just bump the patch version. Major versions bumps are rare and should be a team decision.
4. Publish the library to npm. Make sure you are on the branch you intend to release, this will modify your
package.json and you MUST be on a non-main branch for this to be mergeable.
`
npm run library:publish --
``