Skip to main content

Deploy docs.haqerp.com

The HAQ ERP docs site is static Docusaurus output. Host it separately from the app container to avoid another always-on replica.

  • Azure Static Web Apps for docs.haqerp.com.
  • GitHub Actions deployment token stored as AZURE_STATIC_WEB_APPS_API_TOKEN_DOCS.
  • DNS CNAME from docs.haqerp.com to the Static Web Apps default host.

Create the Static Web App​

Create the static app without attaching Azure’s generated workflow. HAQ ERP already has a CI workflow, and it deploys from docs-site/build when the token is present.

az staticwebapp create \
  --name stapp-haqerp-docs-uks \
  --resource-group rg-haqerp-uks \
  --location westeurope \
  --sku Free

Fetch the deployment token:

az staticwebapp secrets list \
  --name stapp-haqerp-docs-uks \
  --resource-group rg-haqerp-uks \
  --query "properties.apiKey" \
  --output tsv

Add that value as a GitHub repository secret named:

AZURE_STATIC_WEB_APPS_API_TOKEN_DOCS

If you prefer GitHub CLI:

gh secret set AZURE_STATIC_WEB_APPS_API_TOKEN_DOCS

Local build check​

cd docs-site
npm install
npm run build

GitHub secret needed​

Add this repository secret:

AZURE_STATIC_WEB_APPS_API_TOKEN_DOCS

When the secret is missing, CI still builds the docs but skips the deploy step.

DNS​

Create this DNS record after the Static Web Apps host exists:

docs CNAME <your-static-web-app-default-host>

Then register the hostname in Azure:

az staticwebapp hostname set \
  --name stapp-haqerp-docs-uks \
  --resource-group rg-haqerp-uks \
  --hostname docs.haqerp.com

Keep the docs-site/static/CNAME file set to:

docs.haqerp.com

Verification​

After deployment, open:

https://docs.haqerp.com

Then check the pages for Accounting, POS Lite, Inventory, Approvals, Admin, Import, and Troubleshooting from the left navigation.