Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/get-started/build-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
31 changes: 31 additions & 0 deletions docs/onchainkit/guides/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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?
Expand Down