Skip to content

Add workflow to auto-update SDK versions#1174

Open
rengarajan01 wants to merge 2 commits into
auth0:mainfrom
rengarajan01:fix/sdk-library-update
Open

Add workflow to auto-update SDK versions#1174
rengarajan01 wants to merge 2 commits into
auth0:mainfrom
rengarajan01:fix/sdk-library-update

Conversation

@rengarajan01
Copy link
Copy Markdown
Member

Description

Adds .github/workflows/update-sdk-versions.yml: a scheduled GitHub Actions workflow that keeps SDK version badges and release dates in main/docs/libraries.mdx up to date automatically.

The workflow runs daily at 6:17 UTC (and supports manual dispatch). For each of the 34 SDK entries in the libraries page it fetches the latest release from GitHub and updates two fields in the corresponding SectionCard component:

  • badge: the version tag (e.g. v2.3.0)
  • date: the formatted release date (e.g. Jan 23, 2024)

Two fetch strategies are used depending on the repo:

  • Standard: releases/latest, with a tag fallback for repos that have no formal releases
  • Prefixed: filters releases by tag prefix for monorepos where multiple packages share a repo (e.g. auth0/auth0-fastify, auth0/universal-login, auth0/auth0-oidc-client-net)

If any values changed, the workflow creates a branch chore/sdk-version-update-YYYYMMDD and opens a PR targeting main labeled sdk-version-autoupdate.

References

n/a

Testing

  1. After merging, go to Actions → Update SDK library versions → Run workflow to trigger a manual run
  2. Verify a PR is opened with updated badge and date values in main/docs/libraries.mdx
  3. Confirm no duplicate PR is created if the workflow is triggered again on the same day

Checklist

  • I've read and followed CONTRIBUTING.md.
  • I've tested the site build for this change locally.
  • I've made appropriate docs updates for any code or config changes.
  • I've coordinated with the Product Docs and/or Docs Management team about non-trivial changes.

Add a GitHub Actions workflow (.github/workflows/update-sdk-versions.yml) that runs daily (and on manual dispatch) to fetch latest releases/tags for various SDK repos using the GitHub CLI and jq, and update badge and date fields in main/docs/libraries.mdx. The script handles repos with prefixed tags (monorepos), falls back to tags/commits when no release exists, formats dates, and uses sed to patch the file. If changes are detected it creates a branch (chore/sdk-version-update-YYYYMMDD) and opens a PR labeled sdk-version-autoupdate, avoiding duplicate open PRs.
@rengarajan01 rengarajan01 requested review from a team as code owners May 13, 2026 16:02
Remove the ACUL SDK block from the update-sdk-versions workflow by deleting the "universal-login" update_sdk_prefixed call and its comment. This stops automatic version updates for auth0/universal-login (auth0-acul-js-v) in the workflow.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants