Skip to content

Conversation

@madhavanmalolan
Copy link
Contributor

@madhavanmalolan madhavanmalolan commented May 16, 2025

Description

Testing (ignore for documentation update)

Type of change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update

Checklist:

Additional Notes:

Summary by CodeRabbit

  • New Features

    • Added comprehensive usage and installation guides for Android Kotlin, iOS Swift, Ionic Capacitor, React Native, Flutter, and Web SDKs.
    • Introduced new documentation for verification options and backend verification flows.
    • Added API key acquisition guide and expanded metadata files for improved navigation.
  • Documentation

    • Significantly restructured and expanded documentation across all platforms, providing clearer integration instructions, usage examples, and troubleshooting.
    • Streamlined and condensed several installation and overview guides for simplicity and clarity.
    • Removed outdated or redundant best practices, examples, and hackathon-related documentation.
    • Updated and reorganized metadata files to reflect the new documentation structure.
  • Refactor

    • Simplified and reorganized documentation content, focusing on practical integration steps and essential information.
    • Updated references and links to direct users to the most relevant and current guides.

madhavanmalolan and others added 10 commits May 16, 2025 03:24
…tion (#49)

* Add [WIP] introduction, backend verification docs to the inapp/ documentation

* Add documentation for verification options and backend verification

* Remove packageManager field from package.json
@vercel
Copy link

vercel bot commented May 16, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs ❌ Failed (Inspect) May 16, 2025 4:43pm

@coderabbitai
Copy link

coderabbitai bot commented May 16, 2025

Warning

Rate limit exceeded

@madhavanmalolan has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 11 minutes and 47 seconds before requesting another review.

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

📥 Commits

Reviewing files that changed from the base of the PR and between 8c2705f and ea0e7e0.

📒 Files selected for processing (2)
  • content/docs/flutter/meta.json (1 hunks)
  • content/docs/ionic/installation.mdx (1 hunks)

Walkthrough

This update restructures and streamlines the documentation for the Reclaim Protocol SDKs. It introduces new, platform-specific installation and usage guides for Android, iOS, Flutter, React Native, Ionic, and Web SDKs, while removing older, example-heavy, and best-practice documents. Metadata files are updated or added to reflect the new documentation organization. The main documentation index and several guides are rewritten for clarity and conciseness, with improved separation between installation, usage, and advanced options. Several redirects and references are also updated or removed accordingly.

Changes

File(s) Change Summary
.../advance-options/advance-options.mdx, .../backend/best-practices.mdx, .../hackathon/, .../js/, .../react-native/basic-example.mdx, .../react-native/best-practices.mdx, .../react-native/fullstack-example.mdx, .../react-native/index.mdx, .../flutter/best-practices.mdx, .../flutter/flutter-example.mdx, .../flutter/fullstack-example.mdx, .../flutter/index.mdx Removed detailed best-practice, example, and overview documentation for backend, hackathon, JS, React Native, and Flutter SDKs.
.../advance-options/js-injections/verification-options.mdx, .../advance-options/verification-options.mdx Added new documentation pages describing verification options API for SDKs, listing configurable properties and their types.
.../advance-options/verification.mdx Added a new backend verification guide with step-by-step instructions, code samples, and multi-platform client integration.
.../ai-agent/meta.json Changed the documentation section title from "AI Agent" to "A2A & MCP".
.../android-kotlin/installation.mdx, .../android-kotlin/meta.json, .../android-kotlin/usage.mdx Added new Android SDK documentation section with installation and usage guides, and corresponding metadata file.
.../api-key.mdx Added a new guide for obtaining API keys and setting up credentials for SDK integration.
.../backend/meta.json Deleted backend documentation metadata file.
.../flutter/installation.mdx, .../flutter/meta.json, .../flutter/usage.mdx Rewrote and expanded Flutter installation guide, added a new usage guide, and updated metadata to reflect new structure.
.../index.mdx Rewrote the main documentation index, streamlining the overview, use cases, and resource links, and removing technical and security framework sections.
.../inapp-sdks/meta.json Deleted InApp SDKs documentation metadata file.
.../ionic/installation.mdx, .../ionic/meta.json, .../ionic/usage.mdx Simplified and restructured Ionic SDK documentation, added new usage guide and metadata file.
.../ios-swift/installation.mdx, .../ios-swift/meta.json, .../ios-swift/usage.mdx Simplified iOS installation guide, added new usage guide, and introduced metadata file.
.../meta.json Restructured the documentation page list, removing old sections (e.g., js, backend, hackathon) and adding new ones (e.g., api-key, android-kotlin, ios-swift, ionic, web).
.../onchain/index.mdx Updated Onchain SDKs documentation to focus on Solidity/EVM integration, removing NodeJs, React, and React Native integration cards.
.../react-native/installation.mdx, .../react-native/meta.json, .../react-native/usage.mdx Expanded and restructured React Native installation guide, added new usage guide, and updated metadata to reflect new structure.
.../web/backend/installation.mdx, .../web/backend/meta.json, .../web/backend/usage.mdx Streamlined backend installation and usage guides, added metadata file, improved code examples for configurability and local deployment.
.../web/frontend/fullstack.mdx, .../web/frontend/index.mdx, .../web/frontend/installation.mdx, .../web/frontend/meta.json, .../web/frontend/quickstart.mdx Added new frontend quickstart and fullstack usage guides, streamlined installation instructions, and introduced metadata for frontend documentation.
.../web/index.mdx, .../web/meta.json Added new Web SDK overview and metadata files.
next.config.mjs Removed two redirect rules related to legacy JS documentation paths.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant DocsSite
    participant PlatformGuide
    participant APIKeyGuide

    User->>DocsSite: Access documentation homepage
    DocsSite->>User: Display streamlined overview and use cases
    User->>DocsSite: Select platform (e.g., Android, iOS, Flutter, RN, Web)
    DocsSite->>PlatformGuide: Route to platform-specific installation/usage guide
    PlatformGuide->>User: Show step-by-step integration instructions
    User->>APIKeyGuide: Follow link to get API key
    APIKeyGuide->>User: Guide through API key and provider setup
    User->>PlatformGuide: Return to complete integration with credentials
Loading

Poem

In the warren of docs, we’ve swept and we’ve pruned,
Old guides and examples have gently been tuned.
New pages now sparkle for Android and Swift,
And Web, Ionic, and Flutter get a lift.
Hop to your platform, the path’s clear and bright—
With fresh guides and carrots, your build will take flight!
🥕✨


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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@CLAassistant
Copy link

CLAassistant commented May 16, 2025

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
2 out of 3 committers have signed the CLA.

✅ predatorx7
✅ Kushal7788
❌ madhavanmalolan


madhavanmalolan seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

Copy link

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

Caution

Inline review comments failed to post. This is likely due to GitHub's limits when posting large numbers of comments. If you are seeing this consistently it is likely a permissions issue. Please check "Moderation" -> "Code review limits" under your organization settings.

Actionable comments posted: 10

🔭 Outside diff range comments (1)
content/docs/advance-options/verification-options.mdx (1)

1-18: ⚠️ Potential issue

Duplicate page title detected.
This file and js-injections/verification-options.mdx share the exact title “Verification Options,” which will appear twice in the sidebar. Consider renaming one to clarify its context (e.g., “Verification Options (InApp SDK)” vs “Verification Options (JS Injections)”).

♻️ Duplicate comments (1)
content/docs/advance-options/verification-options.mdx (1)

11-18: (Same as above) Refine table descriptions and punctuation.
See the suggestions in the js-injections/verification-options.mdx review: adjust “session storage,” add missing periods, and include default values.

🧹 Nitpick comments (48)
content/docs/meta.json (1)

16-17: Reordered existing sections; validate navigation
The "advance-options" and "attestor-decentralization" entries have been shifted in the pages array. Confirm this reordering reflects the correct hierarchy and that no TOC or link references are broken by the move.

Consider grouping all "Advanced" topics together or nesting them under a common parent for clarity.

content/docs/onchain/index.mdx (1)

2-3: Update title and description for onchain docs
The new frontmatter accurately reflects the focus on on-chain SDKs. Consider hyphenating “On-Chain” for consistency with other SDK section titles (e.g., “Reclaim Protocol On-Chain SDKs”).

content/docs/web/frontend/meta.json (1)

3-4: Consider consistent formatting of the pages array.
For readability and to align with other meta.json files, you could expand the array over multiple lines:

-  "pages": ["installation", "quickstart", "fullstack"]
+  "pages": [
+    "installation",
+    "quickstart",
+    "fullstack"
+  ]
content/docs/advance-options/advance-options.mdx (1)

261-267: Spell out 'RN' for clarity.
Readers unfamiliar with the abbreviation might benefit from seeing the full term. Consider:

- To set up deep linking in your RN app:
+ To set up deep linking in your React Native (RN) app:
content/docs/web/frontend/index.mdx (1)

14-14: Add punctuation after link.
For consistency with other sentences and to improve readability, add a period:

- To build a fullstack secure application, follow the [Fullstack guide](./fullstack)
+ To build a fullstack secure application, follow the [Fullstack guide](./fullstack).
content/docs/web/index.mdx (3)

7-8: Improve the section header for clarity.
The heading “## Understanding how the WebSDKs workflow” is slightly awkward. Consider rephrasing to “## Understanding the Web SDK workflow” or “## How the Web SDK workflow works” for better readability.


9-14: Add punctuation to list items for consistency.
The numbered steps currently lack terminal periods. For uniformity, append a period to the end of each step (e.g., “1. A verification link is created on the frontend…” → “1. A verification link is created on the frontend…”).


15-18: Fix missing punctuation and improve grammar in the requirements list.

  • Add terminal periods after items 1 and 2.
  • Consider adding an article for clarity:
    • “1. A frontend application using React.”
    • “2. A backend application to process the verification securely.”
🧰 Tools
🪛 LanguageTool

[uncategorized] ~16-~16: A punctuation mark might be missing here.
Context: ...end](./frontend) application using React 2. Backend application to proce...

