Skip to content

feat: added kinde provider documentation#401

Open
brettchaldecott wants to merge 3 commits into
kinde-oss:mainfrom
brettchaldecott:feat/react-native-v7/kinde-provider
Open

feat: added kinde provider documentation#401
brettchaldecott wants to merge 3 commits into
kinde-oss:mainfrom
brettchaldecott:feat/react-native-v7/kinde-provider

Conversation

@brettchaldecott
Copy link
Copy Markdown

@brettchaldecott brettchaldecott commented Apr 22, 2025

Description (required)

Added documentation detailing the use of the Kinde Provider

Related issues & labels (optional)

  • Closes #
  • Suggested label:

Summary by CodeRabbit

  • Documentation
    • Improved clarity and formatting across the React Native SDK docs.
    • Enhanced Android and iOS installation guidance, including new Ruby and Bundler setup steps for iOS.
    • Added a dedicated section for the KindeProvider component and useKindeProvider hook (React Native SDK 0.7x) with usage examples and returned values.
    • Standardized code blocks, fixed typography, and cleaned up general tips for build and dependency troubleshooting.

Review Change Stack

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 22, 2025

Warning

Rate limit exceeded

@victoreronmosele has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 39 minutes and 25 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: a99b1230-a335-470b-99a5-b75bbfbcc2c2

📥 Commits

Reviewing files that changed from the base of the PR and between 9543025 and 942a201.

📒 Files selected for processing (1)
  • src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx

Walkthrough

Documentation edits to the React Native SDK page: added iOS Bundler/CocoaPods setup steps, introduced the React Native 0.7x useKindeProvider hook section, and applied multiple formatting and typography corrections across the file.

Changes

React Native SDK docs

Layer / File(s) Summary
Prereqs & environment variables
src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx
Refined "Before you begin", callback URL steps, and .env keys formatting.
iOS: Ruby / Bundler / CocoaPods setup
src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx
Added shell instructions to install/update Bundler, initialize a Gemfile, add CocoaPods, and run pod install via Bundler.
KindeProvider / useKindeProvider (React Native 0.7x)
src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx
Introduced useKindeProvider hook usage example, parameters, and returned values; added a precondition note for sign-up/sign-in samples and formatted related API examples.
Typography, formatting, and build tips
src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx
Multiple small typography/spacing normalizations, sample output/usage formatting, feature flag lines, token storage references, and build issue tips (iOS/Android/Kotlin).

Sequence Diagram(s)

sequenceDiagram
    participant App
    participant useKindeProvider
    participant KindeSDK

    App->>useKindeProvider: Call hook on app initialization
    useKindeProvider->>KindeSDK: Initialize and cache SDK instance
    useKindeProvider->>KindeSDK: Manage session (validate/refresh token)
    useKindeProvider-->>App: Return { isAuthenticated, verifyToken, authSdk }
    App->>useKindeProvider: Use authentication state and SDK client
Loading

Possibly related PRs

  • docs: kinde auth provider #229: Adds documentation for a provider component managing authentication state and token refresh in the Next.js SDK, conceptually similar to the new React Native SDK useKindeProvider hook.

Suggested labels

sdk

Suggested reviewers

  • clairekinde11

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

A rabbit reads the docs at dawn,
A hook hops in and greets the lawn.
Bundler, pods, and tidy lines,
Clearer steps and sample signs.
Docs refreshed — the devs move on. 🐇✨

🚥 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 accurately summarizes the main change: addition of Kinde Provider documentation, which aligns with the primary additions documented in the changeset.
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 unit tests (beta)
  • Create PR with unit tests

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.

@github-actions github-actions Bot added the sdk label Apr 22, 2025
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (5)
src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx (5)

49-51: Refine conversational tone
Consider a more formal phrasing for consistency with technical documentation.

- If you haven't already got a Kinde account, [register for free here](https://app.kinde.com/register) (no credit card required). Registering gives you a Kinde domain, which you need to get started, e.g. `yourapp.kinde.com`.
+ If you don't have a Kinde account, [register for free here](https://app.kinde.com/register) (no credit card required). Registering gives you a Kinde domain, which you need to get started, e.g. `yourapp.kinde.com`.

210-210: Fix duplicated word
The phrase repeats "local" twice.

- Note: The `myapp://myhost.kinde.com/kinde_callback` is used as an example of local local URL Scheme, change to the local local URL Scheme that you use.
+ Note: The `myapp://myhost.kinde.com/kinde_callback` is used as an example of a URL scheme for your app; replace it with your own URL scheme.
🧰 Tools
🪛 LanguageTool

[duplication] ~210-~210: Possible typo: you repeated a word.
Context: ...mple of local URL Scheme, change to the local local URL Scheme that you use. ## Environmen...

(ENGLISH_WORD_REPEAT_RULE)


222-225: Correct verb usage
Use "call back" (verb) instead of "callback" (noun) and consider slight rewording for clarity.

- `KINDE_POST_CALLBACK_URL` - After the user authenticates we will callback to this address. Make sure this URL is under your allowed callback URLs
+ `KINDE_POST_CALLBACK_URL` - After the user authenticates, we will call back to this address. Ensure this URL is listed in your allowed callback URLs.
🧰 Tools
🪛 LanguageTool

[grammar] ~223-~223: The word “callback” is a noun. The verb is spelled with a space.
Context: ... - After the user authenticates we will callback to this address. Make sure this URL is ...

(NOUN_VERB_CONFUSION)


1004-1006: Remove stray Markdown formatting
The _**//**_ markup appears unintended and can be cleaned up.

