chore: Auto-deploy documentation web site

Configure Gatsby to support deploying to sub-directory
  - AppLogo, Navigation and PropExamples need to properly construct URLs
  - Use Gatsby Link for embedded page link

Configure deploy to place build artifacts in subfolder `/v${VERSION}`

Configure release deploy to sym-link version to /latest

Configure index to redirect to /latest

Put workflow steps in place to deploy canary and release versions of
documentation site

Author: Luke Bowerman

.github/dependabot.yml

@@ -10,3 +10,7 @@ updates:
   reviewers:
   - lukelooker
   versioning-strategy: increase
+- package-ecosystem: github-actions
+  directory: "/"
+  schedule:
+    interval: weekly

.github/workflows/canary-release.yml

@@ -13,7 +13,7 @@ on:
       - '**/package*.json'
 
 jobs:
-  release-canary:
+  canary-release:
     runs-on: ubuntu-latest
     steps:
       - name: Clone repository

.github/workflows/canary-website.yml

@@ -0,0 +1,41 @@
+name: Web Site (canary)
+
+# This workflow creates or updates (if already exists) a pull request with new
+# version bump on every commit to main.
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'packages/**/*.ts'
+      - 'packages/**/*.tsx'
+      - 'www/src/**/'
+
+jobs:
+  canary-website:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v2
+        with:
+          persist-credentials: false
+          ref: main
+          fetch-depth: 0
+
+      - name: Install dependencies
+        run: |
+          yarn install
+
+      - name: Build web site
+        run: |
+          yarn website-canary
+
+      - name: Deploy 🚀
+        uses: JamesIves/[email protected]
+        with:
+          BRANCH: docs # The branch the action should deploy to.
+          CLEAN: false # Don't remove deleted files from the deploy branch
+          FOLDER: docs # The folder the action should deploy.
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # SINGLE_COMMIT: true

.github/workflows/release-website.yml

@@ -0,0 +1,47 @@
+name: Release web site
+
+# This workflow does the following if repo does not have git tag that was updated in lerna.json
+#  - creates release git tag
+#  - publishes packages to NPM with latest tag
+#
+# This workflow is expected to run after merge of release pull requested created by release-pull-request workflow.
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'lerna.json'
+
+jobs:
+  release-website:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@v2
+        with:
+          persist-credentials: false
+          ref: main
+          fetch-depth: 0
+
+      - name: Install dependencies
+        run: |
+          yarn install
+
+      - name: Read version created by Lerna
+        id: lerna_version
+        run: |
+          echo "::set-output name=version::v$(sed -nE 's/^\s*\"version\": \"(.*?)\",$/\1/p' lerna.json)"
+
+      - name: Build web site
+        run: |
+          yarn website-latest
+
+      - name: Deploy 🚀
+        uses: JamesIves/[email protected]
+        with:
+          BRANCH: docs # The branch the action should deploy to.
+          CLEAN: false # Automatically remove deleted files from the deploy branch
+          FOLDER: docs # The folder the action should deploy.
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # SINGLE_COMMIT: true

.github/workflows/release.yml

@@ -22,16 +22,20 @@ jobs:
         with:
           ref: main
           fetch-depth: 0
+
       - name: Fetch all tags
         run: |
           git fetch --depth=1 origin +refs/tags/*:refs/tags/*
+
       - name: Install dependencies
         run: |
           yarn install
-      - name: Read version created by Lerna.js
+
+      - name: Read version created by Lerna
         id: lerna_version
         run: |
-          echo "::set-output name=version::v$(npm run version --silent)"
+          echo "::set-output name=version::v$(sed -nE 's/^\s*\"version\": \"(.*?)\",$/\1/p' lerna.json)"
+
       - name: Check if release tag is already created
         id: vars
         run: |
@@ -42,9 +46,11 @@ jobs:
             echo "New release already created, exiting."
             exit 1
           fi
+
       - name: Build packages
         run: |
           yarn build
+
       - name: Create release
         id: create_release
         uses: actions/create-release@v1
@@ -55,6 +61,7 @@ jobs:
             See CHANGELOG file to see what's changed in new release.
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Publish to NPM registry
         run: npx lerna publish from-package --yes
         env:

.gitignore

@@ -14,7 +14,7 @@ node_modules
 .eslintcache
 
 # code-gen
-docs/static
+docs/v*/**
 packages/icons/src/generated
 playground/dist
 storybook-static

config/deploy.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+config/website.sh canary

config/website-canary.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+PACKAGE_VERSION=v$(sed -nE 's/^\s*"version": "(.*?)",$/\1/p' lerna.json)
+config/website.sh $PACKAGE_VERSION
+
+# Copy to `/latest` for default usage
+rm -rf docs/latest
+cp -r docs/$PACKAGE_VERSION docs/latest

config/website-latest.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+VERSION=$1
+
+# clean-up previous build if exists
+rm -rf docs/$VERSION
+
+# Build Gatsby, then move contents to public folder for publishing
+sed -i -e "s/VERSION/$VERSION/g" www/gatsby-config.js
+yarn workspace www build
+mv www/public docs/$VERSION
+
+# Build Storybooks
+yarn workspace storybook build
+mv storybook/storybook-static docs/$VERSION/storybook