Skip to content

fixed SEO issues from ahrefs #7688

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

fixed SEO issues from ahrefs #7688

wants to merge 5 commits into from

Conversation

saminacodes
Copy link
Member

@saminacodes saminacodes commented Jul 23, 2025


PR-Codex overview

This PR primarily focuses on enhancing the documentation for the thirdweb CLI and related functionalities, improving the clarity and detail of descriptions, and restructuring FAQs to provide a better user experience.

Detailed summary

  • Updated title in apps/portal/src/app/payments/send/page.mdx.
  • Revised description in apps/portal/src/app/payments/sell/page.mdx.
  • Enhanced description in apps/portal/src/app/webhooks/page.mdx.
  • Added metadata for thirdweb CLI pages in various apps/portal/src/app/cli/* files.
  • Reformatted FAQs in apps/portal/src/app/wallets/faq/page.mdx using <Details> for better organization.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

Summary by CodeRabbit

  • New Features

    • Added structured metadata to multiple CLI documentation pages, improving searchability and page descriptions.
  • Style

    • Refined the FAQ page layout by introducing collapsible sections for each question and answer, enhancing readability and navigation.
    • Updated the indentation style in the chat page for improved code consistency (no impact on user experience).
  • Documentation

    • Clarified and improved metadata titles and descriptions for payments and webhooks documentation pages.

Copy link

changeset-bot bot commented Jul 23, 2025

⚠️ No Changeset found

Latest commit: 4a5769b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link

vercel bot commented Jul 23, 2025

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

Name Status Preview Comments Updated (UTC)
docs-v2 ❌ Failed (Inspect) Jul 24, 2025 4:03pm
nebula ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 24, 2025 4:03pm
thirdweb_playground ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 24, 2025 4:03pm
thirdweb-www ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 24, 2025 4:03pm
wallet-ui ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 24, 2025 4:03pm

Copy link
Contributor

coderabbitai bot commented Jul 23, 2025

Walkthrough

This update adds or modifies metadata exports in multiple MDX documentation pages, primarily under the CLI section, by introducing structured metadata objects via a createMetadata function. It also refactors the wallets FAQ page to use a collapsible <Details> component, and updates metadata descriptions or titles in several payment and webhooks-related pages. One JSX file receives indentation adjustments only.

Changes

Files/Groups Change Summary
apps/portal/src/app/cli/*.mdx Added exported metadata constants using createMetadata with image, title, and description properties.
apps/portal/src/app/payments/sell/page.mdx
apps/portal/src/app/payments/send/page.mdx
Updated metadata descriptions or titles for clarity; no structural or logic changes.
apps/portal/src/app/webhooks/page.mdx Updated metadata description for improved instruction; no functional changes.
apps/portal/src/app/wallets/faq/page.mdx Refactored FAQ to use <Details> component for collapsible Q&A; added import for Details.
apps/portal/src/app/chat/page.tsx Adjusted JSX return statement indentation; no logic or structural changes.

Estimated code review effort

1 (~5 minutes)

Warning

Review ran into problems

🔥 Problems

Errors were encountered while retrieving linked issues.

Errors (1)
  • TEAM-0000: Entity not found: Issue - Could not find referenced Issue.

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

@github-actions github-actions bot added the Portal Involves changes to the Portal (docs) codebase. label Jul 23, 2025
@saminacodes saminacodes marked this pull request as ready for review July 23, 2025 18:21
@saminacodes saminacodes requested review from a team as code owners July 23, 2025 18:21
Copy link
Contributor

github-actions bot commented Jul 23, 2025

size-limit report 📦

Path Size Loading time (3g) Running time (snapdragon) Total time
thirdweb (esm) 63.33 KB (0%) 1.3 s (0%) 180 ms (+112.68% 🔺) 1.5 s
thirdweb (cjs) 353.15 KB (0%) 7.1 s (0%) 660 ms (+10.74% 🔺) 7.8 s
thirdweb (minimal + tree-shaking) 5.7 KB (0%) 114 ms (0%) 61 ms (+1292.38% 🔺) 175 ms
thirdweb/chains (tree-shaking) 526 B (0%) 11 ms (0%) 24 ms (+754.64% 🔺) 34 ms
thirdweb/react (minimal + tree-shaking) 19.22 KB (0%) 385 ms (0%) 68 ms (+533.17% 🔺) 453 ms

Copy link
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: 9

🧹 Nitpick comments (8)
apps/portal/src/app/webhooks/page.mdx (1)

8-8: Hyphenate “onchain” for technical consistency

Across the docs we usually write “on-chain / off-chain”; consider updating to maintain uniform spelling and SEO keyword consistency.

-description: "Learn how to receive real-time updates for onchain and offchain events using thirdweb.",
+description: "Learn how to receive real-time updates for on-chain and off-chain events using thirdweb.",
apps/portal/src/app/payments/sell/page.mdx (1)

22-29: Enhance the meta description for richer SEO & snippet length

The updated description is a step forward, but at ~60 chars it doesn’t fully utilize Google’s preferred 150-160 char snippet window.
Consider adding 1-2 specific keywords (e.g., “cross-chain”, “Bridge SDK”, “USDT→USDC”) and a brief value proposition to improve click-through.

-  description: "Learn how to sell cryptocurrency tokens with thirdweb Payments.",
+  description: "Learn how to sell cryptocurrency tokens cross-chain with thirdweb Payments using the Bridge SDK — prepare quotes, execute sales, and receive assets on any supported chain.",
apps/portal/src/app/chat/page.tsx (1)

8-16: Add explicit return type to satisfy our TS guidelines

All *.tsx files must declare an explicit return type.
Quick fix:

-export default function ChatPage() {
+export default function ChatPage(): JSX.Element {
apps/portal/src/app/wallets/faq/page.mdx (2)

22-24: Replace <br /><br /> with semantic paragraphs

Using <br /> for vertical spacing hampers accessibility and leads to brittle layouts. Prefer separate Markdown/JSX paragraphs or a spacing utility from your design system:

- ... <code>signer</code>, you can build ...
- <br /><br />
- However, you will need ...
+ ... <code>signer</code>, you can build ...
+
+However, you will need ...

Same applies to the other instances listed above.

Also applies to: 28-29, 50-52


3-10: Consider adding keywords & OG metadata

Since this PR targets SEO, adding a keywords array (and possibly Open Graph/Twitter tags) can further boost discoverability:

 export const metadata = createMetadata({
   title: "FAQ for thirdweb Wallet",
   description: "Frequently asked questions about thirdweb's Wallet",
+  keywords: ["thirdweb wallet", "web3 faq", "in-app wallet", "account abstraction"],
   image: {

Optional but low-effort win.

apps/portal/src/app/cli/build/page.mdx (1)

6-8: Title is too generic – hurts SEO deduplication

Several pages now share the exact same <title> “thirdweb CLI | Reference”. Search engines may collapse them or flag as duplicate content. Consider a command-specific title, e.g.:

- title: "thirdweb CLI | Reference",
+ title: "thirdweb CLI build | Reference",
apps/portal/src/app/cli/upload/page.mdx (1)

8-9: Duplicate generic title

Same duplication concern; make this command-specific:

- title: "thirdweb CLI | Reference",
+ title: "thirdweb CLI upload | Reference",
apps/portal/src/app/cli/logout/page.mdx (1)

6-8: Minor wording / grammar tweak

“Learn how to logout of …” – when used as a verb, it should be “log out of”. Helps Ahrefs & users alike.

-	description: "Learn how to logout of the thirdweb CLI and revoke access from your device.",
+	description: "Learn how to log out of the thirdweb CLI and revoke this device's access.",
📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 8260af3 and 23c470a.

📒 Files selected for processing (13)
  • apps/portal/src/app/chat/page.tsx (1 hunks)
  • apps/portal/src/app/cli/build/page.mdx (1 hunks)
  • apps/portal/src/app/cli/create/page.mdx (1 hunks)
  • apps/portal/src/app/cli/generate/page.mdx (1 hunks)
  • apps/portal/src/app/cli/install/page.mdx (1 hunks)
  • apps/portal/src/app/cli/login/page.mdx (1 hunks)
  • apps/portal/src/app/cli/logout/page.mdx (1 hunks)
  • apps/portal/src/app/cli/page.mdx (1 hunks)
  • apps/portal/src/app/cli/upload/page.mdx (1 hunks)
  • apps/portal/src/app/payments/sell/page.mdx (1 hunks)
  • apps/portal/src/app/payments/send/page.mdx (1 hunks)
  • apps/portal/src/app/wallets/faq/page.mdx (1 hunks)
  • apps/portal/src/app/webhooks/page.mdx (1 hunks)
🧰 Additional context used
📓 Path-based instructions (2)
**/*.{ts,tsx}

