generate-docs.yml

name: Convert OpenAPI to HTML and Deploy to GitHub Pages

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    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

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

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