generate-docs.yml

name: Convert OpenAPI to HTML and Deploy to GitHub Pages

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pages: write
      id-token: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v2

      - name: Set up Node.js
        uses: actions/setup-node@v2
        with:
          node-version: "16"

      - name: Install Redoc CLI
        run: npm install -g @redocly/cli

      - name: Generate HTML from OpenAPI JSON
        run: |
          redocly build-docs ./api/latest.json -o ./docs/index.html
          touch ./docs/.nojekyll

      - name: Upload HTML Artifacts
        uses: actions/upload-pages-artifact@v1
        with:
          path: ./docs

  deploy:
    runs-on: ubuntu-latest
    needs: build
    permissions:
      contents: read
      pages: write
      id-token: write

    steps:
      - name: Deploy to GitHub Pages
        uses: actions/deploy-pages@v1
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}