(AI_EN_LECTOR_MISSING_PUNCTUATION)

content/docs/web/frontend/installation.mdx (2)

54-55: Correct verb usage in the API key section.
Change “Setup your project using the Get API Key guide.” to “Set up your project using the Get API Key guide.” for proper verb form.


57-58: Add punctuation for consistency.
The sentence “You can integrate into your frontend using the Quickstart guide or Fullstack guide” should end with a period.

content/docs/android-kotlin/installation.mdx (4)

13-19: Refine prerequisite descriptions.

  • Rename “An Android application source code” to “An Android application project” for clarity.
  • Update the parenthetical: “(supporting Android 5.0 or later)” and capitalize or remove “Support”.

23-41: Consider parameterizing the SDK version.
Hardcoding 0.3.0 in both the Maven URL and the implementation line can lead to drift on upgrades. Extract the version into a single placeholder (e.g., RECLAIM_ANDROID_SDK_VERSION) and reference it in both places.


43-45: Fix capitalization and wording.

  • Capitalize “URL” in “url of reclaimStorageUrl”.
  • Rephrase to:
    “You can replace the version in the URL of reclaimStorageUrl with the SDK version you’re using. The latest release is 0.3.0.”

47-51: Standardize hyphenation and terminology.

  • Use “app-level” instead of “app level”.
  • For example:
    “Next, add the following to your app-level build.gradle file:”
