Skip to content

update: Applications in Kinde#750

Open
tamalchowdhury wants to merge 6 commits into
mainfrom
tamal/update/applications-in-kinde
Open

update: Applications in Kinde#750
tamalchowdhury wants to merge 6 commits into
mainfrom
tamal/update/applications-in-kinde

Conversation

@tamalchowdhury

@tamalchowdhury tamalchowdhury commented Jun 10, 2026

Copy link
Copy Markdown
Collaborator

This PR makes a significant update to the Applications overview page. It merges two pages and adds a redirect to the config.

  • Updates the doc with the missing Device and IoT application type.
  • Adds application management steps, and configuration steps.
  • Adds a FAQ section.

Summary by CodeRabbit

  • Documentation
    • Clarified device authorization flow polling duration to 10 minutes instead of 30 minutes
    • Reorganized and expanded applications documentation with detailed setup and management guidance
    • Added Device and IoT application type documentation including OAuth 2.0 Device Authorization Grant support
    • Updated internal documentation links for navigation consistency

@tamalchowdhury tamalchowdhury requested a review from a team as a code owner June 10, 2026 15:08
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 10, 2026

Copy link
Copy Markdown

Deploying kinde-docs-preview with  Cloudflare Pages  Cloudflare Pages

Latest commit: 13e6c5d
Status: ✅  Deploy successful!
Preview URL: https://4954794d.kinde-docs-preview.pages.dev
Branch Preview URL: https://tamal-update-applications-in.kinde-docs-preview.pages.dev

View logs

@coderabbitai

coderabbitai Bot commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: a4069f8f-2f43-4e57-ad54-d0c5bbc30b23

📥 Commits

Reviewing files that changed from the base of the PR and between ce23c5a and 13e6c5d.

📒 Files selected for processing (16)
  • astro.config.mjs
  • src/content/docs/authenticate/device-authorization-flow/overview.mdx
  • src/content/docs/authenticate/device-authorization-flow/troubleshooting.mdx
  • src/content/docs/authenticate/manage-authentication/manage-authentication-applications.mdx
  • src/content/docs/build/applications/about-applications.mdx
  • src/content/docs/build/applications/add-and-manage-applications.mdx
  • src/content/docs/build/applications/rotate-client-secret.mdx
  • src/content/docs/design/brand/link-to-homepage.mdx
  • src/content/docs/developer-tools/guides/deploy-on-vercel.mdx
  • src/content/docs/developer-tools/sdks/backend/remix-sdk.mdx
  • src/content/docs/get-started/connect/callback-urls.mdx
  • src/content/docs/get-started/connect/getting-app-keys.mdx
  • src/content/docs/get-started/guides/byo-code.mdx
  • src/content/docs/get-started/guides/start-with-starter-kit.mdx
  • src/content/docs/get-started/switch-to-kinde/auth0-to-kinde.mdx
  • src/content/docs/integrate/third-party-tools/cloudflare-zero-trust.mdx
💤 Files with no reviewable changes (1)
  • src/content/docs/build/applications/add-and-manage-applications.mdx

Walkthrough

This PR consolidates application documentation by expanding about-applications.mdx with complete app type guidance, Device/IoT flow details, and management instructions, while removing the separate add-and-manage-applications page. Device authorization polling is corrected to 10 minutes. Configuration and cross-document links are updated to point to the new consolidated guide.

Changes

Device flow timing and documentation consolidation

