feat: add HowTo JSON-LD schema to quickstart guides

[kevlil83]

Summary

• Adds main/snippets/JsonLd.jsx — a minimal reusable snippet that renders a <script type="application/ld+json"> tag from a data prop.
• Applies HowTo structured data to 39 quickstart index.mdx pages across native, SPA, webapp, and backend platforms, exposing each guide's steps as machine-readable HowToStep entries.

Why

Improves discoverability in AI-powered search (ChatGPT, Perplexity, Google AI Overviews, Gemini) and in traditional search rich results. Quickstarts are our highest-intent entry pages — making their step structure machine-readable helps these surfaces cite and summarize them accurately.

Scope

• Pages touched: 19 native, 7 SPA, 13 webapp — see main/docs/quickstart/**/index.mdx
• One new snippet: main/snippets/JsonLd.jsx
• No navigation or docs.json changes
• No production JS/CSS bundle rebuild needed — JsonLd is an MDX snippet, not a UI library component

Notes for reviewers

• The Go backend quickstart (main/docs/quickstart/backend/golang/index.mdx) had a merge conflict because it was recently reorganized on main. Schema was placed after imports and before export const envSnippet to match the pattern used in the other 38 files (see nextjs/index.mdx for reference). Step names in that file's schema may need a second pass to align with the new single-file golang structure — flagging for follow-up.
• The <JsonLd /> component emits a raw <script> element via dangerouslySetInnerHTML; the JSON is serialized once at render time.

Test plan

• cd main && mint dev renders without new errors
• View source on several quickstart pages and confirm one application/ld+json block is present with valid JSON
• Paste rendered JSON into https://validator.schema.org — no errors on a sample of 3-5 pages
• Spot-check: /docs/quickstart/webapp/nextjs, /docs/quickstart/backend/golang, /docs/quickstart/spa/react, /docs/quickstart/native/ios-swift

[github-actions]

Summary

Status	Count
🔍 Total	329
✅ Successful	212
⏳ Timeouts	0
🔀 Redirected	37
👻 Excluded	75
❓ Unknown	0
🚫 Errors	5
⛔ Unsupported	0

Errors per input

Errors in main/docs/quickstart/spa/angular/index.mdx

• [ERROR] https://classic.yarnpkg.com/lang/en/docs/install/ | Error (cached)

Errors in main/docs/quickstart/spa/react/index.mdx

• [ERROR] https://classic.yarnpkg.com/lang/en/docs/install/ | Error (cached)

Errors in main/docs/quickstart/spa/vuejs/index.mdx

• [ERROR] https://classic.yarnpkg.com/lang/en/docs/install/ | Network error: Connection reset by server. Server forcibly closed connection

Errors in main/docs/quickstart/webapp/nextjs/index.mdx

• [ERROR] https://classic.yarnpkg.com/lang/en/docs/install/ | Error (cached)

Errors in main/docs/quickstart/webapp/nuxt/index.mdx

• [ERROR] https://classic.yarnpkg.com/lang/en/docs/install/ | Network error: Connection reset by server. Server forcibly closed connection

Redirects per input

Redirects in main/docs/quickstart/backend/aspnet-core-webapi/index.mdx

• [200] https://dotnet.microsoft.com/download/dotnet/8.0 | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://dotnet.microsoft.com/download/dotnet/8.0 --> https://dotnet.microsoft.com/en-us/download/dotnet/8.0

Redirects in main/docs/quickstart/backend/fastapi/index.mdx

• [200] https://auth0.com/docs/authorization | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/authorization --> https://auth0.com/docs/get-started/authentication-and-authorization-flow
• [200] https://auth0.com/docs/customize/actions | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/customize/actions --> https://auth0.com/docs/customize/actions/actions-overview
• [200] https://auth0.com/docs/deploy | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/deploy --> https://auth0.com/docs/deploy-monitor
• [200] https://jwt.io/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://jwt.io/ --> https://www.jwt.io/

Redirects in main/docs/quickstart/backend/fastify/index.mdx

• [200] https://docs.npmjs.com/downloading-and-installing-node-js-and-npm | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm --> https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/

Redirects in main/docs/quickstart/backend/golang/index.mdx

• [200] https://git-scm.com/downloads | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://git-scm.com/downloads --> https://git-scm.com/downloads/

Redirects in main/docs/quickstart/backend/python/index.mdx

• [200] https://flask.palletsprojects.com/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://flask.palletsprojects.com/ --> https://flask.palletsprojects.com/en/stable/

Redirects in main/docs/quickstart/native/android-facebook-login/index.mdx

• [200] https://developers.facebook.com/docs/facebook-login/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://developers.facebook.com/docs/facebook-login/ --> https://developers.facebook.com/documentation/facebook-login
• [200] https://developers.facebook.com/policy/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://developers.facebook.com/policy/ --> https://developers.facebook.com/terms/

Redirects in main/docs/quickstart/native/android/index.mdx

