Update playground slugs and add redirects #7696

saminacodes · 2025-07-24T15:10:30Z

<!--

## title your PR with this format: "[SDK/Dashboard/Portal] Feature/Fix: Concise title for the changes"

## [Playground/Dashboard/Portal] Feature: Refactor Playground URL slugs and add redirects

If you did not copy the branch name from Linear, paste the issue tag here (format is TEAM-0000):

## Notes for the reviewer

This PR refactors the URL slugs for `playground.thirdweb.com` to improve semantic clarity and organization.

Key changes include:
- `/engine/*` is now `/transactions/*`
- `/connect/pay/*` is now `/payments/*`
- `/connect/*` (excluding `/pay`) is now `/wallets/*`

Redirects have been added in `next.config.mjs` to ensure backward compatibility for all old URLs. All internal links and imports across `playground-web`, `dashboard`, `portal`, and `thirdweb` packages have been updated to reflect the new structure.

## How to test

1.  Verify new URLs load correctly:
    -   `playground.thirdweb.com/transactions/airdrop`
    -   `playground.thirdweb.com/payments/commerce`
    -   `playground.thirdweb.com/wallets/sign-in/button`
2.  Verify old URLs redirect correctly to their new counterparts:
    -   `playground.thirdweb.com/engine/airdrop` (should redirect to `/transactions/airdrop`)
    -   `playground.thirdweb.com/connect/pay/commerce` (should redirect to `/payments/commerce`)
    -   `playground.thirdweb.com/connect/sign-in/button` (should redirect to `/wallets/sign-in/button`)
3.  Check navigation links in Dashboard and Portal that point to Playground to ensure they still function correctly.

-->

Slack Thread • Open in Web • Open in Cursor

PR-Codex overview

This PR primarily focuses on renaming and restructuring routes and links from /connect to /wallets and /payments, updating the relevant components and constants throughout the application for consistency.

Detailed summary

Changed redirect paths from /connect/... to /wallets/... in various components.
Updated sidebar links to point to new /wallets/... routes.
Adjusted backend references from /connect/pay/... to /payments/....
Refactored imports related to authentication actions from /connect/auth/... to /wallets/auth/....
Modified breadcrumb links and navigation links to reflect new paths.
Updated constants and UI components to ensure they align with the new routing structure.

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

Summary by CodeRabbit

Bug Fixes
- Updated various navigation and footer links across the dashboard, playground, and portal apps to reflect new URL structures for Wallets, Payments, and Transactions sections.
- Adjusted redirect rules and import paths to align with reorganized route prefixes and folder structures.
- Ensured all sidebar and authentication-related links now point to their correct, updated destinations for a consistent user experience.

Co-authored-by: samina <[email protected]>

changeset-bot · 2025-07-24T15:10:35Z

⚠️ No Changeset found

Latest commit: 9092e1b

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

vercel · 2025-07-24T15:10:35Z

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

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

coderabbitai · 2025-07-24T15:10:39Z

Walkthrough

This update systematically changes URL paths and import paths throughout the codebase to reflect a migration from legacy route prefixes (such as /connect, /engine, and /connect/pay) to new, category-specific prefixes (/wallets, /payments, /transactions). Redirects, navigation links, authentication imports, and sidebar configurations are all updated accordingly. No functional logic or exported entity signatures are changed.

Changes