Layer / File(s) Summary
Device authorization flow timing updates
src/content/docs/authenticate/device-authorization-flow/overview.mdx, src/content/docs/authenticate/device-authorization-flow/troubleshooting.mdx
Device code expiration documented as typically 10 minutes instead of 30 minutes in polling guidance and error troubleshooting.
URL redirect configuration
astro.config.mjs
Astro config adds redirect mapping from /build/applications/add-and-manage-applications/ to /build/applications/about-applications/.
Application documentation expansion and consolidation
src/content/docs/build/applications/about-applications.mdx, src/content/docs/build/applications/add-and-manage-applications.mdx
About-applications.mdx frontmatter updated and body expanded with application type overview (Back-end, Front-end, M2M, Device/IoT), Device/IoT section documenting RFC 8628 Device Authorization Grant with polling behavior, new "Manage applications" walkthrough covering add/configure/delete steps, expanded FAQs, and Resources section. Add-and-manage-applications.mdx content fully removed.
Cross-document link migrations
src/content/docs/authenticate/manage-authentication/manage-authentication-applications.mdx, src/content/docs/developer-tools/guides/deploy-on-vercel.mdx, src/content/docs/developer-tools/sdks/backend/remix-sdk.mdx, src/content/docs/get-started/guides/byo-code.mdx, src/content/docs/get-started/guides/start-with-starter-kit.mdx, src/content/docs/get-started/switch-to-kinde/auth0-to-kinde.mdx, src/content/docs/integrate/third-party-tools/cloudflare-zero-trust.mdx
Links across guides, SDKs, and comparative docs updated to redirect users from the removed add-and-manage-applications page to the expanded about-applications page.
Related articles metadata updates
src/content/docs/build/applications/rotate-client-secret.mdx, src/content/docs/design/brand/link-to-homepage.mdx, src/content/docs/get-started/connect/callback-urls.mdx, src/content/docs/get-started/connect/getting-app-keys.mdx
Related article UUID references updated in frontmatter across multiple documentation pages.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Suggested reviewers

  • onderay

Poem

🐰 A consolidation tale, so fair and bright,
Application docs merged into unified light,
Device flows timed true, ten minutes elapsed,
Old paths redirected, fresh guidance clasped,
One guide now holds what two once knew! 📚✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'update: Applications in Kinde' is vague and overly generic; it uses non-descriptive language that doesn't convey the specific nature of the changes (merging docs, adding Device/IoT type, adding management steps/FAQs, or restructuring content). Consider a more specific title that highlights the main change, such as 'Merge application pages and add Device/IoT documentation' or 'Consolidate application guides and add missing app types'.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch tamal/update/applications-in-kinde

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@shafaladhikari

Copy link
Copy Markdown

Thanks for this — the merge of the two application pages and the new Device & IoT section are solid improvements. A few things to address before merge:

Must fix

1. Stale relatedArticles metadata

about-applications.mdx still references the deleted page's page_id (6c70b7ae-1b1b-43bb-bea1-9b3ec88dd082). That ID is also referenced on other pages (callback-urls, getting-app-keys, rotate-client-secret, link-to-homepage, etc.). Can we remove or replace it so related articles don't point at a removed doc?

2. expires_in timing

The Device & IoT section says to stop polling after expires_in "(typically 30 minutes)", but the device authorization overview example shows "expires_in": 600 (10 minutes). Can we confirm the actual default and align both docs?

3. astro.config.mjs formatting noise

The diff reformats a large number of existing redirects (quote style, single-line vs multi-line). Could we revert the formatting-only changes and keep just the new redirect?

"/build/applications/add-and-manage-applications/": "/build/applications/about-applications/",

That would make this much easier to review and reduce merge conflict risk.

4. Internal links still point to the old URL

These 7 pages still link to /build/applications/add-and-manage-applications/ (redirect works, but canonical links would be better):

  • get-started/guides/byo-code.mdx
  • get-started/guides/start-with-starter-kit.mdx
  • get-started/switch-to-kinde/auth0-to-kinde.mdx
  • authenticate/manage-authentication/manage-authentication-applications.mdx
  • integrate/third-party-tools/cloudflare-zero-trust.mdx
  • developer-tools/sdks/backend/remix-sdk.mdx
  • developer-tools/guides/deploy-on-vercel.mdx (uses absolute URL)

5. Stale frontmatter description

description still only mentions backend, frontend, and M2M, while ai_summary and keywords were updated. Worth aligning for SEO/snippets.

6. Missing app_context

The deleted page had app_context: settings > applications. If in-app doc linking depends on that, consider adding it to the merged page.

Nits

  • Missing trailing newline at EOF in about-applications.mdx

Overall direction looks good — happy to approve once the metadata and config noise are cleaned up.

@github-actions github-actions Bot added the sdk label Jun 13, 2026
@tamalchowdhury

Copy link
Copy Markdown
Collaborator Author

All implemented @shafaladhikari

@shafaladhikari

Copy link
Copy Markdown

Re-reviewed latest commit. All feedback has been addressed. ✅

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants