diff --git a/docs/get-started/build-app.mdx b/docs/get-started/build-app.mdx index 4a561e319..140290041 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: diff --git a/docs/onchainkit/guides/troubleshooting.mdx b/docs/onchainkit/guides/troubleshooting.mdx index c3f303615..faf5e2af9 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?