File(s)	Change Summary
apps/dashboard/src/app/(app)/team/[team_slug]/(team)/TeamSidebarLayout.tsx apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/components/ProjectSidebarLayout.tsx	Updated "Playground" sidebar footer link URL from `/connect/sign-in/button` to `/wallets/sign-in/button`.
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/AAFooterSection.tsx	Updated footer links from `/connect/account-abstraction/` to `/wallets/account-abstraction/`.
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/factories/AccountFactories/index.tsx	Changed UnderlineLink URL from `/connect/account-abstraction/connect` to `/wallets/account-abstraction/sponsor`.
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx	Updated UBFooter links from `/connect/pay` to `/payments`.
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/wallets/_components/footer.tsx	Updated footer links from `/connect/in-app-wallet` to `/wallets/in-app-wallet` and `/wallets/account-abstraction`.
apps/playground-web/next.config.mjs	Updated redirect rules from `/connect` to `/wallets`, `/payments`, `/transactions`; added new legacy redirect rules.
apps/playground-web/src/app/navLinks.ts	Updated sidebar link hrefs: `/connect/...` → `/wallets/...`, `/connect/pay/...` → `/payments/...`, `/engine/...` → `/transactions/...`.
apps/playground-web/src/app/page.tsx	Changed redirect from `/connect/sign-in/button` to `/wallets/sign-in/button`.
apps/playground-web/src/app/payments/backend/page.tsx	Updated link property from `/connect/pay/backend/reference?...` to `/payments/backend/reference?...`.
apps/playground-web/src/app/payments/backend/reference/page.tsx	Updated all `/connect/pay/backend` paths to `/payments/backend` in redirects, breadcrumbs, and props.
apps/playground-web/src/app/transactions/airdrop/page.tsx apps/playground-web/src/app/transactions/minting/page.tsx apps/playground-web/src/app/transactions/webhooks/page.tsx	Changed import paths from `/engine/...` to `/transactions/...` for preview components.
apps/playground-web/src/app/wallets/auth/page.tsx apps/playground-web/src/components/auth/auth-button.tsx apps/playground-web/src/components/auth/auth-hook.tsx apps/playground-web/src/components/auth/smart-account-auth-button.tsx	Changed auth import paths from `/connect/auth/server/actions/auth` to `/wallets/auth/server/actions/auth`.
apps/playground-web/src/components/auth/gated-content.tsx	Changed auth import path and updated a Link URL from `/connect/blockchain-api` to `/wallets/blockchain-api`.
apps/playground-web/src/components/in-app-wallet/custom-login-form.tsx	Changed Google login redirect from `/connect/in-app-wallet` to `/wallets/in-app-wallet`.
apps/portal/src/app/engine/v2/sidebar.tsx apps/portal/src/app/engine/v3/sidebar.tsx	Changed "Playground" sidebar link from `/engine/airdrop` to `/transactions/airdrop`.
packages/thirdweb/src/react/web/ui/ConnectWallet/PoweredByTW.tsx	Changed fallback link from `/connect/sign-in/button?...` to `/wallets/sign-in/button?...`.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant App
    participant PlaygroundWeb
    participant Dashboard
    participant Portal

    User->>App: Clicks sidebar/footer/navigation link
    App->>PlaygroundWeb: Navigates to new /wallets, /payments, or /transactions path
    PlaygroundWeb->>PlaygroundWeb: Handles route or applies redirect (if legacy path used)
    PlaygroundWeb->>User: Displays requested page

    Note over App,PlaygroundWeb: All internal and external links now use updated route prefixes

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

Portal

Suggested reviewers

joaquim-verges

Note

⚡️ Unit Test Generation is now available in beta!

Learn more here, or try it out under "Finishing Touches" below.

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.

✨ Finishing Touches

📝 Generate Docstrings

🧪 Generate unit tests

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch cursor/update-playground-slugs-and-add-redirects-e9d6

🪧 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 generate unit tests to generate unit tests for 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.

graphite-app · 2025-07-24T15:10:45Z

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

merge-queue - adds this PR to the back of the merge queue
hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

_{An organization admin has enabled the Graphite Merge Queue in this repository.} _{Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.}

coderabbitai

Actionable comments posted: 1

🔭 Outside diff range comments (2)

apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/factories/AccountFactories/index.tsx (1)

42-46: Update remaining playground links to the new slug

We still have hard-coded links pointing at
https://playground.thirdweb.com/connect/account-abstraction/*
that need to be updated to
https://playground.thirdweb.com/wallets/account-abstraction/*.

Please update the following files:

apps/portal/src/app/react/v5/account-abstraction/get-started/page.mdx
• Line 43: replace /connect/account-abstraction/connect
• Line 50: replace /connect/account-abstraction/connect

apps/portal/src/app/react/v5/in-app-wallet/enable-gasless/page.mdx
• Line 34: replace /connect/account-abstraction/sponsor
• Line 41: replace /connect/account-abstraction/sponsor

The links in apps/dashboard/... already use the wallets/account-abstraction slug and can remain unchanged.
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx (1)
108-111: Update stale Portal docs link

The old URL now issues a 308 redirect to /payments. To avoid unnecessary redirects, update the link:

• File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx
Lines ~108–111
-           href: "https://portal.thirdweb.com/connect/pay/overview",
+           href: "https://portal.thirdweb.com/payments",
No other occurrences of /connect/pay were found in the codebase.

