Pull request previews

1
name: preview-docs
2
3
on:
4
  pull_request_target:
5
    branches:
6
      - main
7
8
jobs:
9
  run:
10
    runs-on: ubuntu-latest
11
    permissions:
12
      pull-requests: write  # Only for commenting
13
      contents: read        # For checking out code
14
    steps:
15
      - name: Checkout repository
16
        uses: actions/checkout@v4
17
18
      - name: Install Fern
19
        run: npm install -g fern-api
20
21
      - name: Checkout PR
22
        if: github.event_name == 'pull_request_target'
23
        run: |
24
          git fetch origin pull/${{ github.event.pull_request.number }}/head:pr-${{ github.event.pull_request.number }}
25
          git checkout pr-${{ github.event.pull_request.number }}    
26
27
      - name: Generate preview URL
28
        id: generate-docs
29
        env:
30
          FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
31
        run: |
32
          OUTPUT=$(fern generate --docs --preview 2>&1) || true
33
          echo "$OUTPUT"
34
          URL=$(echo "$OUTPUT" | grep -oP 'Published docs to \K.*(?= \()')
35
          echo "Preview URL: $URL"
36
          echo "🌿 Preview your docs: $URL" > preview_url.txt
37
38
      - name: Comment URL in PR
39
        uses: thollander/actions-comment-pull-request@v2.4.3
40
        with:
41
          filePath: preview_url.txt