content/docs/advance-options/js-injections/verification-options.mdx (2)

6-7: Remove unused imports.
Tab, Tabs, Accordion, and Accordions are imported but not used. Cleaning these up will reduce confusion in the MDX.


11-18: Refine table descriptions and punctuation.

  • Row for canDeleteCookiesBeforeVerificationStarts: change “sessions storage” to “session storage”.
  • Row for canUseAttestorAuthenticationRequest: add a period at the end.
  • Consider specifying default values for all properties (e.g., default for canUseAttestorAuthenticationRequest).
content/docs/advance-options/verification-options.mdx (1)

6-7: Remove unused imports.
Tab, Tabs, Accordion, and Accordions are imported but not referenced. Please remove to clean the MDX.

content/docs/ios-swift/installation.mdx (2)

23-24: Capitalize technical identifiers consistently
Consider updating "app id, app secret" and "provider id" to "App ID", "App Secret", and "Provider ID" for consistency and improved readability across docs.


26-28: Link to API key guide matches new documentation structure
The added "Get an API Key" section correctly references the centralized /api-key guide. Ensure the link label matches the actual page title ("Get an API key") to avoid minor confusion.

content/docs/ionic/installation.mdx (2)

2-4: Consolidated installation page title and description
The title and description focus the page on installation steps. Consider refining the description to explicitly mention Ionic Capacitor—e.g., "Install and configure the Reclaim Protocol Capacitor SDK for Ionic apps"—for immediate clarity.


21-23: Insert centralized API key acquisition step
Adding the API key section improves consistency. Please ensure the link label ("Get an API Key guide") matches the API key page title ("Get an API key").

content/docs/web/frontend/quickstart.mdx (3)

2-4: Fix article usage and punctuation in description
The description contains "an prototype" (should be "a prototype") and lacks a comma after "However". Recommend updating to:

description: This is the fastest way to get a prototype running, and experience the flow. However, this is NOT the recommended mode for pushing to production.

6-9: Ensure link label consistency for API key guide
The prerequisites reference "API Key guide" while the page title is "Get an API key". Consider renaming the link to "Get an API key guide" or matching the exact page title for consistency.


74-79: Render proofs conditionally based on content
Currently {proofs && (…)} always renders the success block because an empty array is truthy. Change to:

{proofs.length > 0 && (
  <div></div>
)}