• [200] https://developer.android.com/training/app-links/verify-site-associations | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://developer.android.com/training/app-links/verify-site-associations --> https://support.google.com/android/search?q=open+by+default

Redirects in main/docs/quickstart/native/ionic-angular/index.mdx

• [200] https://auth0.com/docs/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/ --> https://auth0.com/docs
• [200] https://developer.android.com/training/app-links/deep-linking | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://developer.android.com/training/app-links/deep-linking --> https://developer.android.com/training/app-links/create-deeplinks

Redirects in main/docs/quickstart/native/ionic-react/index.mdx

• [200] https://auth0.com/docs/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/ --> https://auth0.com/docs

Redirects in main/docs/quickstart/native/ionic-vue/index.mdx

• [200] https://auth0.com/docs/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/ --> https://auth0.com/docs
• [200] https://developer.android.com/training/app-links/deep-linking | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://developer.android.com/training/app-links/deep-linking --> https://developer.android.com/training/app-links/create-deeplinks

Redirects in main/docs/quickstart/native/ios-swift-facebook-login/index.mdx

• [200] https://developers.facebook.com/docs/facebook-login/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://developers.facebook.com/docs/facebook-login/ --> https://developers.facebook.com/documentation/facebook-login
• [200] https://developers.facebook.com/policy/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://developers.facebook.com/policy/ --> https://developers.facebook.com/terms/

Redirects in main/docs/quickstart/native/maui/index.mdx

• [200] https://dotnet.microsoft.com/download | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://dotnet.microsoft.com/download --> https://dotnet.microsoft.com/en-us/download

Redirects in main/docs/quickstart/native/react-native-expo/index.mdx

• [200] https://auth0.com/docs/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/ --> https://auth0.com/docs

Redirects in main/docs/quickstart/native/react-native/index.mdx

• [200] https://auth0.com/docs/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/ --> https://auth0.com/docs

Redirects in main/docs/quickstart/native/wpf-winforms/index.mdx

• [200] https://dotnet.microsoft.com/download/dotnet/8.0 | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://dotnet.microsoft.com/download/dotnet/8.0 --> https://dotnet.microsoft.com/en-us/download/dotnet/8.0

Redirects in main/docs/quickstart/spa/flutter/index.mdx

• [200] https://auth0.com/docs/connections/social | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/connections/social --> https://auth0.com/docs/authenticate/identity-providers/social-identity-providers
• [200] https://auth0.com/docs/customize/universal-login-pages | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/customize/universal-login-pages --> https://auth0.com/docs/customize/login-pages

Redirects in main/docs/quickstart/spa/svelte/index.mdx

• [200] https://docs.npmjs.com/downloading-and-installing-node-js-and-npm | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm --> https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/

Redirects in main/docs/quickstart/spa/vanillajs/index.mdx

• [200] https://docs.npmjs.com/downloading-and-installing-node-js-and-npm | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm --> https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/

Redirects in main/docs/quickstart/spa/vuejs/index.mdx

• [200] https://docs.npmjs.com/downloading-and-installing-node-js-and-npm | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm --> https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/

Redirects in main/docs/quickstart/webapp/aspnet-core-blazor-server/index.mdx

• [200] https://dotnet.microsoft.com/download | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://dotnet.microsoft.com/download --> https://dotnet.microsoft.com/en-us/download

Redirects in main/docs/quickstart/webapp/aspnet-core/index.mdx

• [200] https://dotnet.microsoft.com/download | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://dotnet.microsoft.com/download --> https://dotnet.microsoft.com/en-us/download

Redirects in main/docs/quickstart/webapp/express/index.mdx

• [200] https://auth0.com/docs/connections/social | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/connections/social --> https://auth0.com/docs/authenticate/identity-providers/social-identity-providers
• [200] https://auth0.com/docs/customize/universal-login-pages | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/customize/universal-login-pages --> https://auth0.com/docs/customize/login-pages

Redirects in main/docs/quickstart/webapp/fastapi/index.mdx

• [200] https://pip.pypa.io/ | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://pip.pypa.io/ --> https://pip.pypa.io/en/stable/

Redirects in main/docs/quickstart/webapp/fastify/index.mdx

• [200] https://auth0.com/docs/connections/social | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/connections/social --> https://auth0.com/docs/authenticate/identity-providers/social-identity-providers
• [200] https://auth0.com/docs/customize/universal-login-pages | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://auth0.com/docs/customize/universal-login-pages --> https://auth0.com/docs/customize/login-pages

Redirects in main/docs/quickstart/webapp/nuxt/index.mdx

• [200] https://docs.npmjs.com/downloading-and-installing-node-js-and-npm | Redirect: Followed 1 redirect resolving to the final status of: OK. Redirects: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm --> https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/
  Full Github Actions output

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
auth0	🟢 Ready	View Preview	May 12, 2026, 6:44 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[kevlil83]

Closing in favor of a fresh PR with squashed history. New PR link will be posted here.

[kevlil83]

Superseded by #1165 (same content, squashed to a single commit).