publish-gh-pages.yml

name: Publish GitHub Pages

on:
  workflow_dispatch:
    branches:
      - master
      - maintenance/*
  push:
    branches:
      - master
      - maintenance/*

env:
  # Among other things, opts out of Turborepo telemetry
  # See https://consoledonottrack.com/
  DO_NOT_TRACK: '1'
  # Some tasks slow down considerably on GitHub Actions runners when concurrency is high
  TURBO_CONCURRENCY: 1
  # Enables Turborepo Remote Caching.
  TURBO_REMOTE_CACHE_SIGNATURE_KEY: ${{ secrets.TURBO_REMOTE_CACHE_SIGNATURE_KEY }}
  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
  TURBO_TEAM: ${{ secrets.TURBO_TEAM }}

jobs:
  compile-v1-docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          ref: maintenance/v1.x

      - name: Install Dependencies
        uses: ./.github/workflows/actions/install-dependencies

      - name: Compile docs
        run: pnpm compile:docs

      - name: Assemble Deploy Directory
        run: |
          mkdir -p .ghpages-deploy/v1.x
          mv ./doc/* .ghpages-deploy/v1.x

      - uses: actions/upload-artifact@v4
        with:
          include-hidden-files: true
          name: ghpages-deploy-artifacts-v1-docs
          path: .ghpages-deploy
          retention-days: 1

  compile-github-pages:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Install Dependencies
        uses: ./.github/workflows/actions/install-dependencies

      - name: Compile
        run: pnpm turbo run compile:typedefs compile:ghpages --concurrency=${TURBO_CONCURRENCY:-1}
        env:
          REACT_EXAMPLE_APP_BASE_PATH: /solana-web3.js/example/

      - name: Assemble Deploy Directory
        run: |
          mkdir -p .ghpages-deploy
          mv ./examples/react-app/dist/ .ghpages-deploy/example/
          mv ./docs/* .ghpages-deploy/

      - uses: actions/upload-artifact@v4
        with:
          include-hidden-files: true
          name: ghpages-deploy-artifacts
          path: .ghpages-deploy
          retention-days: 1

  publish:
    runs-on: ubuntu-latest
    needs: [compile-v1-docs, compile-github-pages]
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Install Dependencies
        uses: ./.github/workflows/actions/install-dependencies

      - uses: actions/download-artifact@v4
        with:
          path: .ghpages-deploy
          pattern: ghpages-deploy-artifacts*
          merge-multiple: true

      - name: Deploy to Github Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: .ghpages-deploy