to ensure the block only appears when proofs exist.

content/docs/api-key.mdx (2)

6-6: Add missing article and improve phrasing
Change

For being able to use Reclaim Protocol, you need to have 3 variables handy.

to

To use the Reclaim Protocol, you need to have three variables handy.

[typographical]

🧰 Tools
🪛 LanguageTool

[uncategorized] ~6-~6: You might be missing the article “the” here.
Context: ...APP_SECRET --- For being able to use Reclaim Protocol, you need to have 3 variables ...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)


8-16: Consider renumbering or removing zero-based step
Using "## 0. Register" may confuse readers—consider starting your numbered steps at "## 1. Register" or dropping the leading number for clarity.

content/docs/android-kotlin/usage.mdx (1)

71-71: Add comma after introductory phrase
Update

For more usage options see [Advance Options guide](/advance-options/advance-options)

to

For more usage options, see [Advance Options guide](/advance-options/advance-options).
🧰 Tools
🪛 LanguageTool

[uncategorized] ~71-~71: Possible missing comma found.
Context: ...ion. ## Advanced Usage For more usage options see [Advance Options guide](/advance-op...

(AI_HYDRA_LEO_MISSING_COMMA)

content/docs/index.mdx (3)

6-6: Hyphenate "best-in-class"
The phrase "best in class" should be hyphenated when used as a compound adjective.
Apply:

- Reclaim Protocol has the best in class coverage of data sources ...
+ Reclaim Protocol has the best-in-class coverage of data sources ...
🧰 Tools
🪛 LanguageTool

[uncategorized] ~6-~6: It seems that hyphens are missing if you mean the adjective “best-in-class”.
Context: ...platform. --- Reclaim Protocol has the best in class coverage of data sources ([2500+](https...

(BEST_IN_CLASS_HYPHEN)


18-22: Consider rephrasing for variety
The bullet points repeatedly use "if you need to…"; consider rewording one of them to improve flow. For example:

- **Shopping History** - if you need to give deals and discounts based on users' loyalty to certain brands
+ **Shopping History** - leverage brand loyalty data to offer personalized deals and discounts
🧰 Tools
🪛 LanguageTool

[style] ~21-~21: You have already used this phrasing in nearby sentences. Consider replacing it to add variety to your writing.
Context: ...credit. - Shopping History - if you need to give deals and discounts based on users...

(REP_NEED_TO_VB)


24-24: Add the definite article "the"
For grammatical correctness, prepend "the" to "Reclaim Protocol" in the heading:

- ### More information about how Reclaim Protocol works
+ ### More information about how the Reclaim Protocol works
🧰 Tools
🪛 LanguageTool

[uncategorized] ~24-~24: You might be missing the article “the” here.
Context: ...more!** ### More information about how Reclaim Protocol works - [Non-technical Overvie...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)

content/docs/react-native/usage.mdx (1)

7-7: Ensure consistent "SDK" casing
Replace "Sdk" with "SDK" to match the rest of the documentation:

- To use Reclaim InApp Sdk in your project, follow these steps:
+ To use Reclaim InApp SDK in your project, follow these steps:
content/docs/web/backend/usage.mdx (1)

39-39: Use template literals for URL assembly
In the JS example, consider using backticks for readability:

- reclaimProofRequest.setAppCallbackUrl(BASE_URL+'/receive-proofs')
+ reclaimProofRequest.setAppCallbackUrl(`${BASE_URL}/receive-proofs`)
content/docs/ionic/usage.mdx (2)

7-7: Ensure consistent "SDK" casing
Update the introductory line to use "SDK":

- To use Reclaim InApp Sdk in your project, follow these steps:
+ To use Reclaim InApp SDK in your project, follow these steps:

98-98: Improve punctuation and formatting
Add a comma and ensure the link has proper punctuation:

- ## Advanced Usage
- For more usage options see [Advance Options guide](/advance-options/advance-options)
+ ## Advanced Usage
+ For more usage options, see the [Advanced Options guide](/advance-options/advance-options).
🧰 Tools
🪛 LanguageTool

[uncategorized] ~98-~98: Possible missing comma found.
Context: ...ion. ## Advanced Usage For more usage options see [Advance Options guide](/advance-op...

(AI_HYDRA_LEO_MISSING_COMMA)

content/docs/advance-options/verification.mdx (2)

24-24: Add missing article “the”.
Change “…calling getRequestUrl method on proof request object.”
to “…calling the getRequestUrl method on the proof request object.”


44-44: Clarify heading phrasing.
Consider renaming “Generate proof on client mobile”
to “Generate proof in the mobile client” for consistency and readability.

content/docs/ios-swift/usage.mdx (7)

3-3: Refine description for clarity.
Consider:
Reclaim Protocol InApp iOS SDK for generating ZK proofs with an in-app verification experience.


9-9: Avoid repetition.
You repeat “in your project.” Maybe streamline to:
To integrate ReclaimInAppSdk, follow these steps:


38-42: Clarify potential error scenario.
Reword “// This may fail if device screen is getting shared” to:
// This may fail if screen sharing is active (e.g., AirPlay or screen recording).


60-61: Standardize “APIs” capitalization.
Change “In the above apis,” to “In the above APIs,” for consistency.


62-63: Capitalize “SDK” abbreviation.
In “dismissed by the sdk,” update “sdk” → “SDK”.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~62-~62: Loose punctuation mark.
Context: ... - ReclaimVerificationError.cancelled: The verification was cancelled by the u...

(UNLIKELY_OPENING_PUNCTUATION)


[uncategorized] ~63-~63: Loose punctuation mark.
Context: .... - ReclaimVerificationError.dismissed: The verification was dismissed by the s...

(UNLIKELY_OPENING_PUNCTUATION)


82-82: Add comma for readability.
Change “For more usage options see” to “For more usage options, see”.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~82-~82: Possible missing comma found.
Context: ...ift). ## Advanced Usage For more usage options see [Advance Options guide](/advance-op...

(AI_HYDRA_LEO_MISSING_COMMA)


92-95: Fix grammar in upgrade steps.

  • Add comma after “Currently”: Currently, the latest version is …
  • Correct “Incase” → “In case”.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~94-~94: A comma may be missing after the conjunctive/linking adverb ‘Currently’.
Context: ...atest version of the Reclaim InApp SDK. Currently the latest version is v0.3.0. 1. Inc...

(SENT_START_CONJUNCTIVE_LINKING_ADVERB_COMMA)


[uncategorized] ~95-~95: You might be missing the article “the” here.
Context: ...ge, clear build, restart Xcode, and add package again. Migration guides will be availa...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)