📄 CodeRabbit Inference Engine (CLAUDE.md)

**/*.{ts,tsx}: Write idiomatic TypeScript with explicit function declarations and return types
Limit each file to one stateless, single-responsibility function for clarity
Re-use shared types from @/types or local types.ts barrels
Prefer type aliases over interface except for nominal shapes
Avoid any and unknown unless unavoidable; narrow generics when possible
Choose composition over inheritance; leverage utility types (Partial, Pick, etc.)
Comment only ambiguous logic; avoid restating TypeScript in prose

Files:

  • apps/portal/src/app/chat/page.tsx
**/*.{ts,tsx,js,jsx}

📄 CodeRabbit Inference Engine (CLAUDE.md)

Load heavy dependencies inside async paths to keep initial bundle lean (lazy loading)

Files:

  • apps/portal/src/app/chat/page.tsx
🧠 Learnings (13)
📓 Common learnings
Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Surface breaking changes prominently in PR descriptions
apps/portal/src/app/chat/page.tsx (14)

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : Interactive UI that relies on hooks (useState, useEffect, React Query, wallet hooks).

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to apps/{dashboard,playground-web}/**/*.{ts,tsx} : Wrap client-side data fetching calls in React Query (@tanstack/react-query)

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : Anything that consumes hooks from @tanstack/react-query or thirdweb SDKs.

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to apps/{dashboard,playground-web}/**/*.{ts,tsx} : Client Components (browser): Begin files with 'use client';

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to src/exports/react.native.ts : React Native specific exports are in src/exports/react.native.ts

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to **/*.{ts,tsx} : Limit each file to one stateless, single-responsibility function for clarity

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to apps/{dashboard,playground-web}/**/*.{tsx} : Expose className prop on root element of components for overrides

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to **/*.{ts,tsx} : Write idiomatic TypeScript with explicit function declarations and return types

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/components/*.client.tsx : Client components must start with 'use client'; before imports.

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : Components that listen to user events, animations or live updates.

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : Use React Query (@tanstack/react-query) for all client data fetching.

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : Pages requiring fast transitions where data is prefetched on the client.

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : When you need access to browser APIs (localStorage, window, IntersectionObserver etc.).

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/layout.tsx : Building layout shells (layout.tsx) and top-level pages that mainly assemble data.

apps/portal/src/app/payments/sell/page.mdx (5)

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/tokens/shared-page.tsx:41-48
Timestamp: 2025-05-26T16:28:50.772Z
Learning: The projectMeta prop is not required for the server-rendered ContractTokensPage component in the tokens shared page, unlike some other shared pages where it's needed for consistency.

Learnt from: MananTank
PR: #7177
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/public-pages/erc20/_hooks/useTokenPriceData.ts:49-49
Timestamp: 2025-05-27T19:55:25.056Z
Learning: In the ERC20 public pages token price data hook (useTokenPriceData.ts), direct array access on json.data[0] without optional chaining is intentionally correct and should not be changed to use safety checks.

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Surface breaking changes prominently in PR descriptions

Learnt from: MananTank
PR: #7298
File: apps/dashboard/src/app/nebula-app/move-funds/move-funds.tsx:255-277
Timestamp: 2025-06-06T23:47:55.122Z
Learning: The transfer function from thirdweb/extensions/erc20 accepts human-readable amounts via the amount property and automatically handles conversion to base units (wei) by fetching the token decimals internally. Manual conversion using toWei() is not required when using the amount property.

Learnt from: MananTank
PR: #7081
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/assets/create/create-token-page-impl.tsx:110-118
Timestamp: 2025-05-20T18:54:15.781Z
Learning: In the thirdweb dashboard's token asset creation flow, the transferBatch function from thirdweb/extensions/erc20 accepts the raw quantity values from the form without requiring explicit conversion to wei using toUnits(). The function appears to handle this conversion internally or is designed to work with the values in the format they're already provided.

apps/portal/src/app/cli/build/page.mdx (4)

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/tokens/shared-page.tsx:41-48
Timestamp: 2025-05-26T16:28:50.772Z
Learning: The projectMeta prop is not required for the server-rendered ContractTokensPage component in the tokens shared page, unlike some other shared pages where it's needed for consistency.

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/(marketplace)/direct-listings/shared-direct-listings-page.tsx:47-52
Timestamp: 2025-05-26T16:29:54.317Z
Learning: The projectMeta prop is not required for the server-rendered ContractDirectListingsPage component in the direct listings shared page, following the same pattern as other server components in the codebase where projectMeta is only needed for client components.

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to src/extensions/** : Auto-generated contracts from ABI definitions in extensions

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to packages/thirdweb/src/exports/** : Export everything via exports/ directory, grouped by feature in the SDK public API

apps/portal/src/app/webhooks/page.mdx (4)

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Surface breaking changes prominently in PR descriptions

Learnt from: MananTank
PR: #7177
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/public-pages/erc20/erc20.tsx:15-17
Timestamp: 2025-05-27T19:54:55.885Z
Learning: The fetchDashboardContractMetadata function from "@3rdweb-sdk/react/hooks/useDashboardContractMetadata" has internal error handlers for all promises and cannot throw errors, so external error handling is not needed when calling this function.

Learnt from: MananTank
PR: #7356
File: apps/nebula/src/app/not-found.tsx:1-1
Timestamp: 2025-06-17T18:30:52.976Z
Learning: In the thirdweb/js project, the React namespace is available for type annotations (like React.FC) without needing to explicitly import React. This is project-specific configuration that differs from typical TypeScript/React setups.

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : Anything that consumes hooks from @tanstack/react-query or thirdweb SDKs.

apps/portal/src/app/cli/generate/page.mdx (5)

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/tokens/shared-page.tsx:41-48
Timestamp: 2025-05-26T16:28:50.772Z
Learning: The projectMeta prop is not required for the server-rendered ContractTokensPage component in the tokens shared page, unlike some other shared pages where it's needed for consistency.

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/(marketplace)/direct-listings/shared-direct-listings-page.tsx:47-52
Timestamp: 2025-05-26T16:29:54.317Z
Learning: The projectMeta prop is not required for the server-rendered ContractDirectListingsPage component in the direct listings shared page, following the same pattern as other server components in the codebase where projectMeta is only needed for client components.

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to src/extensions/** : Auto-generated contracts from ABI definitions in extensions

Learnt from: MananTank
PR: #7177
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/public-pages/erc20/erc20.tsx:15-17
Timestamp: 2025-05-27T19:54:55.885Z
Learning: The fetchDashboardContractMetadata function from "@3rdweb-sdk/react/hooks/useDashboardContractMetadata" has internal error handlers for all promises and cannot throw errors, so external error handling is not needed when calling this function.

Learnt from: MananTank
PR: #7332
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/public-pages/nft/overview/nft-drop-claim.tsx:82-90
Timestamp: 2025-06-13T13:03:41.732Z
Learning: The thirdweb contract object is serializable and can safely be used in contexts (e.g., React-Query keys) that require serializable values.

apps/portal/src/app/cli/login/page.mdx (3)

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/tokens/shared-page.tsx:41-48
Timestamp: 2025-05-26T16:28:50.772Z
Learning: The projectMeta prop is not required for the server-rendered ContractTokensPage component in the tokens shared page, unlike some other shared pages where it's needed for consistency.

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/(marketplace)/direct-listings/shared-direct-listings-page.tsx:47-52
Timestamp: 2025-05-26T16:29:54.317Z
Learning: The projectMeta prop is not required for the server-rendered ContractDirectListingsPage component in the direct listings shared page, following the same pattern as other server components in the codebase where projectMeta is only needed for client components.

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*.{tsx,jsx} : Icons come from lucide-react or the project-specific …/icons exports – never embed raw SVG.

apps/portal/src/app/cli/install/page.mdx (3)

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to packages/thirdweb/src/exports/** : Export everything via exports/ directory, grouped by feature in the SDK public API

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/tokens/shared-page.tsx:41-48
Timestamp: 2025-05-26T16:28:50.772Z
Learning: The projectMeta prop is not required for the server-rendered ContractTokensPage component in the tokens shared page, unlike some other shared pages where it's needed for consistency.

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/(marketplace)/direct-listings/shared-direct-listings-page.tsx:47-52
Timestamp: 2025-05-26T16:29:54.317Z
Learning: The projectMeta prop is not required for the server-rendered ContractDirectListingsPage component in the direct listings shared page, following the same pattern as other server components in the codebase where projectMeta is only needed for client components.

apps/portal/src/app/wallets/faq/page.mdx (5)

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*client.tsx : Interactive UI that relies on hooks (useState, useEffect, React Query, wallet hooks).

Learnt from: CR
PR: thirdweb-dev/js#0
File: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*.{tsx,jsx} : Prefer composable primitives over custom markup: Button, Input, Select, Tabs, Card, Sidebar, Separator, Badge.

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to packages/thirdweb/src/wallets/** : Support for in-app wallets (social/email login)

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to packages/thirdweb/src/wallets/** : EIP-1193, EIP-5792, EIP-7702 standard support in wallet modules

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to packages/thirdweb/src/wallets/** : Smart wallets with account abstraction

apps/portal/src/app/cli/create/page.mdx (2)

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/tokens/shared-page.tsx:41-48
Timestamp: 2025-05-26T16:28:50.772Z
Learning: The projectMeta prop is not required for the server-rendered ContractTokensPage component in the tokens shared page, unlike some other shared pages where it's needed for consistency.

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/(marketplace)/direct-listings/shared-direct-listings-page.tsx:47-52
Timestamp: 2025-05-26T16:29:54.317Z
Learning: The projectMeta prop is not required for the server-rendered ContractDirectListingsPage component in the direct listings shared page, following the same pattern as other server components in the codebase where projectMeta is only needed for client components.

apps/portal/src/app/payments/send/page.mdx (1)

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Surface breaking changes prominently in PR descriptions

apps/portal/src/app/cli/page.mdx (4)

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to packages/thirdweb/src/exports/** : Export everything via exports/ directory, grouped by feature in the SDK public API

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to src/exports/react.native.ts : React Native specific exports are in src/exports/react.native.ts

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/tokens/shared-page.tsx:41-48
Timestamp: 2025-05-26T16:28:50.772Z
Learning: The projectMeta prop is not required for the server-rendered ContractTokensPage component in the tokens shared page, unlike some other shared pages where it's needed for consistency.

Learnt from: MananTank
PR: #7177
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/public-pages/erc20/erc20.tsx:15-17
Timestamp: 2025-05-27T19:54:55.885Z
Learning: The fetchDashboardContractMetadata function from "@3rdweb-sdk/react/hooks/useDashboardContractMetadata" has internal error handlers for all promises and cannot throw errors, so external error handling is not needed when calling this function.

apps/portal/src/app/cli/upload/page.mdx (1)

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/(marketplace)/direct-listings/shared-direct-listings-page.tsx:47-52
Timestamp: 2025-05-26T16:29:54.317Z
Learning: The projectMeta prop is not required for the server-rendered ContractDirectListingsPage component in the direct listings shared page, following the same pattern as other server components in the codebase where projectMeta is only needed for client components.

🪛 LanguageTool
apps/portal/src/app/cli/logout/page.mdx

[grammar] ~7-~7: Ensure spelling is correct
Context: ...Reference", description: "Learn how to logout of the thirdweb CLI and revoke access f...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (3)
  • GitHub Check: Unit Tests
  • GitHub Check: Size
  • GitHub Check: Analyze (javascript)
🔇 Additional comments (3)
apps/portal/src/app/payments/send/page.mdx (1)

28-30: Title suffix addition looks good for SEO consistency.

The updated title follows the “{Page} | thirdweb documentation” convention used elsewhere, improving brand visibility without exceeding recommended length (~60 chars). No further action required.

apps/portal/src/app/chat/page.tsx (1)

9-15: Indentation-only update is fine

No functional impact detected; component behaviour remains unchanged.

apps/portal/src/app/wallets/faq/page.mdx (1)

12-12: Verify @components/Details path & export shape

@components/* aliases are sometimes case-sensitive (esp. on *nix CI) and may export Details as default rather than named. Double-check that:

  1. The alias actually resolves to .../Details.tsx|mdx.
  2. The component file does export const Details (or export { Details }) and not export default.

A silent resolve failure will hard-crash the page at build time.

Comment on lines +1 to +8
export const metadata = createMetadata({
image: {
title: "thirdweb CLI reference",
icon: "wallets",
},
title: "thirdweb CLI generate | Reference",
description: "Learn how to use the thirdweb CLI to generate type-safe functions and events for deployed contracts.",
});
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Missing import for createMetadata

Same issue as the other CLI pages – pull the helper into scope to keep the MDX compiler happy.

+import { createMetadata } from "@/lib/metadata"; /* adjust if different */
📝 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.