- await kinde.createOrg({org_name: 'your organization name'}); _**//**_
+ await kinde.createOrg({org_name: 'your organization name'}); // Optionally specify your organization name

1229-1230: Fix article usage
Use "an" before "integer" for grammatical correctness.

- Get a integer flag from the `feature_flags` claim of the access_token.
+ Get an integer flag from the `feature_flags` claim of the access_token.
🧰 Tools
🪛 LanguageTool

[misspelling] ~1230-~1230: Use “an” instead of ‘a’ if the following word starts with a vowel sound, e.g. ‘an article’, ‘an hour’.
Context: ... black ### getIntegerFlag Get a integer flag from the feature_flags c...

(EN_A_VS_AN)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2003b3e and 9ec3de2.

📒 Files selected for processing (1)
  • src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx (27 hunks)
🧰 Additional context used
🪛 LanguageTool
src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx

[duplication] ~210-~210: Possible typo: you repeated a word.
Context: ...mple of local URL Scheme, change to the local local URL Scheme that you use. ## Environmen...

(ENGLISH_WORD_REPEAT_RULE)


[grammar] ~223-~223: The word “callback” is a noun. The verb is spelled with a space.
Context: ... - After the user authenticates we will callback to this address. Make sure this URL is ...

(NOUN_VERB_CONFUSION)


[misspelling] ~1230-~1230: Use “an” instead of ‘a’ if the following word starts with a vowel sound, e.g. ‘an article’, ‘an hour’.
Context: ... black ### getIntegerFlag Get a integer flag from the feature_flags c...

(EN_A_VS_AN)

🔇 Additional comments (14)
src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx (14)

77-77: Confirm consistency in step numbering
The Android build.gradle step aligns with the existing style.


96-96: Confirm consistency in step numbering
The MainApplication.java step follows the same pattern and is clear.


150-169: Approve Ruby & Bundler setup instructions
The new "Shell setup" section clearly guides users through installing Bundler and running CocoaPods via Bundler.


183-188: Approve Podfile update instructions
The added snippet for integrating RNKeychain and RNInAppBrowser via CocoaPods is clear and accurate.


191-194: Approve manual Xcode linking instructions
The bulleted steps for manually linking packages in Xcode are concise and complete.


201-203: Approve Kinde configuration steps
The numbered list for navigating to Settings > Applications is clear and properly formatted.


205-206: Approve callback URLs bullets
The examples for allowed callback and logout redirect URLs are correctly formatted.


318-320: Approve KindeProvider section header
The new section title clearly introduces the KindeProvider feature for React Native 0.7x.


322-326: Approve import usage example
The code snippet importing useKindeProvider is concise and correct.


328-330: Approve hook description
The explanation of what useKindeProvider does is clear and well-placed.


333-339: Approve usage example
The TypeScript example demonstrates proper hook usage with required parameters.


341-345: Approve return values list
The list of returned values from the hook is accurate and formatted consistently.


347-351: Approve benefits list
The bulleted list effectively highlights the advantages of using KindeProvider.


369-369: Approve note about SDK initialization
The reminder to define KindeSDK as a client variable is helpful and well-placed.

@victoreronmosele
Copy link
Copy Markdown
Member

This looks good and can be merged in @onderay

Comment thread src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx Outdated
Comment thread src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx Outdated
Comment thread src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx Outdated
@tamalchowdhury
Copy link
Copy Markdown
Collaborator

@brettchaldecott, kindly create your PR directly to the main repo from now on, so that it will generate a preview with Cloudflare, and we can also directly open and edit it within our local machine and perform minor edits.

Sincerely,

Comment thread src/content/docs/developer-tools/sdks/native/react-native-sdk.mdx Outdated
@tamalchowdhury
Copy link
Copy Markdown
Collaborator

@victoreronmosele what is the status of this PR? can you take a look at the merge conflicts?

@victoreronmosele
Copy link
Copy Markdown
Member

Hi @tamalchowdhury, sorry I missed this comment.

I'll implement the fixes and resolve the merge conflicts.

@victoreronmosele victoreronmosele self-assigned this May 14, 2026
@gitguardian
Copy link
Copy Markdown

gitguardian Bot commented May 14, 2026

⚠️ GitGuardian has uncovered 1 secret following the scan of your pull request.

Please consider investigating the findings and remediating the incidents. Failure to do so may lead to compromising the associated services or software components.

Since your pull request originates from a forked repository, GitGuardian is not able to associate the secrets uncovered with secret incidents on your GitGuardian dashboard.
Skipping this check run and merging your pull request will create secret incidents on your GitGuardian dashboard.

🔎 Detected hardcoded secret in your pull request
GitGuardian id GitGuardian status Secret Commit Filename
21029323 Triggered Generic High Entropy Secret 9543025 scripts/generate-llms-txt-sections.js View secret
🛠 Guidelines to remediate hardcoded secrets
  1. Understand the implications of revoking this secret by investigating where it is used in your code.
  2. Replace and store your secret safely. Learn here the best practices.
  3. Revoke and rotate this secret.
  4. If possible, rewrite git history. Rewriting git history is not a trivial act. You might completely break other contributing developers' workflow and you risk accidentally deleting legitimate data.

To avoid such incidents in the future consider


🦉 GitGuardian detects secrets in your source code to help developers and security teams secure the modern development process. You are seeing this because you or someone else with access to this repository has authorized GitGuardian to scan your pull request.

@victoreronmosele
Copy link
Copy Markdown
Member

victoreronmosele commented May 14, 2026

@tamalchowdhury I have implemented the relevant fixes and resolved the merge conflicts.

Copy link
Copy Markdown
Collaborator

@tamalchowdhury tamalchowdhury left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

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.

4 participants