content/docs/web/frontend/fullstack.mdx (4)

17-19: Style nit: title case link text.
Consider changing “[Installation guide]” → “[Installation Guide]” to match heading style.


36-38: Add space after comment marker.
Change:

- //if using ngrok, use the ngrok base url here
+ // If using ngrok, use the ngrok base URL here

87-93: Label JSX block for syntax highlighting.
Add jsx after the opening backticks:

- ```
+ ```jsx

116-123: Ensure proofs state is updated.
After success, call setProofs(proofs) so the component renders the proof data.

content/docs/react-native/installation.mdx (1)

6-9: Use callout component for notes.
Wrap compatibility warnings in a <Callout type="note"> block instead of plain text for consistency.

🛑 Comments failed to post (10)
content/docs/ai-agent/meta.json (1)

2-2: 💡 Verification agent

🧩 Analysis chain

Rename section title; verify correspondence
The title has been updated from "AI Agent" to "A2A & MCP". Please confirm that navigation labels, frontmatter in the ai-agent pages, and any site configuration references are updated accordingly—and that the ampersand does not cause encoding or rendering issues in the UI.


🏁 Script executed:

#!/bin/bash
# Check for residual references to the old title/slug
rg -l '"AI Agent"' -n content/docs
rg -l '"ai-agent"' -n content/docs/**/*.meta.json

Length of output: 158


🏁 Script executed:

#!/bin/bash
# Properly search for any remaining references to the old title “AI Agent” or slug “ai-agent”
rg -n 'AI Agent' content/docs || true
rg -n 'ai-agent' content/docs || true

Length of output: 1736


Update frontmatter and headings to match the new section title
I see that you’ve renamed the section title in content/docs/ai-agent/meta.json to "A2A & MCP", but there are still references to the old name in your docs. Please update the following and confirm that the ampersand renders correctly in navigation/UI:

• content/docs/ai-agent/index.mdx
– Frontmatter:
diff - title: AI Agent + title: A2A & MCP
• content/docs/ai-agent/quickstart.mdx
– Heading(s):
diff - # Verification AI Agent Quickstart + # Verification A2A & MCP Quickstart
• Image paths and alt-text under content/docs/ai-agent/ (e.g. /images/ai-agent/...)
– Confirm that URLs remain valid or rename folder if you’re changing the slug.

Finally, test the site navigation and page renders to ensure "A2A & MCP" displays and links without encoding issues.

Committable suggestion skipped: line range outside the PR's diff.