🧹 Nitpick comments (3)

apps/playground-web/src/app/transactions/minting/page.tsx (1)

1-1: Component prefix now mismatched with folder name

The component is still called EngineMintPreview, but it now lives under a /transactions/… path. Renaming the symbol to TransactionsMintPreview (and updating references) would avoid the lingering “Engine” terminology and keep the mental model tidy.

apps/playground-web/src/app/transactions/airdrop/page.tsx (1)

1-1: Rename component for clarity

Same note as the mint page: consider renaming EngineAirdropPreview to match the new “transactions” context to prevent confusion.

apps/playground-web/src/app/transactions/webhooks/page.tsx (1)

1-1: Stale “Engine” prefix in component name

EngineWebhooksPreview still carries the old prefix. A follow-up rename keeps nomenclature consistent with the /transactions scope.

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 66b9bf3 and 9092e1b.

⛔ Files ignored due to path filters (2)

apps/playground-web/src/app/payments/opengraph-image.png is excluded by !**/*.png
apps/playground-web/src/app/wallets/sign-in/opengraph-image.png is excluded by !**/*.png

📒 Files selected for processing (23)

apps/dashboard/src/app/(app)/team/[team_slug]/(team)/TeamSidebarLayout.tsx (1 hunks)
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/AAFooterSection.tsx (1 hunks)
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/factories/AccountFactories/index.tsx (1 hunks)
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/components/ProjectSidebarLayout.tsx (1 hunks)
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx (1 hunks)
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/wallets/_components/footer.tsx (1 hunks)
apps/playground-web/next.config.mjs (1 hunks)
apps/playground-web/src/app/navLinks.ts (3 hunks)
apps/playground-web/src/app/page.tsx (1 hunks)
apps/playground-web/src/app/payments/backend/page.tsx (1 hunks)
apps/playground-web/src/app/payments/backend/reference/page.tsx (4 hunks)
apps/playground-web/src/app/transactions/airdrop/page.tsx (1 hunks)
apps/playground-web/src/app/transactions/minting/page.tsx (1 hunks)
apps/playground-web/src/app/transactions/webhooks/page.tsx (1 hunks)
apps/playground-web/src/app/wallets/auth/page.tsx (4 hunks)
apps/playground-web/src/components/auth/auth-button.tsx (1 hunks)
apps/playground-web/src/components/auth/auth-hook.tsx (1 hunks)
apps/playground-web/src/components/auth/gated-content.tsx (2 hunks)
apps/playground-web/src/components/auth/smart-account-auth-button.tsx (1 hunks)
apps/playground-web/src/components/in-app-wallet/custom-login-form.tsx (1 hunks)
apps/portal/src/app/engine/v2/sidebar.tsx (1 hunks)
apps/portal/src/app/engine/v3/sidebar.tsx (1 hunks)
packages/thirdweb/src/react/web/ui/ConnectWallet/PoweredByTW.tsx (1 hunks)

🧰 Additional context used

📓 Path-based instructions (3)

**/*.{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/playground-web/src/app/transactions/webhooks/page.tsx
apps/playground-web/src/components/auth/auth-button.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx
apps/playground-web/src/app/payments/backend/reference/page.tsx
apps/playground-web/src/app/transactions/airdrop/page.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/AAFooterSection.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/factories/AccountFactories/index.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/(team)/TeamSidebarLayout.tsx
apps/playground-web/src/app/transactions/minting/page.tsx
apps/portal/src/app/engine/v3/sidebar.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/wallets/_components/footer.tsx
apps/playground-web/src/app/navLinks.ts
apps/playground-web/src/components/in-app-wallet/custom-login-form.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/components/ProjectSidebarLayout.tsx
packages/thirdweb/src/react/web/ui/ConnectWallet/PoweredByTW.tsx
apps/playground-web/src/components/auth/auth-hook.tsx
apps/portal/src/app/engine/v2/sidebar.tsx
apps/playground-web/src/app/page.tsx
apps/playground-web/src/app/wallets/auth/page.tsx
apps/playground-web/src/components/auth/gated-content.tsx
apps/playground-web/src/components/auth/smart-account-auth-button.tsx
apps/playground-web/src/app/payments/backend/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/playground-web/src/app/transactions/webhooks/page.tsx
apps/playground-web/src/components/auth/auth-button.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx
apps/playground-web/src/app/payments/backend/reference/page.tsx
apps/playground-web/src/app/transactions/airdrop/page.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/AAFooterSection.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/factories/AccountFactories/index.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/(team)/TeamSidebarLayout.tsx
apps/playground-web/src/app/transactions/minting/page.tsx
apps/portal/src/app/engine/v3/sidebar.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/wallets/_components/footer.tsx
apps/playground-web/src/app/navLinks.ts
apps/playground-web/src/components/in-app-wallet/custom-login-form.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/components/ProjectSidebarLayout.tsx
packages/thirdweb/src/react/web/ui/ConnectWallet/PoweredByTW.tsx
apps/playground-web/src/components/auth/auth-hook.tsx
apps/portal/src/app/engine/v2/sidebar.tsx
apps/playground-web/src/app/page.tsx
apps/playground-web/src/app/wallets/auth/page.tsx
apps/playground-web/src/components/auth/gated-content.tsx
apps/playground-web/src/components/auth/smart-account-auth-button.tsx
apps/playground-web/src/app/payments/backend/page.tsx

apps/{dashboard,playground-web}/**/*.{ts,tsx}

📄 CodeRabbit Inference Engine (CLAUDE.md)

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
Use NavLink for internal navigation with automatic active states in dashboard and playground apps
Use Tailwind CSS only – no inline styles or CSS modules
Use cn() from @/lib/utils for conditional class logic
Use design system tokens (e.g., bg-card, border-border, text-muted-foreground)
Server Components (Node edge): Start files with import "server-only";
Client Components (browser): Begin files with 'use client';
Always call getAuthToken() to retrieve JWT from cookies on server side
Use Authorization: Bearer header – never embed tokens in URLs
Return typed results (e.g., Project[], User[]) – avoid any
Wrap client-side data fetching calls in React Query (@tanstack/react-query)
Use descriptive, stable queryKeys for React Query cache hits
Configure staleTime/cacheTime in React Query based on freshness (default ≥ 60s)
Keep tokens secret via internal API routes or server actions
Never import posthog-js in server components

Files:

apps/playground-web/src/app/transactions/webhooks/page.tsx
apps/playground-web/src/components/auth/auth-button.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx
apps/playground-web/src/app/payments/backend/reference/page.tsx
apps/playground-web/src/app/transactions/airdrop/page.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/AAFooterSection.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/account-abstraction/factories/AccountFactories/index.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/(team)/TeamSidebarLayout.tsx
apps/playground-web/src/app/transactions/minting/page.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/wallets/_components/footer.tsx
apps/playground-web/src/app/navLinks.ts
apps/playground-web/src/components/in-app-wallet/custom-login-form.tsx
apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/components/ProjectSidebarLayout.tsx
apps/playground-web/src/components/auth/auth-hook.tsx
apps/playground-web/src/app/page.tsx
apps/playground-web/src/app/wallets/auth/page.tsx
apps/playground-web/src/components/auth/gated-content.tsx
apps/playground-web/src/components/auth/smart-account-auth-button.tsx
apps/playground-web/src/app/payments/backend/page.tsx

🧠 Learnings (24)

📓 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

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} : Use `NavLink` for internal navigation with automatic active states in dashboard and playground apps

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/** : Unified `Wallet` and `Account` interfaces in wallet architecture

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/** : Support for in-app wallets (social/email login)

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 : Prefer API routes or server actions to keep tokens secret; the browser only sees relative paths.

apps/playground-web/src/app/transactions/webhooks/page.tsx (15)

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: 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";

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} : Never import posthog-js in server components

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} : Use NavLink for internal navigation with automatic active states in dashboard and playground apps

Learnt from: jnsdls
PR: #6929
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/insight/webhooks/page.tsx:14-19
Timestamp: 2025-05-21T05:17:31.283Z
Learning: In Next.js server components, the params object can sometimes be a Promise that needs to be awaited, despite type annotations suggesting otherwise. In apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/insight/webhooks/page.tsx, it's necessary to await the params object before accessing its properties.

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} : Client Components (browser): Begin files with 'use 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/**/*.{ts,tsx} : Client-side only: never import posthog-js in server 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/**/*client.tsx : Anything that consumes hooks from @tanstack/react-query or thirdweb SDKs.

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/**/layout.tsx : Building layout shells (layout.tsx) and top-level pages that mainly assemble data.

Learnt from: MananTank
PR: #7227
File: apps/dashboard/src/app/(app)/(dashboard)/(chain)/[chain_id]/[contractAddress]/modules/components/OpenEditionMetadata.tsx:26-26
Timestamp: 2025-05-30T17:14:25.332Z
Learning: The ModuleCardUIProps interface already includes a client prop of type ThirdwebClient, so when components use Omit<ModuleCardUIProps, "children" | "updateButton">, they inherit the client prop without needing to add it explicitly.

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} : Layouts should reuse SidebarLayout / FullWidthSidebarLayout (@/components/blocks/SidebarLayout).

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: #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.

apps/playground-web/src/components/auth/auth-button.tsx (15)

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 : Prefer API routes or server actions to keep tokens secret; the browser only sees relative paths.

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} : Always call getAuthToken() to retrieve JWT from cookies on server side

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";

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: 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} : Keep tokens secret via internal API routes or server actions

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} : Use NavLink for internal navigation with automatic active states in dashboard and playground apps

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//api//*.{ts,tsx} : Always call getAuthToken() to get the JWT from cookies.

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: 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} : Use Authorization: Bearer header – never embed tokens in URLs

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: MananTank
PR: #7285
File: apps/dashboard/src/app/(app)/(dashboard)/published-contract/components/uri-based-deploy.tsx:57-57
Timestamp: 2025-06-05T13:59:49.886Z
Learning: In the thirdweb dashboard Next.js app, when using loginRedirect() in server components, ensure to add a return statement after the redirect call to prevent further code execution and potential security issues.

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 : Create light wrappers (e.g. fetchJson) that automatically attach the JWT from cookies/session when calling internal API routes.

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

apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/universal-bridge/layout.tsx (12)

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} : Use NavLink for internal navigation with automatic active states in dashboard and playground apps

Learnt from: MananTank
PR: #7315
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/assets/create/nft/launch-nft.tsx:155-160
Timestamp: 2025-06-10T00:46:58.580Z
Learning: In the dashboard application, the route structure for team and project navigation is /team/[team_slug]/[project_slug]/... without a /project/ segment. Contract links should be formatted as /team/${teamSlug}/${projectSlug}/contract/${chainId}/${contractAddress}.

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} : Use NavLink (@/components/ui/NavLink) for internal navigation so active states are handled automatically.

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: 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: .cursor/rules/dashboard.mdc:0-0
Timestamp: 2025-07-18T19:20:32.530Z
Learning: Applies to dashboard/**/*.{tsx,jsx} : Layouts should reuse SidebarLayout / FullWidthSidebarLayout (@/components/blocks/SidebarLayout).

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} : Always import from the central UI library under @/components/ui/* – e.g. import { Button } from "@/components/ui/button".

Learnt from: MananTank
PR: #7152
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/contract/[chainIdOrSlug]/[contractAddress]/nfts/page.tsx:20-20
Timestamp: 2025-05-26T16:26:58.068Z
Learning: In team/project contract pages under routes like /team/[team_slug]/[project_slug]/contract/[chainIdOrSlug]/[contractAddress]/*, users are always logged in by design. The hardcoded isLoggedIn={true} prop in these pages is intentional and correct, not a bug to be fixed.

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} : Use design system tokens (e.g., bg-card, border-border, text-muted-foreground)

Learnt from: jnsdls
PR: #7365
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/components/ProjectFTUX/ProjectFTUX.tsx:16-17
Timestamp: 2025-06-18T04:30:04.326Z
Learning: Next.js Link component fully supports both internal and external URLs and works appropriately with all standard anchor attributes including target="_blank", rel="noopener noreferrer", etc. Using Link for external URLs is completely appropriate and recommended.

Learnt from: jnsdls
PR: #7365
File: apps/dashboard/src/app/(app)/team/[team_slug]/[project_slug]/(sidebar)/components/ProjectFTUX/ProjectFTUX.tsx:16-17
Timestamp: 2025-06-18T04:27:16.172Z
Learning: Next.js Link component supports external URLs without throwing errors. When used with absolute URLs (like https://...), it behaves like a regular anchor tag without client-side routing, but does not cause runtime crashes or errors as previously believed.

apps/playground-web/src/app/payments/backend/reference/page.tsx (17)

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} : Use NavLink for internal navigation with automatic active states in dashboard and playground apps

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/**/*.{ts,tsx} : Redirect logic using redirect() from next/navigation.