Suggested change
export const metadata = createMetadata({
image: {
title: "thirdweb CLI reference",
icon: "wallets",
},
title: "thirdweb CLI generate | Reference",
description: "Learn how to use the thirdweb CLI to generate type-safe functions and events for deployed contracts.",
});
import { createMetadata } from "@/lib/metadata"; /* adjust if different */
export const metadata = createMetadata({
image: {
title: "thirdweb CLI reference",
icon: "wallets",
},
title: "thirdweb CLI generate | Reference",
description: "Learn how to use the thirdweb CLI to generate type-safe functions and events for deployed contracts.",
});
🤖 Prompt for AI Agents
In apps/portal/src/app/cli/generate/page.mdx lines 1 to 8, the function
createMetadata is used but not imported, causing the MDX compiler to fail. Add
an import statement at the top of the file to bring createMetadata into scope
from its module, matching the import style used in other CLI pages.

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: samina <[email protected]>
@vercel vercel bot temporarily deployed to Preview – nebula July 23, 2025 18:31 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb_playground July 23, 2025 18:31 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb-www July 23, 2025 18:31 Inactive
@vercel vercel bot temporarily deployed to Preview – wallet-ui July 23, 2025 18:31 Inactive
@vercel vercel bot temporarily deployed to Preview – wallet-ui July 23, 2025 18:36 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb-www July 23, 2025 18:36 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb_playground July 23, 2025 18:36 Inactive
@vercel vercel bot temporarily deployed to Preview – nebula July 23, 2025 18:36 Inactive
Copy link

