🚧 Work in Progress: Kinde Tanstack React Start SDK doc#707
🚧 Work in Progress: Kinde Tanstack React Start SDK doc#707tamalchowdhury wants to merge 6 commits intomainfrom
Conversation
|
Note Reviews pausedIt looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
WalkthroughAdds a new MDX documentation page for the Kinde SDK with TanStack React Start covering setup, env vars, a catch-all auth server route, provider wrapping, client hooks/links, server helpers, route protection, customizable auth paths, debug mode, post-login redirects, and a production checklist. Changes
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~3 minutes Poem
🚥 Pre-merge checks | ✅ 2 | ❌ 1❌ Failed checks (1 inconclusive)
✅ Passed checks (2 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
Deploying kinde-docs-preview with
|
| Latest commit: |
8987d19
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://9322ad0a.kinde-docs-preview.pages.dev |
| Branch Preview URL: | https://yoshify-feat-tanstack-start.kinde-docs-preview.pages.dev |
There was a problem hiding this comment.
Actionable comments posted: 6
🧹 Nitpick comments (1)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx (1)
1-13: Add standard SDK metadata fields for discoverability consistency.Frontmatter is valid, but this page is missing common SDK metadata (
description,sdk,languages,audience,complexity,keywords) used in peer backend SDK docs and search/discovery surfaces.Suggested frontmatter additions
--- page_id: 7eb15b27-864c-49fd-a12e-3f4d415f47fa title: TanStack React Start SDK +description: "Integrate Kinde authentication in TanStack React Start apps with route handlers, middleware, and client route protection." sidebar: order: 10 tableOfContents: maxHeadingLevel: 3 +sdk: + - tanstack +languages: + - typescript + - tsx +audience: + - developers +complexity: intermediate +keywords: + - tanstack react start + - authentication + - middleware head:🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 1 - 13, The frontmatter block (the YAML between the leading '---' markers that contains title: "TanStack React Start SDK" and page_id) is missing standard SDK metadata; add the fields description, sdk, languages, audience, complexity, and keywords to that frontmatter with concise values appropriate for this SDK page (e.g., a short descriptive sentence for description, sdk: "TanStack React", languages: ["TypeScript", "JavaScript"], audience: ["backend developers" or "frontend developers" as appropriate], complexity: ["beginner"|"intermediate"|"advanced"], and a keywords array of relevant terms) so the page matches other backend SDK docs and is discoverable in search surfaces.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 8-12: The OG image in the frontmatter meta tag (property:
"og:image") for tsr-sdk.mdx points to a generic SDK image (SDK_NEXT.png);
replace that URL with the TanStack-specific social card image URL so the meta
head block uses the correct TanStack preview asset (update the head -> meta
attrs content value for property "og:image" accordingly).
- Line 314: The heading "## Kinde Auth data - Server" is empty and should be
completed or removed; either populate that section under the heading with the
intended server-side documentation (e.g., purpose, required env vars, example
code / API endpoints, security considerations, and usage with the TSR SDK) or
delete the header if no content is needed—locate the empty heading "## Kinde
Auth data - Server" in the document and update accordingly.
- Around line 68-70: The code sample contains an embedded review-thread artifact
("Collapse commentComment on line R67DanielRivers commented...") inside the
import block; remove that stray text so the imports are a clean code snippet
(e.g., ensure only the actual import statements like kindeAuthHandler from
"@kinde/kinde-auth-tanstack-start/server" and createFileRoute from
"@tanstack/react-router" remain in the example).
- Line 324: The .env debug-mode example in tsr-sdk.mdx uses invalid syntax
(spaces around '=' and trailing semicolons); update the .env code block (the
debug-mode example / .env example) so each entry uses KEY=value format with no
spaces around '=' and no trailing semicolons (e.g., change "KEY = value;" to
"KEY=value") to ensure valid dotenv parsing.
- Line 25: Replace the placeholder markdown link "[TanStack React Start starter
kit](TODO)" in tsr-sdk.mdx with the actual starter-kit URL (or remove the link
and replace with a correct, non-broken CTA), updating the link target so the CTA
points to the real TanStack React Start starter kit; locate the exact token
"[TanStack React Start starter kit](TODO)" and change the "(TODO)" to the real
href or plain text as appropriate.
- Line 29: Replace the incorrect package and Next.js imports with the React SDK
and TanStack Start patterns: change the PackageManagers pkg value from
"@kinde-oss/kinde-tsr" to "@kinde-oss/kinde-auth-react"; update imports that
currently reference "@kinde-oss/kinde-auth-nextjs/components" (lines around the
imports at or near where components are used) to
"@kinde-oss/kinde-auth-react/components"; wrap the app's root route with
KindeProvider (use the KindeProvider symbol) instead of Next.js provider
patterns; and replace any uses of next/navigation with TanStack Router
navigation utilities (use the TanStack Router navigation API in place of
next/navigation). Ensure all examples and import statements reference
`@kinde-oss/kinde-auth-react` and KindeProvider and remove Next.js-specific APIs.
---
Nitpick comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 1-13: The frontmatter block (the YAML between the leading '---'
markers that contains title: "TanStack React Start SDK" and page_id) is missing
standard SDK metadata; add the fields description, sdk, languages, audience,
complexity, and keywords to that frontmatter with concise values appropriate for
this SDK page (e.g., a short descriptive sentence for description, sdk:
"TanStack React", languages: ["TypeScript", "JavaScript"], audience: ["backend
developers" or "frontend developers" as appropriate], complexity:
["beginner"|"intermediate"|"advanced"], and a keywords array of relevant terms)
so the page matches other backend SDK docs and is discoverable in search
surfaces.
🪄 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
Run ID: 5d853569-e9d7-445c-a95a-8b96f6830d92
📒 Files selected for processing (1)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx
| head: | ||
| - tag: meta | ||
| attrs: | ||
| property: "og:image" | ||
| content: "https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png" |
There was a problem hiding this comment.
Swap placeholder OG image for a TanStack-specific social card.
Current OG image appears to be a placeholder/other-SDK asset (...SDK_NEXT.png), which weakens social preview accuracy for this doc.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 8 -
12, The OG image in the frontmatter meta tag (property: "og:image") for
tsr-sdk.mdx points to a generic SDK image (SDK_NEXT.png); replace that URL with
the TanStack-specific social card image URL so the meta head block uses the
correct TanStack preview asset (update the head -> meta attrs content value for
property "og:image" accordingly).
There was a problem hiding this comment.
Actionable comments posted: 2
♻️ Duplicate comments (2)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx (2)
13-17:⚠️ Potential issue | 🟡 MinorReplace placeholder OG image with the TanStack-specific social card.
The
og:imagestill points toDOCS-SSI-SDK_NEXT.png, which looks like a generic placeholder rather than page-specific social metadata.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 13 - 17, The page frontmatter uses a generic placeholder OG image; update the head meta tag with property "og:image" to point to the TanStack-specific social card URL for this SDK page by replacing the current content value ("https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png") with the correct TanStack card asset; look for the head -> meta entry with property "og:image" in this file and swap the content value to the page-specific TanStack image URL.
74-74:⚠️ Potential issue | 🟠 MajorVerify install package matches all documented import paths.
The page installs
@kinde/tsr(Line 74) while examples import from@kinde/kinde-auth-tanstack-startpackages. Please verify this mapping is intentional and documented; otherwise users may install the wrong package.For Kinde TanStack React Start (as of April 2026), what is the canonical npm package users should install, and are imports from "@kinde/kinde-auth-tanstack-start" expected after installing "@kinde/tsr" (e.g., via alias/re-export)?Also applies to: 100-101, 133-134, 156-157, 207-207, 242-242, 282-282, 314-314
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` at line 74, The PackageManagers entry currently lists pkg="@kinde/tsr" while code examples import from "@kinde/kinde-auth-tanstack-start"; confirm which npm package is canonical (e.g., "@kinde/kinde-auth-tanstack-start" vs "@kinde/tsr") and update the PackageManagers pkg value to the correct package or add a clear note explaining that "@kinde/tsr" intentionally re-exports/aliases the "@kinde/kinde-auth-tanstack-start" modules; apply the same fix to all other occurrences noted (lines near 100-101, 133-134, 156-157, 207, 242, 282, 314) and ensure examples and import paths (references to "@kinde/kinde-auth-tanstack-start") match the documented install command or are documented as coming from an alias/re-export.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 91-95: Update the setup instructions so the file path text and the
shell command match: either change the written filename
`src/routes/api.auth.$.ts` to `src/routes/api.auth.$/route.ts` everywhere, or
change the touch command to create `src/routes/api.auth.$.ts`; ensure the
displayed filename and the example command reference the same path (look for the
strings `src/routes/api.auth.$.ts` and `src/routes/api.auth.$/route.ts` and make
them consistent).
- Around line 63-68: The ordered list in the docs contains duplicate "2."
entries; update the sequence in
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx so the steps read 1.,
2., 3., 4. (i.e., change the second "2." that instructs to add callback URLs to
"3." and change "3. Select Save." to "4.") to restore proper sequential
numbering.
---
Duplicate comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 13-17: The page frontmatter uses a generic placeholder OG image;
update the head meta tag with property "og:image" to point to the
TanStack-specific social card URL for this SDK page by replacing the current
content value
("https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png") with the
correct TanStack card asset; look for the head -> meta entry with property
"og:image" in this file and swap the content value to the page-specific TanStack
image URL.
- Line 74: The PackageManagers entry currently lists pkg="@kinde/tsr" while code
examples import from "@kinde/kinde-auth-tanstack-start"; confirm which npm
package is canonical (e.g., "@kinde/kinde-auth-tanstack-start" vs "@kinde/tsr")
and update the PackageManagers pkg value to the correct package or add a clear
note explaining that "@kinde/tsr" intentionally re-exports/aliases the
"@kinde/kinde-auth-tanstack-start" modules; apply the same fix to all other
occurrences noted (lines near 100-101, 133-134, 156-157, 207, 242, 282, 314) and
ensure examples and import paths (references to
"@kinde/kinde-auth-tanstack-start") match the documented install command or are
documented as coming from an alias/re-export.
🪄 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
Run ID: ec9e096a-6982-4099-9fe9-08ddec3f4895
📒 Files selected for processing (1)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx
There was a problem hiding this comment.
♻️ Duplicate comments (3)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx (3)
102-106:⚠️ Potential issue | 🟠 MajorMake the auth route filename/path consistent in text and command.
Line 102 says
src/routes/api.auth.$.ts, but the command createssrc/routes/api.auth.$/route.ts. This mismatch will cause setup errors for copy/paste users.Suggested fix
-1. Create `src/routes/api.auth.$.ts`: +1. Create `src/routes/api.auth.$/route.ts`:🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 102 - 106, The filename/path in the docs is inconsistent: the text shows src/routes/api.auth.$.ts while the command creates src/routes/api.auth.$/route.ts; update one to match the other so users can copy/paste successfully—either change the text to reference src/routes/api.auth.$/route.ts or change the command to touch "src/routes/api.auth.$.ts" (ensure the documented path in the prose and the command both mention the same target, e.g., src/routes/api.auth.$/route.ts).
16-17:⚠️ Potential issue | 🟡 MinorReplace the placeholder OG image with a TanStack-specific asset.
The current
og:imagestill points to the generic Next SDK card, so social previews for this page will be inaccurate.Suggested fix
- content: "https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png" + content: "https://kinde.com/assets/images/open-graph/<tanstack-specific-og-image>.png"🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 16 - 17, Update the Open Graph image metadata by replacing the current property "og:image" value "https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png" with the TanStack-specific asset URL (the correct TanStack OG image for the TSR SDK page); locate the metadata block where property: "og:image" is set and swap the content string to the TanStack image URL so social previews show the correct card.
65-70:⚠️ Potential issue | 🟡 MinorFix the ordered-list numbering in setup steps.
The sequence repeats
2.at Line 67, which makes the procedure harder to follow.Suggested fix
-2. Add callback URLs, for example: +3. Add callback URLs, for example: ... -3. Select **Save**. +4. Select **Save**.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 65 - 70, The ordered list in the doc snippet has duplicate "2." entries; update the markdown numbering so the steps read 1., 2., 3., 4. (i.e., change the second "2." that begins "Add callback URLs..." to "3." and the subsequent "3." that begins "Select Save." to "4.") to restore correct sequential step numbering.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Duplicate comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 102-106: The filename/path in the docs is inconsistent: the text
shows src/routes/api.auth.$.ts while the command creates
src/routes/api.auth.$/route.ts; update one to match the other so users can
copy/paste successfully—either change the text to reference
src/routes/api.auth.$/route.ts or change the command to touch
"src/routes/api.auth.$.ts" (ensure the documented path in the prose and the
command both mention the same target, e.g., src/routes/api.auth.$/route.ts).
- Around line 16-17: Update the Open Graph image metadata by replacing the
current property "og:image" value
"https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png" with the
TanStack-specific asset URL (the correct TanStack OG image for the TSR SDK
page); locate the metadata block where property: "og:image" is set and swap the
content string to the TanStack image URL so social previews show the correct
card.
- Around line 65-70: The ordered list in the doc snippet has duplicate "2."
entries; update the markdown numbering so the steps read 1., 2., 3., 4. (i.e.,
change the second "2." that begins "Add callback URLs..." to "3." and the
subsequent "3." that begins "Select Save." to "4.") to restore correct
sequential step numbering.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Repository UI
Review profile: CHILL
Plan: Pro
Run ID: 7d295805-93bb-4f44-8a5b-66ddcb653a3e
📒 Files selected for processing (1)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx
There was a problem hiding this comment.
Actionable comments posted: 2
♻️ Duplicate comments (3)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx (3)
13-17:⚠️ Potential issue | 🟡 MinorSwap placeholder OG image for a TanStack-specific social card.
The OG image still uses a Next.js SDK placeholder (
SDK_NEXT.png). Replace with a TanStack-specific asset for accurate social media previews.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 13 - 17, Replace the placeholder Open Graph image in the head frontmatter by updating the meta entry with property "og:image" (found under the head block) to point to the TanStack-specific social card URL instead of "https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png"; locate the head -> tag: meta -> attrs -> content value and swap it for the correct TanStack asset URL so social previews reference the proper image.
76-76:⚠️ Potential issue | 🔴 CriticalRemove or correct the non-existent
@kinde/tsrpackage reference.The package
@kinde/tsris not published on npm and no official Kinde SDK exists for TanStack Start or TanStack Router. The documentation cannot be followed as written. Clarify which Kinde SDK (if any) is intended to be used with TanStack Router/Start, or remove this guide if no integration is currently available.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` at line 76, Replace the non-existent package reference in the PackageManagers component: remove or update the PackageManagers element that currently sets pkg="@kinde/tsr" — either delete that line and any steps that assume an `@kinde/tsr` SDK, or replace pkg with the correct published Kinde package name intended for this guide and update the surrounding text to explain the real integration (or state that no official Kinde SDK exists for TanStack Router/Start and remove the integration instructions).
1062-1062:⚠️ Potential issue | 🔴 CriticalThe GitHub repository
kinde-oss/kinde-tsrdoes not exist.The issues link points to a non-existent repository. Web searches confirm there is no public GitHub repository at
kinde-oss/kinde-tsrand no npm package@kinde/tsr. The closest match iskinde-oss/kinde-typescript-sdk(@kinde-oss/kinde-typescript-sdk), which is Kinde's official TypeScript SDK. Either:
- Update the link and all package references throughout the documentation to use the correct SDK, or
- Clarify which SDK this documentation is actually for.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` at line 1062, The link text "[SDK issues on GitHub]" points to a non-existent repo `kinde-oss/kinde-tsr`; update the documentation to reference the correct SDK (likely `kinde-oss/kinde-typescript-sdk` / npm package `@kinde-oss/kinde-typescript-sdk`) or explicitly state which SDK the doc targets: replace the URL in the "[SDK issues on GitHub]" anchor with the correct GitHub issues URL for `kinde-oss/kinde-typescript-sdk`, and audit other occurrences of `kinde-tsr` or `@kinde/tsr` in this file (and related docs) to change package names and links accordingly or add a clarification note if this docs set is for a different SDK.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Line 63: Replace the Kinde application type text "Back-end application > Other
back end" in src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx with
"Back-end web" so the guidance for TanStack Start matches the Next.js/full‑stack
convention; update the single line containing that exact phrase to read
"Back-end web".
- Around line 429-445: The docs currently say PortalLink is "Re-exported from
`@kinde-oss/kinde-auth-react/components`" while the usage example imports it
from `@kinde/tsr`, which is confusing; update the PortalLink section to be
consistent by either removing the re-export note and documenting PortalLink as
an export of `@kinde/tsr` only (adjust the text around "Re-exported from ..."
and keep the usage/import example as shown) or explicitly explain the re-export
by stating that `@kinde/tsr` re-exports PortalLink from
`@kinde-oss/kinde-auth-react/components` and why users might care, and ensure
the symbol name PortalLink and the import example match that choice.
---
Duplicate comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 13-17: Replace the placeholder Open Graph image in the head
frontmatter by updating the meta entry with property "og:image" (found under the
head block) to point to the TanStack-specific social card URL instead of
"https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png"; locate the
head -> tag: meta -> attrs -> content value and swap it for the correct TanStack
asset URL so social previews reference the proper image.
- Line 76: Replace the non-existent package reference in the PackageManagers
component: remove or update the PackageManagers element that currently sets
pkg="@kinde/tsr" — either delete that line and any steps that assume an
`@kinde/tsr` SDK, or replace pkg with the correct published Kinde package name
intended for this guide and update the surrounding text to explain the real
integration (or state that no official Kinde SDK exists for TanStack
Router/Start and remove the integration instructions).
- Line 1062: The link text "[SDK issues on GitHub]" points to a non-existent
repo `kinde-oss/kinde-tsr`; update the documentation to reference the correct
SDK (likely `kinde-oss/kinde-typescript-sdk` / npm package
`@kinde-oss/kinde-typescript-sdk`) or explicitly state which SDK the doc
targets: replace the URL in the "[SDK issues on GitHub]" anchor with the correct
GitHub issues URL for `kinde-oss/kinde-typescript-sdk`, and audit other
occurrences of `kinde-tsr` or `@kinde/tsr` in this file (and related docs) to
change package names and links accordingly or add a clarification note if this
docs set is for a different SDK.
🪄 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
Run ID: dc18cbd6-79e2-4e37-85c8-e34f51a8d0b9
📒 Files selected for processing (1)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (2)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx (2)
16-17:⚠️ Potential issue | 🟡 MinorUse a TanStack-specific OG image asset for this page.
Line 17 still references the generic/Next-style social image (
DOCS-SSI-SDK_NEXT.png), which weakens social preview relevance for this SDK doc.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 16 - 17, The Open Graph image meta for this page still points to the generic Next-style asset; update the property "og:image" value in tsr-sdk.mdx to use the TanStack-specific social image (replace "https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png" with the TanStack asset URL/name) so social previews reflect the correct SDK branding.
63-70:⚠️ Potential issue | 🟡 MinorFix step numbering and accidental code-block indentation in Quickstart.
Line 65 repeats
2.(after Line 64), and Line 69 is indented like a code block. This makes the setup flow harder to follow in rendered docs.Suggested diff
-2. Go to **View details** and copy the **Domain**, **Client ID** and **Client secret** values. -2. Add callback URLs, for example: +2. Go to **View details** and copy the **Domain**, **Client ID** and **Client secret** values. +3. Add callback URLs, for example: - **Allowed callback URLs** — `http://localhost:3000/api/auth/callback` - **Allowed logout redirect URLs** — `http://localhost:3000` - - For production, add the same paths using your real domain. -3. Select **Save**. + + For production, add the same paths using your real domain. +4. Select **Save**.🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 63 - 70, The Quickstart steps have a duplicated "2." and an accidental indentation before "For production..." which renders it as a code block; renumber the steps sequentially (1–4) so the second "2." becomes "3." and the final "3." becomes "4.", and remove the leading spaces before the "For production, add the same paths using your real domain." line so it is plain paragraph text (refer to the step lines containing "Allowed callback URLs", "Allowed logout redirect URLs" and the "For production..." sentence to locate the content).
🧹 Nitpick comments (1)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx (1)
380-1054: Reduce duplicated API detail and link to canonical references.This section repeats a large amount of method/argument detail inline. Consider keeping concise summaries here and linking to canonical API docs for full argument contracts to avoid drift.
Based on learnings, in MDX API reference docs it is preferred to list arguments briefly and link to detailed docs instead of duplicating full parameter rules/details inline (“document once, reference anywhere”).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx` around lines 380 - 1054, This section duplicates full API method signatures and outputs for many hooks/servers (e.g., useKindeAuth, getPermission, getPermissions, getRoles, getFlag, getClaim, kindeAuthHandler, protect, getUserProfile, isAuthenticated, has, etc.); condense each entry to a one-line purpose + return type and replace the inlined argument/response blocks with a short "See full API" link to the canonical reference (or a single anchor to the detailed API page) so the MDX becomes a concise summary and a single source of truth for full parameter contracts.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 328-330: The example snippet is missing the Link import, so add
the import for the Link component (import { Link } from
"@tanstack/react-router") above the shown JSX so the snippet is copy-paste
ready; ensure the import appears before the <Link
href="proxy.php?url=https%3A%2F%2Fgithub.com.%2Fapi%2Fauth%2Flogin%3Fpost_login_redirect_url%3D%2Fdashboard">Sign in</Link>
example.
---
Duplicate comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 16-17: The Open Graph image meta for this page still points to the
generic Next-style asset; update the property "og:image" value in tsr-sdk.mdx to
use the TanStack-specific social image (replace
"https://kinde.com/assets/images/open-graph/DOCS-SSI-SDK_NEXT.png" with the
TanStack asset URL/name) so social previews reflect the correct SDK branding.
- Around line 63-70: The Quickstart steps have a duplicated "2." and an
accidental indentation before "For production..." which renders it as a code
block; renumber the steps sequentially (1–4) so the second "2." becomes "3." and
the final "3." becomes "4.", and remove the leading spaces before the "For
production, add the same paths using your real domain." line so it is plain
paragraph text (refer to the step lines containing "Allowed callback URLs",
"Allowed logout redirect URLs" and the "For production..." sentence to locate
the content).
---
Nitpick comments:
In `@src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx`:
- Around line 380-1054: This section duplicates full API method signatures and
outputs for many hooks/servers (e.g., useKindeAuth, getPermission,
getPermissions, getRoles, getFlag, getClaim, kindeAuthHandler, protect,
getUserProfile, isAuthenticated, has, etc.); condense each entry to a one-line
purpose + return type and replace the inlined argument/response blocks with a
short "See full API" link to the canonical reference (or a single anchor to the
detailed API page) so the MDX becomes a concise summary and a single source of
truth for full parameter contracts.
🪄 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
Run ID: 393ca7e5-cfb2-49b7-b3f2-25e2992ca3fb
📒 Files selected for processing (1)
src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx
| ```tsx | ||
| <Link href="/api/auth/login?post_login_redirect_url=/dashboard">Sign in</Link> | ||
| ``` |
There was a problem hiding this comment.
Make the dynamic redirect snippet copy-paste complete.
The snippet uses <Link> but does not include its import, so it won’t compile as-is when copied.
Suggested diff
```tsx
+import { Link } from "@tanstack/react-router"
+
<Link href="proxy.php?url=https%3A%2F%2Fgithub.com.%2Fapi%2Fauth%2Flogin%3Fpost_login_redirect_url%3D%2Fdashboard">Sign in</Link></details>
<details>
<summary>🤖 Prompt for AI Agents</summary>
Verify each finding against the current code and only fix it if needed.
In @src/content/docs/developer-tools/sdks/backend/tsr-sdk.mdx around lines 328 -
330, The example snippet is missing the Link import, so add the import for the
Link component (import { Link } from "@tanstack/react-router") above the shown
JSX so the snippet is copy-paste ready; ensure the import appears before the
|
LGTM! |
e63323d to
8987d19
Compare
TODO
[] Create a starter kit to link to.
[] Link to js-utils and describe how its utilities are used for the server
[] Link to kinde-auth-react and describe how its utilities are used for the client
[] Needs its own og image, has Next's as a placeholder
[] Needs to be added to
data/sdkList.tsSummary by CodeRabbit