@worksafevictoria/wcl

Worksafe Component Library v2

This repo contains all the common components used on the WorkSafe Victoria public website.

Minimum Requirements

1. Yarn -> Latest (Needed for workspaces)
2. Node -> latest version 18.19.0
3. VSCode preferred
4. ESLint should be installed globally (npm install -g eslint)
5. Vue Dev tools plugin for Chrome / Firefox

Fresh Install

git clone <this-repo>
chmod +x bin/clean.sh
yarn reinstall

Run Dev

yarn dev

Build

yarn build

Deploy

chmod +x bin/deploy.sh
yarn deploy

Release - Dry run

yarn dryrun

Release

yarn release

Usage Instructions - Yarn - recommended

yarn add @worksafevictoria/wcl

Usage Instructions - npm

npm i @worksafevictoria/wcl

Nuxt - if you have errors after importing

# nuxt.config.js

build {
  transpile: ['@worksafevictoria/wcl', 'xxx', 'xxx', 'xxx']
}

Import example

<template>
  <container>
    <row>
      <column :md="6">
        <cta-button @clicked="$emit('nextScreen')">Start</cta-button>
      </column>
    </row>
  </container>
</template>

<script>
  import { Container, Column, Row, CtaButton } from '@worksafevictoria/wcl'
  export default {
    components: { Container, Column, Row, CtaButton }
  }
</script>

<style lang="scss" scoped>
  @import './styles';
</style>

Deployment Process - Beta

1. Checkout beta
2. Create a fresh branch from beta feat/JIRA-ID
3. ....Add changes....
4. After commits are added to this branch merge beta into feat/JIRA-ID
5. yarn test
6. Create Pull Request from feat/JIRA-ID to beta
7. Request code review from @worksafedigital
8. Merge feat/JIRA-ID into Beta

Deployment Process - Hotfix

1. Checkout release
2. Create a fresh branch from release hotfix/JIRA-ID
3. ....Add changes....
4. After commits are added to this branch merge release into feat/JIRA-ID
5. yarn test
6. Create Pull Request from feat/JIRA-ID to release
7. Request code review from @worksafedigital
8. Merge feat/JIRA-ID into release
9. Approve and release npm deployment from the release pipeline
10. Manually add your changes to beta using the steps for "Deployment Process - Beta"

Deployment Process - Release

1. Create Pull Request from beta to release
2. Request code review from @worksafedigital
3. Merge feat/JIRA-ID into release
4. Approve and release npm deployment from the release pipeline