🤖 Prompt for AI Agents
In content/docs/ai-agent/meta.json at line 2, the section title was changed to
"A2A & MCP" but references to the old title "AI Agent" remain in frontmatter,
headings, image paths, and site config. Update frontmatter in
content/docs/ai-agent/index.mdx, headings in
content/docs/ai-agent/quickstart.mdx, and any image URLs or alt-text under
content/docs/ai-agent/ to reflect the new title or slug. Verify that the
ampersand renders correctly in navigation and UI without encoding issues.
Finally, test site navigation and page rendering to confirm all changes are
consistent and functional.
content/docs/web/frontend/index.mdx (1)

1-4: ⚠️ Potential issue

Inconsistent title with metadata.
The frontmatter title: Frontend should match the meta.json title "Frontend (React)" to ensure consistent labeling in the sidebar and page headers.

🤖 Prompt for AI Agents
In content/docs/web/frontend/index.mdx at lines 1 to 4, update the frontmatter
title from "Frontend" to "Frontend (React)" so it matches the title in
meta.json. This ensures consistent labeling in the sidebar and page headers
across the documentation.
content/docs/web/frontend/quickstart.mdx (2)

81-82: ⚠️ Potential issue

Correct spelling and punctuation in production guidance
There's a typo ("use" → "user") and missing comma. Update to:

-## Get production Ready
-For production usecases, you might want to make sure that the proofs are sent directly to your backend - so that the use doesn't have an opportunity to tamper with the data. For that implement the [Backend](../backend) and follow the [Fullstack guide](./fullstack)
+## Get Production Ready
+For production use cases, you might want to ensure that proofs are sent directly to your backend—so that the user doesn't have an opportunity to tamper with the data. For that, implement the [Backend](../backend), and follow the [Fullstack guide](./fullstack).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

## Get Production Ready
For production use cases, you might want to ensure that proofs are sent directly to your backend—so that the user doesn't have an opportunity to tamper with the data. For that, implement the [Backend](../backend), and follow the [Fullstack guide](./fullstack).
🧰 Tools
🪛 LanguageTool

[typographical] ~82-~82: Use a comma after an introductory phrase.
Context: ...an opportunity to tamper with the data. For that implement the Backend and follow th...

(COMMA_INTRODUCTORY_WORDS_PHRASES)

🤖 Prompt for AI Agents
In content/docs/web/frontend/quickstart.mdx around lines 81 to 82, correct the
typo "use" to "user" and add a comma after "For that" to improve clarity and
punctuation in the production guidance sentence.

23-55: ⚠️ Potential issue

Invoke state update for proofs on success
In the onSuccess callback, the proofs state is never updated, so the success UI block will never render actual proofs. You should call setProofs(proofs) inside onSuccess.

Apply this diff:

