docs: add comprehensive troubleshooting section for Azul network upgrade

README.md

@@ -164,3 +164,6 @@ The core team will review opened PRs. The SLA is 2 weeks, generally on a first-c
 ## Storybook for UI components
 
 See `storybook/README.md` for details on local Storybook and component docs.
+## Additional Note
+
+When building on Base, always ensure that you are using the correct RPC endpoint for the intended network (mainnet or testnet). Misconfiguration can lead to failed transactions or unexpected behavior.

docs/.mintignore

@@ -1,11 +1,4 @@
 # Exclude specific files
 writing.md
 
-# Hidden apps sections (redirected to migrate-to-standard-web-app)
-/apps/core-concepts/*
-/apps/resources/*
-/apps/featured-guidelines/*
-/apps/troubleshooting/*
-/apps/introduction/*
-/apps/growth/build-viral-apps
-/apps/growth/optimize-onboarding
+

docs/ai-agents/setup/agent-builder-codes.mdx

@@ -109,5 +109,5 @@ No authentication required.
 Returns the builder code for the given wallet. The same wallet address always returns the same code and is safe to call multiple times.
 
 ## Further reading
-- [Builder Codes Overview](/base-chain/builder-codes/builder-codes) - What Builder Codes are, how ERC-8021 attribution works, and FAQs on gas, identity, and wallet support
-- [Builder Codes for Agent Developers](/base-chain/builder-codes/agent-developers) - API reference, skill reference, and overview
+- [Builder Codes Overview](/apps/builder-codes/builder-codes) - What Builder Codes are, how ERC-8021 attribution works, and FAQs on gas, identity, and wallet support
+- [Builder Codes for Agent Developers](/apps/builder-codes/agent-developers) - API reference, skill reference, and overview

docs/base-chain/builder-codes/builder-codes.mdx → docs/apps/builder-codes/builder-codes.mdx

@@ -16,13 +16,13 @@ Each code has associated metadata. Onchain metadata primarily includes a "payout
 ## Integration Guides
 
 <CardGroup cols={3}>
-  <Card title="For App Developers" icon="code" href="/base-chain/builder-codes/app-developers">
+  <Card title="For App Developers" icon="code" href="/apps/builder-codes/app-developers">
     Integrate Builder Codes using Wagmi or Viem
   </Card>
-  <Card title="For Wallet Developers" icon="wallet" href="/base-chain/builder-codes/wallet-developers">
+  <Card title="For Wallet Developers" icon="wallet" href="/apps/builder-codes/wallet-developers">
     Implement the dataSuffix capability
   </Card>
-  <Card title="For Agent Developers" icon="robot" href="/base-chain/builder-codes/agent-developers">
+  <Card title="For Agent Developers" icon="robot" href="/apps/builder-codes/agent-developers">
     Attribute your AI agent's transactions via the API
   </Card>
 </CardGroup>