codecov bot commented Jul 23, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 56.36%. Comparing base (7562952) to head (15836f9).
Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #7688      +/-   ##
==========================================
- Coverage   56.38%   56.36%   -0.03%     
==========================================
  Files         908      908              
  Lines       58247    58247              
  Branches     4224     4225       +1     
==========================================
- Hits        32844    32829      -15     
- Misses      25293    25310      +17     
+ Partials      110      108       -2     
Flag Coverage Δ
packages 56.36% <ø> (-0.03%) ⬇️

see 3 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@vercel vercel bot temporarily deployed to Preview – wallet-ui July 23, 2025 18:48 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb-www July 23, 2025 18:48 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb_playground July 23, 2025 18:48 Inactive
@vercel vercel bot temporarily deployed to Preview – nebula July 23, 2025 18:48 Inactive
Copy link
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 (2)
apps/portal/src/app/cli/logout/page.mdx (2)

1-1: Confirm import path & apply spacing nitpick

The spacing inside the named import should follow project style, and please double-check that @doc actually resolves to the module that exports createMetadata.

-import { createMetadata} from "@doc";
+import { createMetadata } from "@doc";

9-9: Grammar tweak: use the verb form “log out”

“Logout” is a noun; as a verb the correct form is “log out”.

-	description: "Learn how to logout of the thirdweb CLI and revoke access from your device.",
+	description: "Learn how to log out of the thirdweb CLI and revoke access from your device.",
📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 23c470a and 15836f9.

