update: document SvelteKit redirect URL and password reset email customization limit (gap report) by tamalchowdhury · Pull Request #706 · kinde-oss/documentation

tamalchowdhury · 2026-04-07T12:00:58Z

This PR documents two limitations in Kinde:

SvelteKit uses one static KINDE_REDIRECT_URL (no built-in dynamic/multi-tenant callbacks; links to wildcards and “without an SDK” for alternatives).

Password reset mail can’t be fully custom HTML -only what the auth email templates allow. It also tightens email-content headings/asides and bumps frontmatter (TOC depth, dates).

Summary by CodeRabbit

Documentation
- Clarified email customization docs by cleaning up headings, updating verification-note formatting, and adding an FAQ about limits for password-reset email custom HTML while confirming subject/body/disclaimers/placeholders stay customizable.
- Improved SvelteKit SDK docs with added table of contents configuration and new guidance on dynamic callback URLs, including when to use a manual authorization code flow.

…(gap report) Made-with: Cursor

coderabbitai · 2026-04-07T12:01:15Z

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: f29b33f1-989f-4f2d-9dbc-b7168160d2be

📥 Commits

Reviewing files that changed from the base of the PR and between e658752 and 354c01d.

📒 Files selected for processing (2)

src/content/docs/design/content-customization/email-content.mdx
src/content/docs/developer-tools/sdks/backend/sveltekit-sdk.mdx

🚧 Files skipped from review as they are similar to previous changes (2)

src/content/docs/design/content-customization/email-content.mdx
src/content/docs/developer-tools/sdks/backend/sveltekit-sdk.mdx

Walkthrough

Documentation updates refresh email customization guidance and SvelteKit SDK callback URL guidance, add page navigation configuration, clarify password reset template limits, reformat headings and notes, and update metadata dates.

Changes

Documentation guidance

Layer / File(s)	Summary
Email customization guidance `src/content/docs/design/content-customization/email-content.mdx`	Updated headings and note formatting, added a password reset HTML FAQ, and refreshed the metadata date to `2026-04-07`.
SvelteKit callback documentation `src/content/docs/developer-tools/sdks/backend/sveltekit-sdk.mdx`	Added table-of-contents configuration, documented static `KINDE_REDIRECT_URL` behavior and dynamic callback alternatives, and refreshed the metadata date to `2026-04-08`.

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

Possibly related PRs

kinde-oss/documentation#756: Related SDK and callback URL documentation changes.

Suggested labels: Update doc

Suggested reviewers: onderay

Poem

🐰 I hopped through docs and cleared the way,
With FAQs and callback notes today.
Bold marks softened, headings bright,
TOCs guide readers left and right,
Clean pages now can greet the light. 🥕

🚥 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 matches the main documentation changes about SvelteKit redirect URLs and password reset email customization limits.
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/update/sveltekit-redirect-uri-and-password-reset-email-limits

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-04-07T12:01:31Z

Deploying kinde-docs-preview with Cloudflare Pages

Latest commit:	`354c01d`
Status:	✅ Deploy successful!
Preview URL:	https://629b6d4c.kinde-docs-preview.pages.dev
Branch Preview URL:	https://tamal-update-sveltekit-redir.kinde-docs-preview.pages.dev

View logs

onderay · 2026-04-08T05:20:22Z


 Kinde comes with a production environment, but you can set up other environments if you want to. Each environment has a unique subdomain so be sure to use the correct one in the **Configure your app section** which follows.

+### Using dynamic callback URLs


@tamalchowdhury why no mention https://docs.kinde.com/get-started/connect/callback-urls/#wildcards-in-callback-urls

Updated this paragraph with link to wildcards.

onderay · 2026-04-08T05:21:08Z

 3. In the subject line field, include the `${code}` placeholder. This is where the code will appear. E.g. Enter `${code}` for access.
 4. Select **Save**.
+
+## Can password reset emails use fully custom HTML?