@@ await reclaimProofRequest.startSession({
-      onSuccess: (proofs) => {
-        // Add your success logic here, such as:
-        // - Updating UI to show verification success
-        // - Storing verification status
-        // - Redirecting to another page
-      },
+      onSuccess: (proofs) => {
+        // Add your success logic here, such as:
+        // - Updating UI to show verification success
+        // - Storing verification status
+        // - Redirecting to another page
+        setProofs(proofs);
+      },
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

  const getVerificationReq = async () => {
    // Your credentials from the Reclaim Protocol Developer Portal
    const APP_ID = 'YOUR_APPLICATION_ID';
    const APP_SECRET = 'YOUR_APPLICATION_SECRET';
    const PROVIDER_ID = 'YOUR_PROVIDER_ID';

    // Initialize the Reclaim SDK with your credentials
    const reclaimProofRequest = await ReclaimProofRequest.init(APP_ID, APP_SECRET, PROVIDER_ID);

    // Generate the verification request URL
    const requestUrl = await reclaimProofRequest.getRequestUrl();
    setRequestUrl(requestUrl);

    // Start listening for proof submissions
    await reclaimProofRequest.startSession({
      // Called when the user successfully completes the verification
      onSuccess: (proofs) => {
        // Add your success logic here, such as:
        // - Updating UI to show verification success
        // - Storing verification status
        // - Redirecting to another page
        setProofs(proofs);
      },
      // Called if there's an error during verification
      onError: (error) => {
        console.error('Verification failed', error);

        // Add your error handling logic here, such as:
        // - Showing error message to user
        // - Resetting verification state
        // - Offering retry options
      },
    });
  };
🤖 Prompt for AI Agents
In content/docs/web/frontend/quickstart.mdx around lines 23 to 55, the onSuccess
callback does not update the proofs state, preventing the UI from rendering the
verification results. Fix this by adding a call to setProofs(proofs) inside the
onSuccess function to update the state with the received proofs.
content/docs/web/backend/usage.mdx (1)

83-87: ⚠️ Potential issue

Fix Python snippet syntax errors

  • Remove the stray semicolon in the Python BASE_URL assignment.
  • Change the JavaScript-style comment to a Python comment.
- BASE_URL = "https://your-domain.com"; # if using ngrok, provide the ngrok base url
+ BASE_URL = "https://your-domain.com"  # if using ngrok, provide the ngrok base url

-            // we will be defining this endpoint in the next step
+            # we will be defining this endpoint in the next step

Committable suggestion skipped: line range outside the PR's diff.

🤖 Prompt for AI Agents
In content/docs/web/backend/usage.mdx around lines 83 to 87, fix the Python
syntax errors by removing the stray semicolon at the end of the BASE_URL
assignment and replacing the JavaScript-style comment with a proper Python
comment using the hash symbol (#).
content/docs/flutter/usage.mdx (1)

13-13: ⚠️ Potential issue

Correct spelling of "example"
Fix the typo in the explanatory text:

- Following is an exmaple.
+ Following is an example.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Following is an example.
🤖 Prompt for AI Agents
In content/docs/flutter/usage.mdx at line 13, correct the typo "exmaple" to
"example" in the explanatory text to fix the spelling error.
content/docs/advance-options/verification.mdx (1)

8-8: ⚠️ Potential issue

Fix broken link to installation guide.
The link currently points to http://localhost:3000/backend/installation, which won’t resolve in production. Update to the relative documentation path:

-[Reclaim Protocol Backend SDK](http://localhost:3000/backend/installation)
+[Reclaim Protocol Backend SDK](../backend/installation)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

As best practice, we **strongly** recommend verifying proofs generated from client-side SDKs with a [Reclaim Protocol Backend SDK](../backend/installation). 
🤖 Prompt for AI Agents
In content/docs/advance-options/verification.mdx at line 8, the link to the
Reclaim Protocol Backend SDK installation guide incorrectly points to a
localhost URL, which will not work in production. Replace the absolute URL
"http://localhost:3000/backend/installation" with the correct relative
documentation path to ensure the link resolves properly in all environments.
content/docs/web/frontend/fullstack.mdx (2)

77-83: ⚠️ Potential issue

Inconsistent function naming: initializeReclaim vs. getVerificationReq.
The hook calls initializeReclaim(), but you defined getVerificationReq. Update:

- initializeReclaim().then(requestUrl => {
+ getVerificationReq().then(requestUrl => {
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

  useEffect(() => {
    getVerificationReq().then(requestUrl => {
      setRequestUrl(requestUrl);
    })
  }, [])
🤖 Prompt for AI Agents
In content/docs/web/frontend/fullstack.mdx around lines 77 to 83, the function
called in the useEffect hook is named initializeReclaim, but the defined
function is getVerificationReq. Rename the function call in the useEffect hook
from initializeReclaim to getVerificationReq to ensure consistent function
naming and correct invocation.

137-140: ⚠️ Potential issue

Undefined variable proof in onSuccess handler.
It logs proof instead of the proofs parameter and never updates state. Apply:

- console.log("successfully created proof", proof);
+ console.log("successfully created proofs", proofs);
+ setProofs(proofs);
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

    // Step 4: Start the verification session
    await reclaimProofRequest.startSession({
      onSuccess: (proofs) => {
        console.log("successfully created proofs", proofs);
        setProofs(proofs);
🤖 Prompt for AI Agents
In content/docs/web/frontend/fullstack.mdx around lines 137 to 140, the
onSuccess handler incorrectly logs an undefined variable `proof` instead of the
provided `proofs` parameter. Update the console.log statement to log `proofs`
and add any necessary state update logic to handle the successful proof
creation.
content/docs/flutter/installation.mdx (1)

51-51: ⚠️ Potential issue

Typo in example introduction.
Change “Following is an exmaple.” → “Following is an example.”

🤖 Prompt for AI Agents
In content/docs/flutter/installation.mdx at line 51, correct the typo in the
sentence by changing "Following is an exmaple." to "Following is an example."

Copy link

@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: 3

🔭 Outside diff range comments (2)
content/docs/ios-swift/installation.mdx (1)

222-334: 🛠️ Refactor suggestion

Remove usage and advanced content from installation guide

This segment contains the full usage instructions, advanced usage, and migration guidance, which belong in a separate usage.mdx file. Ensure the installation document only covers setup steps. Remove the conflict markers and the main branch content so that this file ends after the installation instructions.

🧰 Tools
🪛 LanguageTool

[typographical] ~324-~324: Ikke parret symbol: "]" ser ud til at mangle
Context: ... } } ``` Read more about overrides in [Reclaim InApp SDK Documentation | Overri...

(UNPAIRED_BRACKETS)

content/docs/ionic/installation.mdx (1)

289-405: 🛠️ Refactor suggestion

Strip usage and migration sections from installation file

This installation document currently includes full usage, migration, and contributing info, which should reside in the separate usage.mdx or other dedicated files. Remove the conflict markers and the extra content to keep this page focused solely on installation.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

📥 Commits

Reviewing files that changed from the base of the PR and between e7e7a14 and 8c2705f.

📒 Files selected for processing (3)
  • content/docs/flutter/meta.json (1 hunks)
  • content/docs/ionic/installation.mdx (3 hunks)
  • content/docs/ios-swift/installation.mdx (4 hunks)
🧰 Additional context used
🪛 Biome (1.9.4)
content/docs/flutter/meta.json

[error] 3-3: unexpected character <

(parse)


[error] 3-3: unexpected character <

(parse)


[error] 3-3: unexpected character <

(parse)


[error] 3-3: unexpected character <

(parse)


[error] 3-3: unexpected character <

(parse)


[error] 3-3: unexpected character <

(parse)


[error] 3-3: String values must be double quoted.

(parse)


[error] 4-4: End of file expected

Use an array for a sequence of values: [1, 2]

(parse)


[error] 4-4: End of file expected

Use an array for a sequence of values: [1, 2]

(parse)


[error] 4-4: End of file expected

Use an array for a sequence of values: [1, 2]

(parse)


[error] 4-5: unexpected character =

(parse)


[error] 5-5: unexpected character =

(parse)


[error] 5-5: unexpected character =

(parse)


[error] 5-5: unexpected character =

(parse)


[error] 5-5: unexpected character =

(parse)


[error] 5-5: unexpected character =

(parse)


[error] 5-5: unexpected character =

(parse)


[error] 6-6: End of file expected

Use an array for a sequence of values: [1, 2]

(parse)


[error] 6-6: End of file expected

Use an array for a sequence of values: [1, 2]

(parse)


[error] 6-6: End of file expected

Use an array for a sequence of values: [1, 2]

(parse)


[error] 6-7: unexpected character >

(parse)


[error] 7-7: unexpected character >

(parse)


[error] 7-7: unexpected character >

(parse)


[error] 7-7: unexpected character >

(parse)


[error] 7-7: unexpected character >

(parse)


[error] 7-7: unexpected character >

(parse)


[error] 7-7: unexpected character >

(parse)


[error] 7-7: String values must be double quoted.

(parse)

🔇 Additional comments (2)
content/docs/ios-swift/installation.mdx (1)

31-32: Confirm inclusion of "Get an API Key" section

The new "Get an API Key" section correctly directs users to /api-key, centralizing credential setup. Verify that the link path is correct relative to the site structure and that the referenced content/docs/api-key.mdx exists and is included in the navigation.

content/docs/ionic/installation.mdx (1)

26-28: Confirm the "Get an API Key" section

The addition of the "Get an API Key" section helps centralize credential setup. Please verify that the /api-key link resolves correctly in the deployed docs and that the corresponding guide exists.

Comment on lines +2 to +8
<<<<<<<< HEAD:content/docs/ios-swift/installation.mdx
title: Installation
description: Integrate Reclaim Protocol into iOS Native Applications.
========
title: iOS
description: Reclaim Protocol's InApp iOS SDK for ZK proof generations for requests with an in-app experience of web verification
>>>>>>>> main:content/docs/inapp-sdks/installation/ios.mdx
Copy link

Choose a reason for hiding this comment

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

🛠️ Refactor suggestion

Remove unresolved merge conflict markers in frontmatter

The file contains Git conflict markers around the frontmatter metadata. Please choose the correct metadata for this installation guide (likely the title: Installation and description: Integrate Reclaim Protocol into iOS Native Applications. from the HEAD version), remove the conflict markers (<<<<<<<, =======, >>>>>>>), and delete the outdated main branch lines.

🤖 Prompt for AI Agents
In content/docs/ios-swift/installation.mdx around lines 2 to 8, there are
unresolved Git merge conflict markers in the frontmatter. Remove all conflict
markers (<<<<<<<, =======, >>>>>>>) and keep only the correct metadata from the
HEAD version, which includes the title "Installation" and the description
"Integrate Reclaim Protocol into iOS Native Applications." Delete the
conflicting lines from the main branch to clean up the frontmatter.

@madhavanmalolan madhavanmalolan merged commit a2c4cfe into main May 16, 2025
2 of 3 checks passed
@coderabbitai coderabbitai bot mentioned this pull request Sep 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants