From 533e73d38960a21916b8e1878b649e63d3723a93 Mon Sep 17 00:00:00 2001
From: ddtrvlr <117272307+wearedood@users.noreply.github.com>
Date: Fri, 15 Aug 2025 14:22:16 +0200
Subject: [PATCH 1/2] Add Prerequisites section to build-app documentation

Resolves #203

Added a comprehensive Prerequisites section to the build-app.mdx documentation including:
- Node.js version requirements
- Package manager options (npm/yarn)
- Code editor recommendations
- Required knowledge prerequisites
- Helpful tip linking to Base overview

This improvement enhances the developer experience by clearly outlining what's needed before starting the Base app building tutorial.
---
 docs/get-started/build-app.mdx | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/get-started/build-app.mdx b/docs/get-started/build-app.mdx
index 4a561e31..14029004 100644
--- a/docs/get-started/build-app.mdx
+++ b/docs/get-started/build-app.mdx
@@ -5,6 +5,20 @@ description: A guide to building a next.js app on Base using OnchainKit
 
 Welcome to the Base quickstart guide! In this walkthrough, we'll create a simple onchain app from start to finish. Whether you're a seasoned developer or just starting out, this guide has got you covered.
 
+## Prerequisites
+
+Before you begin, make sure you have the following installed:
+
+- [Node.js](https://nodejs.org/) (version 18 or higher)
+- [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/)
+- A code editor like [VS Code](https://code.visualstudio.com/)
+- Basic knowledge of React and Next.js
+
+:::tip
+New to Base? Check out our [Base overview](/base-overview) to learn more about the Base network.
+:::
+
+
 ## What You'll Achieve
 
 By the end of this quickstart, you'll have built an onchain app by:

From 390d7c8d64235c55ea33826fec3090fc6c534d9c Mon Sep 17 00:00:00 2001
From: ddtrvlr <117272307+wearedood@users.noreply.github.com>
Date: Wed, 19 Nov 2025 13:10:36 +0100
Subject: [PATCH 2/2] docs(troubleshooting): add Coinbase wallet verification
 section - resolves #658

Added troubleshooting steps for Coinbase wallet verification issues, including browser troubleshooting, alternative verification methods, known issues, and support resources.
---
 docs/onchainkit/guides/troubleshooting.mdx | 31 ++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/docs/onchainkit/guides/troubleshooting.mdx b/docs/onchainkit/guides/troubleshooting.mdx
index c3f30361..faf5e2af 100644
--- a/docs/onchainkit/guides/troubleshooting.mdx
+++ b/docs/onchainkit/guides/troubleshooting.mdx
@@ -132,6 +132,37 @@ This guide covers common issues you may encounter while using OnchainKit. If you
   - Error: "Cannot find module ... or its corresponding type declarations. Consider updating to 'node16', 'nodenext', or 'bundler'"
   - Solution: Update your Node.js version or use a compatible bundler. We recommend using Node 18+ and `"moduleResolution": "NodeNext"` for the best developer experience. OnchainKit supports only ES Modules and does not support CommonJS modules.
 
+
+### Coinbase Wallet Verification Issues
+
+If you're experiencing issues with Coinbase wallet verification on guild.xyz or similar platforms, try these troubleshooting steps:
+
+#### Browser Troubleshooting
+
+- **Clear browser cache and cookies**: Clear your browser's cache and cookies, then restart the browser
+- **Disable browser extensions**: Temporarily disable ad blockers and other extensions that might interfere with wallet connections
+- **Try incognito/private mode**: Test the verification process in a private browsing window
+- **Update your browser**: Ensure you're using the latest version of your browser
+
+#### Alternative Verification Methods
+
+- **Use different browser**: Try Chrome, Firefox, or Safari if you're experiencing issues
+- **Mobile verification**: If available, try verifying through the mobile app instead of desktop
+- **Direct wallet connection**: Connect your wallet directly to the platform instead of using third-party verification
+
+#### Known Issues
+
+- **Network congestion**: High network traffic can cause verification timeouts
+- **Wallet extension conflicts**: Multiple wallet extensions can interfere with each other
+- **Platform-specific issues**: Some platforms may have temporary verification issues
+
+#### Getting Support
+
+- **Check platform status**: Visit the platform's status page or social media for known issues
+- **Contact platform support**: Reach out to the specific platform's support team
+- **Coinbase support**: For wallet-specific issues, contact Coinbase Wallet support
+- **Community forums**: Check Discord or Telegram communities for similar issues and solutions
+
 ## Getting Help
 
 Need more help?