move builder codes (#1305)

roethke · web-flow · commit 6c841570dece · 2026-04-13T20:12:17.000+02:00
diff --git a/docs/ai-agents/setup/agent-builder-codes.mdx b/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
diff --git a/docs/apps/builder-codes/agent-developers.mdx b/docs/apps/builder-codes/agent-developers.mdx
diff --git a/docs/apps/builder-codes/app-developers.mdx b/docs/apps/builder-codes/app-developers.mdx
diff --git a/docs/apps/builder-codes/builder-codes.mdx b/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>
diff --git a/docs/apps/builder-codes/wallet-developers.mdx b/docs/apps/builder-codes/wallet-developers.mdx
diff --git a/docs/apps/quickstart/migrate-to-standard-web-app.mdx b/docs/apps/quickstart/migrate-to-standard-web-app.mdx
@@ -22,7 +22,7 @@ The Base App is moving from the Farcaster mini-app spec to a single model: **sta
 | Neynar webhooks for add/remove events | Base-owned backends (Base Account / address preferences) |
 | FID-based notifications via Neynar | Wallet-address notifications via Base.dev notifications API *(coming soon)* |
 | Farcaster SDK for auth and actions | wagmi + viem + Sign-In with Ethereum (SIWE) |
-| Search and discovery via Farcaster | Base.dev app metadata + [builder codes](https://docs.base.org/base-chain/builder-codes/builder-codes) |
+| Search and discovery via Farcaster | Base.dev app metadata + [builder codes](https://docs.base.org/apps/builder-codes/builder-codes) |
 
 ---
 
@@ -173,7 +173,7 @@ Your app uses the Farcaster SDK. The migration replaces Farcaster-specific auth,
 </Step>
 
 <Step title="Register on Base.dev">
-  If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/base-chain/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
+  If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/apps/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
 </Step>
 </Steps>
 
@@ -193,7 +193,7 @@ Your app is already a standard web app. You're mostly done — just verify your
 </Step>
 
 <Step title="Register on Base.dev">
-  If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/base-chain/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
+  If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/apps/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
 </Step>
 
 <Step title="Integrate notifications (optional)">
@@ -246,7 +246,7 @@ Before considering your app migrated, verify the following:
 </Step>
 
 <Step title="Register and complete Base.dev metadata">
-  Project is registered on [Base.dev](https://www.base.dev) with primary URL set. Name, icon, tagline, screenshots, category, description, and [builder code](/base-chain/builder-codes/builder-codes) are all filled in.
+  Project is registered on [Base.dev](https://www.base.dev) with primary URL set. Name, icon, tagline, screenshots, category, description, and [builder code](/apps/builder-codes/builder-codes) are all filled in.
 </Step>
 
 <Step title="Notifications use Base.dev API (if applicable)">
diff --git a/docs/base-account/reference/core/capabilities/dataSuffix.mdx b/docs/base-account/reference/core/capabilities/dataSuffix.mdx
@@ -103,7 +103,7 @@ When a wallet receives a `dataSuffix` capability, the suffix is appended to `use
 
 ### Builder Codes Attribution
 
-The primary use case for `dataSuffix` is [Builder Codes](/base-chain/builder-codes/builder-codes) attribution. Builder Codes are unique identifiers that allow apps to receive attribution for onchain activity they generate.
+The primary use case for `dataSuffix` is [Builder Codes](/apps/builder-codes/builder-codes) attribution. Builder Codes are unique identifiers that allow apps to receive attribution for onchain activity they generate.
 
 ```typescript
 import { Attribution } from "ox/erc8021";
@@ -144,7 +144,7 @@ Register on [base.dev](https://base.dev) to get your Builder Code for proper att
 3. **Keep suffixes small**: Larger suffixes increase gas costs
 
 <Info>
-For wallet developers implementing dataSuffix support, see the [For Wallet Developers](/base-chain/builder-codes/builder-codes#for-wallet-developers) section in the Builder Codes guide.
+For wallet developers implementing dataSuffix support, see the [For Wallet Developers](/apps/builder-codes/builder-codes#for-wallet-developers) section in the Builder Codes guide.
 </Info>
 
 ## Related Capabilities
diff --git a/docs/base-chain/llms-full.txt b/docs/base-chain/llms-full.txt
@@ -54,10 +54,10 @@
 - [Node Providers](https://docs.base.org/base-chain/node-operators/node-providers.md) — RPC node providers for Base
 
 ### Builder Codes
-- [Builder Codes](https://docs.base.org/base-chain/builder-codes/builder-codes.md) — Overview of the Builder Codes program
-- [App Developers](https://docs.base.org/base-chain/builder-codes/app-developers.md) — Builder Codes for app developers
-- [Wallet Developers](https://docs.base.org/base-chain/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
-- [Agent Developers](https://docs.base.org/base-chain/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
+- [Builder Codes](https://docs.base.org/apps/builder-codes/builder-codes.md) — Overview of the Builder Codes program
+- [App Developers](https://docs.base.org/apps/builder-codes/app-developers.md) — Builder Codes for app developers
+- [Wallet Developers](https://docs.base.org/apps/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
+- [Agent Developers](https://docs.base.org/apps/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
 
 ### Security
 - [Security Council](https://docs.base.org/base-chain/security/security-council.md) — Security governance
diff --git a/docs/base-chain/llms.txt b/docs/base-chain/llms.txt
@@ -38,10 +38,10 @@
 - [Security Council](https://docs.base.org/base-chain/security/security-council.md) — Governance and process overview
 
 ## Builder Codes
-- [Builder Codes](https://docs.base.org/base-chain/builder-codes/builder-codes.md) — Overview of the Builder Codes program
-- [App Developers](https://docs.base.org/base-chain/builder-codes/app-developers.md) — Builder Codes for app developers
-- [Wallet Developers](https://docs.base.org/base-chain/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
-- [Agent Developers](https://docs.base.org/base-chain/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
+- [Builder Codes](https://docs.base.org/apps/builder-codes/builder-codes.md) — Overview of the Builder Codes program
+- [App Developers](https://docs.base.org/apps/builder-codes/app-developers.md) — Builder Codes for app developers
+- [Wallet Developers](https://docs.base.org/apps/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
+- [Agent Developers](https://docs.base.org/apps/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
 
 ## Optional
 - [Ecosystem Contracts](https://docs.base.org/base-chain/network-information/ecosystem-contracts.md) — Common ecosystem contract addresses
diff --git a/docs/docs.json b/docs/docs.json
@@ -149,15 +149,6 @@
               "base-chain/node-operators/troubleshooting"
             ]
           },
-          {
-            "group": "Builder Codes",
-            "pages": [
-              "base-chain/builder-codes/builder-codes",
-              "base-chain/builder-codes/app-developers",
-              "base-chain/builder-codes/wallet-developers",
-              "base-chain/builder-codes/agent-developers"
-            ]
-          },
           {
             "group": "API Reference",
             "pages": [
@@ -587,6 +578,15 @@
             "pages": [
               "apps/technical-guides/base-notifications"
             ]
+          },
+          {
+            "group": "Builder Codes",
+            "pages": [
+              "apps/builder-codes/builder-codes",
+              "apps/builder-codes/app-developers",
+              "apps/builder-codes/wallet-developers",
+              "apps/builder-codes/agent-developers"
+            ]
           }
         ]
       },
@@ -1563,28 +1563,28 @@
       "destination": "/base-chain/network-information/bridges"
     },
     {
-      "source": "/base-chain/builder-codes/builder-codes-faq",
-      "destination": "/base-chain/builder-codes/builder-codes"
+      "source": "/apps/builder-codes/builder-codes-faq",
+      "destination": "/apps/builder-codes/builder-codes"
     },
     {
       "source": "/base-chain/quickstart/builder-codes",
-      "destination": "/base-chain/builder-codes/builder-codes"
+      "destination": "/apps/builder-codes/builder-codes"
     },
     {
-      "source": "/base-chain/builder-codes/builder-codes-app-developers",
-      "destination": "/base-chain/builder-codes/app-developers"
+      "source": "/apps/builder-codes/builder-codes-app-developers",
+      "destination": "/apps/builder-codes/app-developers"
     },
     {
-      "source": "/base-chain/builder-codes/builder-codes-wallet-developers",
-      "destination": "/base-chain/builder-codes/wallet-developers"
+      "source": "/apps/builder-codes/builder-codes-wallet-developers",
+      "destination": "/apps/builder-codes/wallet-developers"
     },
     {
-      "source": "/base-chain/builder-codes/builder-codes-bridge-developers",
-      "destination": "/base-chain/builder-codes/builder-codes"
+      "source": "/apps/builder-codes/builder-codes-bridge-developers",
+      "destination": "/apps/builder-codes/builder-codes"
     },
     {
-      "source": "/base-chain/builder-codes/bridge-developers",
-      "destination": "/base-chain/builder-codes/builder-codes"
+      "source": "/apps/builder-codes/bridge-developers",
+      "destination": "/apps/builder-codes/builder-codes"
     },
     {
       "source": "/get-started/ai-prompting",
@@ -2913,11 +2913,31 @@
     {
       "source": "/mini-apps/:slug*",
       "destination": "/apps/:slug*"
+    },
+    {
+      "source": "/base-chain/builder-codes/builder-codes",
+      "destination": "/apps/builder-codes/builder-codes"
+    },
+    {
+      "source": "/base-chain/builder-codes/app-developers",
+      "destination": "/apps/builder-codes/app-developers"
+    },
+    {
+      "source": "/base-chain/builder-codes/wallet-developers",
+      "destination": "/apps/builder-codes/wallet-developers"
+    },
+    {
+      "source": "/base-chain/builder-codes/agent-developers",
+      "destination": "/apps/builder-codes/agent-developers"
+    },
+    {
+      "source": "/base-chain/builder-codes",
+      "destination": "/apps/builder-codes/builder-codes"
     }
   ],
   "integrations": {
     "ga4": {
       "measurementId": "G-TKCM02YFWN"
     }
   }
-}
+}
diff --git a/docs/llms.txt b/docs/llms.txt
@@ -87,7 +87,7 @@ Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainK
 |base-chain/api-reference/debug-api:debug_traceBlockByHash,debug_traceBlockByNumber,debug_traceTransaction
 |base-chain/api-reference/ethereum-json-rpc-api:eth_blockNumber,eth_call,eth_chainId,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockReceipts,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_maxPriorityFeePerGas,eth_sendRawTransaction,eth_subscribe,eth_syncing,eth_unsubscribe,net_version,web3_clientVersion
 |base-chain/api-reference/flashblocks-api:base_transactionStatus,eth_simulateV1,flashblocks-api-overview,newFlashblockTransactions,newFlashblocks,pendingLogs
-|base-chain/builder-codes:agent-developers,app-developers,builder-codes,wallet-developers
+|apps/builder-codes:agent-developers,app-developers,builder-codes,wallet-developers
 |base-chain/flashblocks:app-integration,architecture,faq,overview
 |base-chain/network-information:base-contracts,block-building,bridges,configuration-changelog,diffs-ethereum-base,ecosystem-contracts,network-faucets,network-fees,transaction-finality,troubleshooting-transactions
 |base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting
