new doc: configure authentication flows by tamalchowdhury · Pull Request #770 · kinde-oss/documentation

tamalchowdhury · 2026-07-20T12:22:14Z

This PR adds a new page to explain users how they can change auth flows without having to redeploy their apps.

Summary by CodeRabbit

Documentation
- Added a guide for configuring authentication flows without redeploying, covering dashboard settings, custom pages, branding, workflows, and deployment requirements.
- Added links between authentication and workflow documentation to help readers discover related configuration guidance.
- Reordered authentication topics in the sidebar and updated related metadata, keywords, and article dates.

coderabbitai · 2026-07-20T12:23:51Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c87a7653-f90b-4ccd-a0bb-8bc2f9fc9aaf

📥 Commits

Reviewing files that changed from the base of the PR and between b3a11fb and f7bca66.

📒 Files selected for processing (1)

src/content/docs/authenticate/about-auth/configure-authentication-flows.mdx

Walkthrough

Adds a guide for configuring Kinde authentication flows. Updates authentication article sidebar ordering. Links the guide from authentication and workflow documentation.

Changes

Authentication documentation

Layer / File(s)	Summary
Authentication flow configuration guide `src/content/docs/authenticate/about-auth/configure-authentication-flows.mdx`	Adds guidance for custom configurations, custom pages, branding, workflows, and selecting an approach.
Authentication sidebar ordering `src/content/docs/authenticate/about-auth/*.mdx`	Updates sidebar ordering metadata for authentication articles.
Related documentation links `src/content/docs/authenticate/about-auth/about-authentication.mdx`, `src/content/docs/workflows/about-workflows/index.mdx`	Adds related-article references, metadata, and links to the new configuration guide.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

kinde-oss/documentation#772: Covers related documentation for configuring Kinde-hosted authentication pages and branding without redeploying.

Suggested labels: Update doc

Suggested reviewers: danielrivers, onderay

Poem

A rabbit maps each sign-in way,
With guides for night and guide for day.
Pages, settings, workflows align,
And sidebar links now clearly shine.
Configure flows with steps in view—
New documentation hops to you.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the main change: a new document about configuring authentication flows.
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch tamal/feat/configure-auth-flows

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.}

cloudflare-workers-and-pages · 2026-07-20T12:24:38Z

Deploying kinde-docs-preview with Cloudflare Pages

Latest commit:	`f7bca66`
Status:	✅ Deploy successful!
Preview URL:	https://220a6fd9.kinde-docs-preview.pages.dev
Branch Preview URL:	https://tamal-feat-configure-auth-fl.kinde-docs-preview.pages.dev

View logs

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/content/docs/authenticate/about-auth/configure-authentication-flows.mdx`:
- Around line 77-84: Clarify the deployment timing in the authentication-flow
documentation: distinguish self-hosted sign-up/sign-in screens, which require
deploying the customer’s product after changes, from Kinde-hosted page
customization, which takes effect immediately without redeployment. Update the
nearby Aside text while preserving the existing flow descriptions and links.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 48c317b0-5f50-4ae6-8630-b427851de40a

📥 Commits

Reviewing files that changed from the base of the PR and between 886d14b and 977afdc.

📒 Files selected for processing (8)

src/content/docs/authenticate/about-auth/about-authentication.mdx
src/content/docs/authenticate/about-auth/authentication-faq.mdx
src/content/docs/authenticate/about-auth/authentication-methods.mdx
src/content/docs/authenticate/about-auth/configure-authentication-flows.mdx
src/content/docs/authenticate/about-auth/identity-and-verification.mdx
src/content/docs/authenticate/about-auth/kinde-authentication-faq.mdx
src/content/docs/authenticate/about-auth/user-communication.mdx
src/content/docs/workflows/about-workflows/index.mdx

pesickaa

There's a code rabbit suggestion, which may be useful to implement. Otherwise, this is fairly clear. Good job.

pesickaa · 2026-07-30T11:02:04Z

@coderabbitai re-review

coderabbitai · 2026-07-30T11:02:16Z

@pesickaa: Re-reviewing the latest changes now.

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

dtoxvanilla1991

Content-only change, no app code touched. New "Configure your authentication flows" page ties together custom configs, custom pages, and workflows with clear cross-links - sidebar ordering across the about-auth section is clean (1–7, no gaps). All relatedArticles UUIDs checked against real page_ids, all resolve.

LGTM.

onderay · 2026-08-05T11:59:43Z

+These change the presentation of the flow. Secure verification steps still run in Kinde.
+
+<Aside>
+Changes to Kinde-hosted branding and page settings take effect immediately, with no application redeploy required. Changes to pages hosted in your product require deploying that product.


@tamalchowdhury given that you are trying to cover off 3 different ways, this line doesn't clearly diffreniate between them

updated the comment!

add new page, configure auth flows

0c20796

tamalchowdhury requested a review from a team as a code owner July 20, 2026 12:22

tamalchowdhury added the New doc label Jul 20, 2026

add custom branding option in the flows

977afdc

coderabbitai Bot reviewed Jul 28, 2026

View reviewed changes

Comment thread src/content/docs/authenticate/about-auth/configure-authentication-flows.mdx

pesickaa approved these changes Jul 28, 2026

View reviewed changes

coderabbitai Bot mentioned this pull request Jul 28, 2026

update: Workflow about and quickstart page update #774

Open

distinguished self-hosted pages from Kinde-hosted changes

b3a11fb

dtoxvanilla1991 approved these changes Aug 1, 2026

View reviewed changes

onderay reviewed Aug 5, 2026

View reviewed changes

update the aside wording to cover 3 ways

f7bca66

tamalchowdhury requested a review from onderay August 15, 2026 12:59

coderabbitai Bot mentioned this pull request Aug 18, 2026

update: Custom sign-up, sign-in page #793

Open

Navigation Menu

Uh oh!

new doc: configure authentication flows - #770

new doc: configure authentication flows#770
tamalchowdhury wants to merge 4 commits into
mainfrom
tamal/feat/configure-auth-flows

tamalchowdhury commented Jul 20, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Jul 20, 2026 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages Bot commented Jul 20, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot left a comment

Uh oh!

Uh oh!

pesickaa left a comment

Uh oh!

pesickaa commented Jul 30, 2026

Uh oh!

coderabbitai Bot commented Jul 30, 2026 •

edited

Loading

Uh oh!

dtoxvanilla1991 left a comment

Uh oh!

onderay Aug 5, 2026

Uh oh!

tamalchowdhury Aug 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

tamalchowdhury commented Jul 20, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Jul 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Uh oh!

cloudflare-workers-and-pages Bot commented Jul 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying kinde-docs-preview with Cloudflare Pages

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

pesickaa left a comment

Choose a reason for hiding this comment

Uh oh!

pesickaa commented Jul 30, 2026

Uh oh!

coderabbitai Bot commented Jul 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dtoxvanilla1991 left a comment

Choose a reason for hiding this comment

Uh oh!

onderay Aug 5, 2026

Choose a reason for hiding this comment

Uh oh!

tamalchowdhury Aug 6, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

tamalchowdhury commented Jul 20, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Jul 20, 2026 •

edited

Loading

cloudflare-workers-and-pages Bot commented Jul 20, 2026 •

edited

Loading

coderabbitai Bot commented Jul 30, 2026 •

edited

Loading