@tamalchowdhury point here https://docs.kinde.com/design/content-customization/email-content/

Hi Andre, we are already in this page.

onderay

A few comments

pesickaa

Looks good, but if you could respond to comments so that they can be re-reviewed that'd be great. I see the one about wildcards was implemented but it didn't get updated as outdated for some reason.

Just tag the reviewer saying you've implemented the fix and they can resolve it if they're happy with it.

Once the other comment is addressed, I'm happy to review and approve.

dtoxvanilla1991

Good work. 2 notes 📓

tamalchowdhury

added the required notes.

tamalchowdhury · 2026-04-08T07:41:25Z

 3. In the subject line field, include the `${code}` placeholder. This is where the code will appear. E.g. Enter `${code}` for access.
 4. Select **Save**.
+
+## Can password reset emails use fully custom HTML?


Hi Andre, we are already in this page.

tamalchowdhury · 2026-04-08T08:12:45Z


 Kinde comes with a production environment, but you can set up other environments if you want to. Each environment has a unique subdomain so be sure to use the correct one in the **Configure your app section** which follows.

+### Using dynamic callback URLs


Updated this paragraph with link to wildcards.

dtoxvanilla1991

LGTM

fix: document SvelteKit redirect URL and password reset email limits …

d7e7ef1

…(gap report) Made-with: Cursor

tamalchowdhury requested a review from a team as a code owner April 7, 2026 12:00

github-actions Bot added the sdk label Apr 7, 2026

onderay reviewed Apr 8, 2026

View reviewed changes

onderay requested changes Apr 8, 2026

View reviewed changes

tamalchowdhury changed the title ~~⚠️ fix: document SvelteKit redirect URL and password reset email customization limit (gap report)~~ fix: document SvelteKit redirect URL and password reset email customization limit (gap report) Apr 8, 2026

updates the dynamic callback section

e658752

tamalchowdhury requested a review from onderay April 8, 2026 08:12

onderay assigned tamalchowdhury Jul 8, 2026

tamalchowdhury changed the title ~~fix: document SvelteKit redirect URL and password reset email customization limit (gap report)~~ update: document SvelteKit redirect URL and password reset email customization limit (gap report) Jul 8, 2026

pesickaa reviewed Jul 28, 2026

View reviewed changes

dtoxvanilla1991 reviewed Jul 28, 2026

View reviewed changes

Comment thread src/content/docs/design/content-customization/email-content.mdx

Comment thread src/content/docs/developer-tools/sdks/backend/sveltekit-sdk.mdx

address the notes in both pages per review

354c01d

tamalchowdhury commented Jul 29, 2026

View reviewed changes

pesickaa requested a review from dtoxvanilla1991 July 30, 2026 11:03

pesickaa approved these changes Jul 30, 2026

View reviewed changes

dtoxvanilla1991 approved these changes Aug 6, 2026

View reviewed changes

onderay approved these changes Sep 1, 2026

View reviewed changes


		Kinde comes with a production environment, but you can set up other environments if you want to. Each environment has a unique subdomain so be sure to use the correct one in the Configure your app section which follows.

		### Using dynamic callback URLs

Uh oh!

Conversation

tamalchowdhury commented Apr 7, 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 Apr 7, 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 Apr 7, 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!

onderay Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

tamalchowdhury Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

onderay Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

tamalchowdhury Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

onderay left a comment

Choose a reason for hiding this comment

Uh oh!

pesickaa left a comment

Choose a reason for hiding this comment

Uh oh!

dtoxvanilla1991 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

tamalchowdhury left a comment

Choose a reason for hiding this comment

Uh oh!

tamalchowdhury Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

tamalchowdhury Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

dtoxvanilla1991 left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

tamalchowdhury commented Apr 7, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Apr 7, 2026 •

edited

Loading

cloudflare-workers-and-pages Bot commented Apr 7, 2026 •

edited

Loading