📒 Files selected for processing (8)
  • apps/portal/src/app/cli/build/page.mdx (1 hunks)
  • apps/portal/src/app/cli/create/page.mdx (1 hunks)
  • apps/portal/src/app/cli/generate/page.mdx (1 hunks)
  • apps/portal/src/app/cli/install/page.mdx (1 hunks)
  • apps/portal/src/app/cli/login/page.mdx (1 hunks)
  • apps/portal/src/app/cli/logout/page.mdx (1 hunks)
  • apps/portal/src/app/cli/upload/page.mdx (1 hunks)
  • apps/portal/src/app/wallets/faq/page.mdx (2 hunks)
✅ Files skipped from review due to trivial changes (2)
  • apps/portal/src/app/cli/create/page.mdx
  • apps/portal/src/app/cli/install/page.mdx
🚧 Files skipped from review as they are similar to previous changes (5)
  • apps/portal/src/app/cli/login/page.mdx
  • apps/portal/src/app/cli/upload/page.mdx
  • apps/portal/src/app/wallets/faq/page.mdx
  • apps/portal/src/app/cli/build/page.mdx
  • apps/portal/src/app/cli/generate/page.mdx
🧰 Additional context used
🧠 Learnings (2)
📓 Common learnings
Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Surface breaking changes prominently in PR descriptions
apps/portal/src/app/cli/logout/page.mdx (6)

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to apps/{dashboard,playground-web}/**/*.{ts,tsx} : Import UI primitives from @/components/ui/* (Button, Input, Select, Tabs, Card, Sidebar, Badge, Separator) in dashboard and playground apps

Learnt from: jnsdls
PR: #7364
File: apps/dashboard/src/app/(app)/account/components/AccountHeader.tsx:36-41
Timestamp: 2025-06-18T02:13:34.500Z
Learning: In the logout flow in apps/dashboard/src/app/(app)/account/components/AccountHeader.tsx, when doLogout() fails, the cleanup steps (resetAnalytics(), wallet disconnect, router refresh) should NOT execute. This is intentional to maintain consistency - if server-side logout fails, client-side cleanup should not occur.

Learnt from: MananTank
PR: #7434
File: apps/dashboard/src/app/(app)/team///contract/[chain]/[contractAddress]/components/project-selector.tsx:62-76
Timestamp: 2025-06-24T21:38:03.155Z
Learning: In the project-selector.tsx component for contract imports, the addToProject.mutate() call is intentionally not awaited (fire-and-forget pattern) to allow immediate navigation to the contract page while the import happens in the background. This is a deliberate design choice to prioritize user experience.

Learnt from: arcoraven
PR: #7505
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/webhooks/analytics/components/WebhookAnalyticsCharts.tsx:186-204
Timestamp: 2025-07-10T10:18:33.238Z
Learning: The ThirdwebBarChart component in apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/webhooks/analytics/components/WebhookAnalyticsCharts.tsx does not accept standard accessibility props like aria-label and role in its TypeScript interface, causing compilation errors when added.

Learnt from: MananTank
PR: #7315
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/assets/create/nft/launch-nft.tsx:153-226
Timestamp: 2025-06-10T00:50:20.795Z
Learning: In apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/assets/create/nft/launch-nft.tsx, the updateStatus function correctly expects a complete MultiStepState["status"] object. For pending states, { type: "pending" } is the entire status object. For error states, { type: "error", message: React.ReactNode } is the entire status object. The current code incorrectly spreads the entire step object instead of passing just the status object.

Learnt from: CR
PR: thirdweb-dev/js#0
File: CLAUDE.md:0-0
Timestamp: 2025-07-18T19:19:55.613Z
Learning: Applies to apps/{dashboard,playground-web}/**/*.{ts,tsx} : Server Components (Node edge): Start files with import "server-only";

🪛 LanguageTool
apps/portal/src/app/cli/logout/page.mdx

[grammar] ~9-~9: Ensure spelling is correct
Context: ...Reference", description: "Learn how to logout of the thirdweb CLI and revoke access f...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Size
🔇 Additional comments (1)
apps/portal/src/app/cli/logout/page.mdx (1)

3-10: Metadata structure looks solid

No functional issues spotted with the metadata object; matches the pattern used across other CLI pages.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Portal Involves changes to the Portal (docs) codebase.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant