From 80009f2f1331e6bae3bf28a0fc48eb9f4138d54a Mon Sep 17 00:00:00 2001
From: GigaHierz <lenahierzi@hotmail.de>
Date: Fri, 2 Oct 2026 14:02:08 +0100
Subject: [PATCH 1/2] docs: merge Build on Celo and Tooling into one Build tab

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .github/CODEOWNERS                            |   22 +-
 AGENTS.md                                     |   24 +-
 ANALYTICS.md                                  |    2 +-
 .../build-with-ai => build/agents}/8004.mdx   |   18 +-
 .../agents}/attribution-tags.mdx              |    6 +-
 .../agents}/celopedia.mdx                     |    0
 .../agents}/mcp/celina.mdx                    |    0
 .../agents}/mcp/celo-mcp.mdx                  |    8 +-
 .../agents}/mcp/index.mdx                     |    6 +-
 .../build-with-ai => build/agents}/mpp.mdx    |    0
 .../agents}/overview.mdx                      |   16 +-
 .../agents}/self-agent-id.mdx                 |   16 +-
 .../agents}/use-docs-with-ai.mdx              |   14 +-
 .../agents}/usecases.mdx                      |    0
 .../agents}/vibe-coding.mdx                   |    2 +-
 .../agents}/x402-get-discovered.mdx           |   16 +-
 .../build-with-ai => build/agents}/x402.mdx   |   14 +-
 .../build-on-socialconnect.mdx                |    6 +-
 {build-on-celo => build}/build-with-defi.mdx  |   16 +-
 .../build-with-farcaster.mdx                  |    6 +-
 .../build-with-local-stablecoin.mdx           |   14 +-
 {build-on-celo => build}/build-with-self.mdx  |   12 +-
 {build-on-celo => build}/build-with-usat.mdx  |   14 +-
 .../fee-abstraction/add-fee-currency.mdx      |    6 +-
 .../fee-abstraction/overview.mdx              |   26 +-
 .../fee-abstraction/using-fee-abstraction.mdx |   20 +-
 .../fund-your-project.mdx                     |    0
 {build-on-celo => build}/index.mdx            |    4 +-
 {build-on-celo => build}/launch-checklist.mdx |    2 +-
 .../mini-apps}/overview.mdx                   |   22 +-
 {build-on-celo => build}/nightfall.mdx        |    0
 {build-on-celo => build}/quickstart.mdx       |   12 +-
 {build-on-celo => build}/scaling-your-app.mdx |   10 +-
 {tooling => build/tools}/bridges/bridges.mdx  |    0
 .../tools}/bridges/cross-chain-messaging.mdx  |    0
 .../contract-verification/blockscout.mdx      |    0
 .../tools}/contract-verification/celoscan.mdx |    0
 .../tools}/contract-verification/hardhat.mdx  |    0
 .../tools}/contract-verification/index.mdx    |   10 +-
 .../tools}/contract-verification/remix.mdx    |    0
 .../tools}/contracts/core-contracts.mdx       |    0
 .../tools}/contracts/fee-currencies.mdx       |    6 +-
 .../tools}/contracts/l1-contracts.mdx         |    0
 .../tools}/contracts/stablecoin-contracts.mdx |    2 +-
 .../tools}/contracts/uniswap-contracts.mdx    |    0
 .../tools}/dev-environments/foundry.mdx       |    2 +-
 .../tools}/dev-environments/hardhat.mdx       |   10 +-
 .../tools}/dev-environments/index.mdx         |   10 +-
 .../dev-environments/multibaas/contracts.mdx  |    0
 .../dev-environments/multibaas/overview.mdx   |    0
 .../dev-environments/multibaas/webhooks.mdx   |    0
 .../tools}/dev-environments/remix.mdx         |    2 +-
 .../tools}/dev-environments/thirdweb.mdx      |   10 +-
 .../tools}/explorers/analytics.mdx            |    0
 .../tools}/explorers/block-explorers.mdx      |    0
 .../tools}/explorers/overview.mdx             |    0
 {tooling => build/tools}/indexers/codex.mdx   |    0
 {tooling => build/tools}/indexers/envio.mdx   |    2 +-
 .../tools}/indexers/goldrush.mdx              |    0
 .../tools}/indexers/indexing-co.mdx           |    0
 .../tools}/indexers/overview.mdx              |    2 +-
 .../tools}/indexers/subquery.mdx              |    0
 .../tools}/indexers/the-graph.mdx             |    0
 build/tools/libraries-sdks/celo-sdks.mdx      |   24 +
 .../tools}/libraries-sdks/cli/README.txt      |    0
 .../tools}/libraries-sdks/cli/account.mdx     |    0
 .../libraries-sdks/cli/autocomplete.mdx       |    0
 .../tools}/libraries-sdks/cli/commands.mdx    |    0
 .../tools}/libraries-sdks/cli/config.mdx      |    0
 .../tools}/libraries-sdks/cli/election.mdx    |    0
 .../tools}/libraries-sdks/cli/epochs.mdx      |    0
 .../tools}/libraries-sdks/cli/governance.mdx  |    0
 .../tools}/libraries-sdks/cli/help.mdx        |    0
 .../tools}/libraries-sdks/cli/identity.mdx    |    0
 .../tools}/libraries-sdks/cli/index.mdx       |    6 +-
 .../tools}/libraries-sdks/cli/lockedcelo.mdx  |    0
 .../tools}/libraries-sdks/cli/multisig.mdx    |    0
 .../tools}/libraries-sdks/cli/network.mdx     |    0
 .../tools}/libraries-sdks/cli/node.mdx        |    0
 .../tools}/libraries-sdks/cli/oracle.mdx      |    0
 .../tools}/libraries-sdks/cli/plugins.mdx     |    0
 .../tools}/libraries-sdks/cli/releasecelo.mdx |    0
 .../tools}/libraries-sdks/cli/rewards.mdx     |    0
 .../tools}/libraries-sdks/cli/transfer.mdx    |    0
 .../tools}/libraries-sdks/cli/validator.mdx   |    0
 .../libraries-sdks/cli/validatorgroup.mdx     |    0
 .../tools}/libraries-sdks/composer-kit.mdx    |    4 +-
 .../contracts-wrappers-registry.mdx           |    0
 .../contractkit/data-encryption-key.mdx       |    0
 .../libraries-sdks/contractkit/index.mdx      |    0
 .../migrating-to-contractkit-v1.mdx           |    2 +-
 .../migrating-to-contractkit-v2.mdx           |    2 +-
 .../contractkit/migrating-to-viem.mdx         |    0
 .../notes-web3-with-contractkit.mdx           |    2 +-
 .../libraries-sdks/contractkit/odis.mdx       |    2 +-
 .../libraries-sdks/contractkit/setup.mdx      |    2 +-
 .../libraries-sdks/contractkit/usage.mdx      |    0
 .../tools}/libraries-sdks/dynamic/index.mdx   |    0
 .../tools}/libraries-sdks/ethers/index.mdx    |    4 +-
 .../tools}/libraries-sdks/jaw/index.mdx       |    0
 .../tools}/libraries-sdks/portal/index.mdx    |    0
 .../tools}/libraries-sdks/reown/index.mdx     |    0
 .../tools}/libraries-sdks/viem/index.mdx      |    0
 .../tools}/libraries-sdks/web3/index.mdx      |    8 +-
 {tooling => build/tools}/nodes/alchemy.mdx    |    0
 {tooling => build/tools}/nodes/forno.mdx      |    2 +-
 {tooling => build/tools}/nodes/overview.mdx   |    2 +-
 .../tools}/oracles/band-protocol.mdx          |    2 +-
 .../tools}/oracles/chainlink-oracles.mdx      |    0
 {tooling => build/tools}/oracles/dia.mdx      |    0
 {tooling => build/tools}/oracles/index.mdx    |    4 +-
 .../tools}/oracles/quex-oracles.mdx           |    0
 {tooling => build/tools}/oracles/redstone.mdx |    0
 {tooling => build/tools}/oracles/run.mdx      |    0
 {tooling => build/tools}/oracles/supra.mdx    |    0
 .../tools}/oracles/wit-oracle.mdx             |    0
 {tooling => build/tools}/overview/index.mdx   |   12 +-
 .../tools}/overview/migrate/from-ethereum.mdx |    0
 .../tools}/testnets/celo-sepolia/index.mdx    |    0
 {tooling => build/tools}/wallets/index.mdx    |   28 +-
 .../wallets/ledger/eip712-workaround.mdx      |    0
 .../tools}/wallets/ledger/setup.mdx           |    8 +-
 .../tools}/wallets/ledger/to-celo-cli.mdx     |    0
 .../wallets/ledger/to-celo-terminal.mdx       |    2 +-
 .../tools}/wallets/ledger/to-celo-web.mdx     |    0
 .../metamask/add-celo-testnet-to-metamask.mdx |    0
 .../tools}/wallets/metamask/import.mdx        |    2 +-
 .../tools}/wallets/metamask/setup.mdx         |    2 +-
 .../tools}/wallets/metamask/use.mdx           |   12 +-
 .../registering-as-rpc-node.mdx               |    2 +-
 docs.json                                     | 1422 +++++++++--------
 .../bridging-celo-from-ethereum.mdx           |    4 +-
 .../withdrawing-celo-to-ethereum.mdx          |    2 +-
 learn/celo.mdx                                |   32 +-
 learn/manage/asset.mdx                        |    2 +-
 learn/manage/self-custody.mdx                 |   10 +-
 learn/network/overview.mdx                    |    6 +-
 learn/protocol/index.mdx                      |   10 +-
 learn/protocol/metadata.mdx                   |    4 +-
 learn/protocol/transactions/overview.mdx      |    2 +-
 learn/wallets.mdx                             |   22 +-
 operate/index.mdx                             |    2 +-
 .../notices/archive/celo-sepolia-launch.mdx   |    2 +-
 operate/specification/deployments.mdx         |   12 +-
 operate/specification/fee-abstraction.mdx     |    2 +-
 scripts/README.md                             |   10 +-
 scripts/data/stablecoins.json                 |    2 +-
 scripts/update_contracts.py                   |   16 +-
 tooling/libraries-sdks/celo-sdks.mdx          |   24 -
 149 files changed, 1062 insertions(+), 1048 deletions(-)
 rename {build-on-celo/build-with-ai => build/agents}/8004.mdx (95%)
 rename {build-on-celo => build/agents}/attribution-tags.mdx (95%)
 rename {build-on-celo/build-with-ai => build/agents}/celopedia.mdx (100%)
 rename {build-on-celo/build-with-ai => build/agents}/mcp/celina.mdx (100%)
 rename {build-on-celo/build-with-ai => build/agents}/mcp/celo-mcp.mdx (96%)
 rename {build-on-celo/build-with-ai => build/agents}/mcp/index.mdx (94%)
 rename {build-on-celo/build-with-ai => build/agents}/mpp.mdx (100%)
 rename {build-on-celo/build-with-ai => build/agents}/overview.mdx (77%)
 rename {build-on-celo/build-with-ai => build/agents}/self-agent-id.mdx (93%)
 rename {build-on-celo/build-with-ai => build/agents}/use-docs-with-ai.mdx (92%)
 rename {build-on-celo/build-with-ai => build/agents}/usecases.mdx (100%)
 rename {build-on-celo/build-with-ai => build/agents}/vibe-coding.mdx (97%)
 rename {build-on-celo/build-with-ai => build/agents}/x402-get-discovered.mdx (89%)
 rename {build-on-celo/build-with-ai => build/agents}/x402.mdx (94%)
 rename {build-on-celo => build}/build-on-socialconnect.mdx (87%)
 rename {build-on-celo => build}/build-with-defi.mdx (88%)
 rename {build-on-celo => build}/build-with-farcaster.mdx (97%)
 rename {build-on-celo => build}/build-with-local-stablecoin.mdx (78%)
 rename {build-on-celo => build}/build-with-self.mdx (84%)
 rename {build-on-celo => build}/build-with-usat.mdx (81%)
 rename {build-on-celo => build}/fee-abstraction/add-fee-currency.mdx (93%)
 rename {build-on-celo => build}/fee-abstraction/overview.mdx (61%)
 rename {build-on-celo => build}/fee-abstraction/using-fee-abstraction.mdx (85%)
 rename {build-on-celo => build}/fund-your-project.mdx (100%)
 rename {build-on-celo => build}/index.mdx (94%)
 rename {build-on-celo => build}/launch-checklist.mdx (96%)
 rename {build-on-celo/build-on-minipay => build/mini-apps}/overview.mdx (86%)
 rename {build-on-celo => build}/nightfall.mdx (100%)
 rename {build-on-celo => build}/quickstart.mdx (89%)
 rename {build-on-celo => build}/scaling-your-app.mdx (95%)
 rename {tooling => build/tools}/bridges/bridges.mdx (100%)
 rename {tooling => build/tools}/bridges/cross-chain-messaging.mdx (100%)
 rename {tooling => build/tools}/contract-verification/blockscout.mdx (100%)
 rename {tooling => build/tools}/contract-verification/celoscan.mdx (100%)
 rename {tooling => build/tools}/contract-verification/hardhat.mdx (100%)
 rename {tooling => build/tools}/contract-verification/index.mdx (69%)
 rename {tooling => build/tools}/contract-verification/remix.mdx (100%)
 rename {tooling => build/tools}/contracts/core-contracts.mdx (100%)
 rename {tooling => build/tools}/contracts/fee-currencies.mdx (96%)
 rename {tooling => build/tools}/contracts/l1-contracts.mdx (100%)
 rename {tooling => build/tools}/contracts/stablecoin-contracts.mdx (97%)
 rename {tooling => build/tools}/contracts/uniswap-contracts.mdx (100%)
 rename {tooling => build/tools}/dev-environments/foundry.mdx (98%)
 rename {tooling => build/tools}/dev-environments/hardhat.mdx (77%)
 rename {tooling => build/tools}/dev-environments/index.mdx (66%)
 rename {tooling => build/tools}/dev-environments/multibaas/contracts.mdx (100%)
 rename {tooling => build/tools}/dev-environments/multibaas/overview.mdx (100%)
 rename {tooling => build/tools}/dev-environments/multibaas/webhooks.mdx (100%)
 rename {tooling => build/tools}/dev-environments/remix.mdx (97%)
 rename {tooling => build/tools}/dev-environments/thirdweb.mdx (71%)
 rename {tooling => build/tools}/explorers/analytics.mdx (100%)
 rename {tooling => build/tools}/explorers/block-explorers.mdx (100%)
 rename {tooling => build/tools}/explorers/overview.mdx (100%)
 rename {tooling => build/tools}/indexers/codex.mdx (100%)
 rename {tooling => build/tools}/indexers/envio.mdx (98%)
 rename {tooling => build/tools}/indexers/goldrush.mdx (100%)
 rename {tooling => build/tools}/indexers/indexing-co.mdx (100%)
 rename {tooling => build/tools}/indexers/overview.mdx (98%)
 rename {tooling => build/tools}/indexers/subquery.mdx (100%)
 rename {tooling => build/tools}/indexers/the-graph.mdx (100%)
 create mode 100644 build/tools/libraries-sdks/celo-sdks.mdx
 rename {tooling => build/tools}/libraries-sdks/cli/README.txt (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/account.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/autocomplete.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/commands.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/config.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/election.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/epochs.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/governance.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/help.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/identity.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/index.mdx (92%)
 rename {tooling => build/tools}/libraries-sdks/cli/lockedcelo.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/multisig.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/network.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/node.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/oracle.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/plugins.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/releasecelo.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/rewards.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/transfer.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/validator.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/cli/validatorgroup.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/composer-kit.mdx (96%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/contracts-wrappers-registry.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/data-encryption-key.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/index.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/migrating-to-contractkit-v1.mdx (97%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/migrating-to-contractkit-v2.mdx (99%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/migrating-to-viem.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/notes-web3-with-contractkit.mdx (98%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/odis.mdx (98%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/setup.mdx (94%)
 rename {tooling => build/tools}/libraries-sdks/contractkit/usage.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/dynamic/index.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/ethers/index.mdx (92%)
 rename {tooling => build/tools}/libraries-sdks/jaw/index.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/portal/index.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/reown/index.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/viem/index.mdx (100%)
 rename {tooling => build/tools}/libraries-sdks/web3/index.mdx (73%)
 rename {tooling => build/tools}/nodes/alchemy.mdx (100%)
 rename {tooling => build/tools}/nodes/forno.mdx (95%)
 rename {tooling => build/tools}/nodes/overview.mdx (97%)
 rename {tooling => build/tools}/oracles/band-protocol.mdx (98%)
 rename {tooling => build/tools}/oracles/chainlink-oracles.mdx (100%)
 rename {tooling => build/tools}/oracles/dia.mdx (100%)
 rename {tooling => build/tools}/oracles/index.mdx (93%)
 rename {tooling => build/tools}/oracles/quex-oracles.mdx (100%)
 rename {tooling => build/tools}/oracles/redstone.mdx (100%)
 rename {tooling => build/tools}/oracles/run.mdx (100%)
 rename {tooling => build/tools}/oracles/supra.mdx (100%)
 rename {tooling => build/tools}/oracles/wit-oracle.mdx (100%)
 rename {tooling => build/tools}/overview/index.mdx (72%)
 rename {tooling => build/tools}/overview/migrate/from-ethereum.mdx (100%)
 rename {tooling => build/tools}/testnets/celo-sepolia/index.mdx (100%)
 rename {tooling => build/tools}/wallets/index.mdx (76%)
 rename {tooling => build/tools}/wallets/ledger/eip712-workaround.mdx (100%)
 rename {tooling => build/tools}/wallets/ledger/setup.mdx (91%)
 rename {tooling => build/tools}/wallets/ledger/to-celo-cli.mdx (100%)
 rename {tooling => build/tools}/wallets/ledger/to-celo-terminal.mdx (92%)
 rename {tooling => build/tools}/wallets/ledger/to-celo-web.mdx (100%)
 rename {tooling => build/tools}/wallets/metamask/add-celo-testnet-to-metamask.mdx (100%)
 rename {tooling => build/tools}/wallets/metamask/import.mdx (97%)
 rename {tooling => build/tools}/wallets/metamask/setup.mdx (95%)
 rename {tooling => build/tools}/wallets/metamask/use.mdx (78%)
 delete mode 100644 tooling/libraries-sdks/celo-sdks.mdx

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index e58a0dc876..3651d6cfaf 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -6,7 +6,7 @@
 * @celo-org/devrel 
 
 # Build on Celo section - DevRel team
-/build-on-celo/ @celo-org/devrel
+/build/ @celo-org/devrel
 
 # Learn section (protocol, governance, manage, etc.) - Blockchain and Primitives teams
 /learn/ @celo-org/blockchain @celo-org/primitives
@@ -19,28 +19,28 @@
 /operate/ @celo-org/blockchain
 
 # Tooling section
-/tooling/ @celo-org/devrel
+/build/tools/ @celo-org/devrel
 
 # CLI tools - DevRel and DevTooling teams
-/tooling/libraries-sdks/cli/ @celo-org/devrel @celo-org/devtooling
+/build/tools/libraries-sdks/cli/ @celo-org/devrel @celo-org/devtooling
 
 # ContractKit - DevRel and DevTooling teams
-/tooling/libraries-sdks/contractkit/ @celo-org/devrel @celo-org/devtooling
+/build/tools/libraries-sdks/contractkit/ @celo-org/devrel @celo-org/devtooling
 
 # Development environments (was developer/deploy) - DevRel and Primitives teams
-/tooling/dev-environments/ @celo-org/devrel @celo-org/primitives
+/build/tools/dev-environments/ @celo-org/devrel @celo-org/primitives
 
 # SDK libraries - DevRel and DevTooling teams
-/tooling/libraries-sdks/rainbowkit-celo/ @celo-org/devrel @celo-org/devtooling
-/tooling/libraries-sdks/viem/ @celo-org/devrel @celo-org/devtooling
-/tooling/libraries-sdks/ @celo-org/devrel @celo-org/devtooling
+/build/tools/libraries-sdks/rainbowkit-celo/ @celo-org/devrel @celo-org/devtooling
+/build/tools/libraries-sdks/viem/ @celo-org/devrel @celo-org/devtooling
+/build/tools/libraries-sdks/ @celo-org/devrel @celo-org/devtooling
 
 # Smart contracts - Primitives team
-/tooling/contracts/ @celo-org/primitives
+/build/tools/contracts/ @celo-org/primitives
 
 # Network/Node operations - DevRel and Blockchain teams
-/tooling/testnets/ @celo-org/devrel @celo-org/blockchain
-/tooling/nodes/ @celo-org/devrel @celo-org/blockchain
+/build/tools/testnets/ @celo-org/devrel @celo-org/blockchain
+/build/tools/nodes/ @celo-org/devrel @celo-org/blockchain
 
 # Configuration files
 /docs.json @celo-org/devrel
diff --git a/AGENTS.md b/AGENTS.md
index 04d52f5abb..92594e8c06 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -8,7 +8,7 @@ Structural work in progress is tracked in the restructure epic, [#2266](https://
 
 - A [Mintlify](https://mintlify.com) site. Content is MDX; navigation, redirects and theme live in `docs.json`. There is no build step beyond the Mintlify CLI.
 - `docs.json` is the single source of truth for what is reachable. **A file on disk is unreachable until it is listed under `navigation`.**
-- Content directories today: `learn/`, `build-on-celo/`, `tooling/`, `contribute-to-celo/`, `operate/`.
+- Content directories today: `learn/`, `build/`, `contribute-to-celo/`, `operate/`. Tool pages live under `build/tools/`.
 - `snippets/` holds reusable JSX/MDX (`/snippets/ColoredText.jsx`, `/snippets/YouTube.jsx`, `/snippets/AddNetworkButton.jsx`). Import with an absolute path after the frontmatter: `import {YouTube} from '/snippets/YouTube.jsx'`.
 - Static assets: `img/`, `images/`, `assets/`, `logo/`.
 - **Any `.js` file under the content root runs on every published page.** Mintlify injects them automatically — there is no allowlist and no way to scope one to a single page — and the same applies to `.css`. Treat a `.js` file here as production code shipped to every reader, not as content: it has full same-origin DOM access on pages that print contract addresses and RPC endpoints. Mintlify does not support a raw `<script src>` in MDX, so third-party scripts are injected programmatically from such a file (`assistant.js` is the example). Note `submodules/developer-tooling` sits under this root too.
@@ -99,7 +99,7 @@ The policy, decided for the restructure: **troubleshooting-first.**
 
 ## 6. Links and components
 
-- Internal links are root-relative with no extension: `[Fee abstraction](/build-on-celo/fee-abstraction/overview)`. Never `./`, `../`, or `.mdx`. Anchors are fine: `/build-on-celo/fee-abstraction/using-fee-abstraction#adapter-addresses`. `mint broken-links` does not validate anchors — check them by hand.
+- Internal links are root-relative with no extension: `[Fee abstraction](/build/fee-abstraction/overview)`. Never `./`, `../`, or `.mdx`. Anchors are fine: `/build/fee-abstraction/using-fee-abstraction#adapter-addresses`. `mint broken-links` does not validate anchors — check them by hand.
 - External links use the full URL. Link to the canonical source (the standard, the SDK docs, the contract on the explorer).
 - Components in use: `Card`/`CardGroup` for index and landing pages, `Tabs`/`Tab` for per-OS or per-client variants, `Accordion`/`AccordionGroup` for optional depth, `Frame` around images, `CodeGroup` for the same step in several package managers. Numbered procedures are plain markdown lists. Keep to this set so pages look alike.
 - Images never carry information that is not also in the text. Agents and screen readers do not see screenshots.
@@ -113,17 +113,17 @@ Numbers and addresses live on one canonical page; every other page links there i
 | Chain IDs, RPC URLs, explorers, faucet | `/learn/network/overview` | mainnet `42220`, `https://forno.celo.org`; Celo Sepolia `11142220`, `https://forno.celo-sepolia.celo-testnet.org`; faucet `https://faucet.celo.org/celo-sepolia` |
 | Block time | `/operate/specification/deployments` | "1-second blocks". Do not write "1-second finality" — see `/operate/specification/finality` |
 | Transaction cost | `/operate/specification/transaction-fees` | "below $0.01 for a typical transaction" |
-| Fee abstraction | `/build-on-celo/fee-abstraction/overview` (guide), `/tooling/contracts/fee-currencies` (addresses), `/operate/specification/fee-abstraction` (protocol) | pay gas in USDm, USDC, USDT or another allowlisted token from any EOA; no paymaster; 6-decimal tokens use the **adapter** address as `feeCurrency` |
-| Stablecoins | `/build-on-celo/build-with-local-stablecoin` | 15 Mento stablecoins (USDm, EURm, BRLm, KESm, …) plus USDC, USDT, USA₮ and other issuers — "30+ stablecoins" in total |
-| MiniPay | `/build-on-celo/build-on-minipay/overview` | stablecoin wallet, 10M+ activations, Mini App discovery page, Celo only |
+| Fee abstraction | `/build/fee-abstraction/overview` (guide), `/build/tools/contracts/fee-currencies` (addresses), `/operate/specification/fee-abstraction` (protocol) | pay gas in USDm, USDC, USDT or another allowlisted token from any EOA; no paymaster; 6-decimal tokens use the **adapter** address as `feeCurrency` |
+| Stablecoins | `/build/build-with-local-stablecoin` | 15 Mento stablecoins (USDm, EURm, BRLm, KESm, …) plus USDC, USDT, USA₮ and other issuers — "30+ stablecoins" in total |
+| MiniPay | `/build/mini-apps/overview` | stablecoin wallet, 10M+ activations, Mini App discovery page, Celo only |
 | Token duality | `/operate/specification/token-duality` | CELO is both the native token and an ERC-20; no wrapping |
 | Data availability | `/operate/specification/eigenda` | EigenDA |
 | Architecture | `/learn/network/architecture` | Ethereum L2 on the OP Stack |
-| Agent payments | `/build-on-celo/build-with-ai/x402`, `/build-on-celo/build-with-ai/mpp` | HTTP 402 flows settled in USDC/USDT; Celo facilitator `https://api.x402.celo.org` |
-| Agent identity and trust | `/build-on-celo/build-with-ai/8004`, `/build-on-celo/build-with-ai/self-agent-id` | ERC-8004 registries on Celo; Self Agent ID adds a zero-knowledge proof-of-human |
-| Human identity | `/build-on-celo/build-with-self` | Self: passport / EU ID / Aadhaar proofs, nothing leaves the device |
-| Phone-number mapping | `/build-on-celo/build-on-socialconnect` | SocialConnect / ODIS |
-| AI tooling | `/build-on-celo/build-with-ai/use-docs-with-ai`, `/build-on-celo/build-with-ai/celopedia`, `/build-on-celo/build-with-ai/mcp/index` | in-page Ask AI assistant, docs MCP at `https://docs.celo.org/mcp`, `llms.txt`, per-page `.md`, Celopedia skill, Celo MCP server |
+| Agent payments | `/build/agents/x402`, `/build/agents/mpp` | HTTP 402 flows settled in USDC/USDT; Celo facilitator `https://api.x402.celo.org` |
+| Agent identity and trust | `/build/agents/8004`, `/build/agents/self-agent-id` | ERC-8004 registries on Celo; Self Agent ID adds a zero-knowledge proof-of-human |
+| Human identity | `/build/build-with-self` | Self: passport / EU ID / Aadhaar proofs, nothing leaves the device |
+| Phone-number mapping | `/build/build-on-socialconnect` | SocialConnect / ODIS |
+| AI tooling | `/build/agents/use-docs-with-ai`, `/build/agents/celopedia`, `/build/agents/mcp/index` | in-page Ask AI assistant, docs MCP at `https://docs.celo.org/mcp`, `llms.txt`, per-page `.md`, Celopedia skill, Celo MCP server |
 
 ### Partner contract addresses
 
@@ -139,7 +139,7 @@ Third-party (partner) contract addresses are not listed in these docs — link t
 
 ## 8. Writing for AI agents (discoverability)
 
-Most readers of these docs are now AI assistants and agents. Mintlify already serves them: `https://docs.celo.org/llms.txt` (index of every page's title and `description`), `llms-full.txt` (full text), every page as Markdown at its URL plus `.md`, the docs MCP server at `https://docs.celo.org/mcp`, and the page-level Copy / ChatGPT / Claude / Cursor menu. Human readers also get the in-page [Ask AI assistant](/build-on-celo/build-with-ai/use-docs-with-ai), which answers from the same MCP endpoint. The [Celopedia skill](/build-on-celo/build-with-ai/celopedia) and the [Celo MCP server](/build-on-celo/build-with-ai/mcp/celo-mcp) are further entry points. Nothing needs configuring per page — but a page is only as useful to an agent as its text is explicit.
+Most readers of these docs are now AI assistants and agents. Mintlify already serves them: `https://docs.celo.org/llms.txt` (index of every page's title and `description`), `llms-full.txt` (full text), every page as Markdown at its URL plus `.md`, the docs MCP server at `https://docs.celo.org/mcp`, and the page-level Copy / ChatGPT / Claude / Cursor menu. Human readers also get the in-page [Ask AI assistant](/build/agents/use-docs-with-ai), which answers from the same MCP endpoint. The [Celopedia skill](/build/agents/celopedia) and the [Celo MCP server](/build/agents/mcp/celo-mcp) are further entry points. Nothing needs configuring per page — but a page is only as useful to an agent as its text is explicit.
 
 Rules that make a page work for an agent:
 
@@ -151,7 +151,7 @@ Rules that make a page work for an agent:
 6. **Headings name the task.** `## Estimate gas in USDC`, not `## Step 3`.
 7. **Close with `## Related`.** Agents traverse the link graph; a page with no outgoing internal links is a dead end.
 8. **Text over images.** Screenshots are fine as illustration; the steps must be in words.
-9. **New agent-relevant pages get listed** on `/build-on-celo/build-with-ai/overview` and, when it exists, the AI-resources page (#2261).
+9. **New agent-relevant pages get listed** on `/build/agents/overview` and, when it exists, the AI-resources page (#2261).
 
 ## 9. Pull requests
 
diff --git a/ANALYTICS.md b/ANALYTICS.md
index 9a377996b7..0b1ca83c75 100644
--- a/ANALYTICS.md
+++ b/ANALYTICS.md
@@ -38,7 +38,7 @@ Edit rights cannot ship a change.
 - The docs assistant is instrumented on both sides, in `celo-org/docs-ai-assistant` rather than in this repo:
   - **Client (GA4).** `widget.js` reuses the page's existing `window.gtag` rather than loading a second tracker, and emits `assistant_opened`, `assistant_question` (`answered`, `escalated`, `truncated`), `assistant_escalate`, `assistant_new_chat`, `assistant_copy`, `assistant_citation_click` (`href`) and `assistant_error` (`from_api`, `status`). Question text is deliberately never sent to GA4.
   - **Server (Redis).** `app/api/chat/route.ts` calls `logQuestion()`, which pushes `{question, model, citedUrls, answered, timestamp, refused}` onto the Upstash Redis list `docs-assistant:questions`, trimmed to the most recent 10,000. Without Redis configured it falls back to `console.log`, which on Vercel is short-retention only. **This list is the docs-gap signal** — the uncited questions in it are the pages that need writing.
-- A handful of outbound partner links carry manual UTM parameters (`tooling/libraries-sdks/reown/index.mdx`, `tooling/indexers/goldrush.mdx`). Those let the partner attribute traffic to us; the planned GTM outbound-click tag answers a different question — what our readers click.
+- A handful of outbound partner links carry manual UTM parameters (`build/tools/libraries-sdks/reown/index.mdx`, `build/tools/indexers/goldrush.mdx`). Those let the partner attribute traffic to us; the planned GTM outbound-click tag answers a different question — what our readers click.
 
 ### Reviewing unanswered questions
 
diff --git a/build-on-celo/build-with-ai/8004.mdx b/build/agents/8004.mdx
similarity index 95%
rename from build-on-celo/build-with-ai/8004.mdx
rename to build/agents/8004.mdx
index d7b186104e..98c850610a 100644
--- a/build-on-celo/build-with-ai/8004.mdx
+++ b/build/agents/8004.mdx
@@ -120,13 +120,13 @@ Check out the [repository](https://github.com/erc-8004/erc-8004-contracts/tree/m
 
 ### Register a service
 
-An identity is not limited to an autonomous agent that acts on its own. Any callable service — an HTTP API, an [MCP server](/build-on-celo/build-with-ai/mcp/index), a bot — can hold one. The service itself needs no on-chain logic: what it gets is a record agents can find and rate, with endpoints in the Identity Registry and feedback in the Reputation Registry.
+An identity is not limited to an autonomous agent that acts on its own. Any callable service — an HTTP API, an [MCP server](/build/agents/mcp/index), a bot — can hold one. The service itself needs no on-chain logic: what it gets is a record agents can find and rate, with endpoints in the Identity Registry and feedback in the Reputation Registry.
 
 <Warning>
   **The address you register from owns the identity.** Every `register()` overload mints the NFT to `msg.sender` and writes `agentWallet = msg.sender`, so that key is published as the agent's payment address *and* controls `setAgentURI`, transfers, and every other owner-only call. Register from the key that should own the identity. The payee is easy to change afterwards — `setAgentWallet()` with a signature from the new wallet, or `unsetAgentWallet()` to clear it, which the owner can call on its own. Ownership is the part that is awkward to undo.
 </Warning>
 
-The registration file is JSON you host anywhere an agent can fetch it — any HTTPS URL, IPFS, or a `data:` URI stored on-chain; the spec does not mandate a path. `services` lists the endpoints you want callers to use. The names below are examples rather than a fixed set — the spec leaves the number and type of endpoints to you, and `wallet` entries for other chains are common. Set `x402Support` to `true` if those endpoints accept [x402](/build-on-celo/build-with-ai/x402) payments.
+The registration file is JSON you host anywhere an agent can fetch it — any HTTPS URL, IPFS, or a `data:` URI stored on-chain; the spec does not mandate a path. `services` lists the endpoints you want callers to use. The names below are examples rather than a fixed set — the spec leaves the number and type of endpoints to you, and `wallet` entries for other chains are common. Set `x402Support` to `true` if those endpoints accept [x402](/build/agents/x402) payments.
 
 ```json
 {
@@ -239,7 +239,7 @@ const [registered] = parseEventLogs({
 console.log('Registered as agent', registered.args.agentId);
 ```
 
-Swap in a new file later with `setAgentURI(agentId, newURI)`, and set `"active": false` in the file when you retire the service. Transferring the agent NFT clears `agentWallet`, so the new owner sets it again. Gas for either call can be paid in a stablecoin — see [fee abstraction](/build-on-celo/fee-abstraction/overview).
+Swap in a new file later with `setAgentURI(agentId, newURI)`, and set `"active": false` in the file when you retire the service. Transferring the agent NFT clears `agentWallet`, so the new owner sets it again. Gas for either call can be paid in a stablecoin — see [fee abstraction](/build/fee-abstraction/overview).
 
 ### Give Feedback
 
@@ -446,7 +446,7 @@ ERC-8004 works seamlessly with Celo's ecosystem:
 - **Fee abstraction**: Register agents and give feedback paying gas in stablecoins
 - **x402 payments**: Combine trust verification with instant payments
 - **MCP servers**: Agents can expose capabilities via Celo MCP Server
-- **Self Agent ID**: A deployment of all three ERC-8004 registries on Celo that adds a zero-knowledge proof-of-human to each agent identity — see [Self Agent ID](/build-on-celo/build-with-ai/self-agent-id)
+- **Self Agent ID**: A deployment of all three ERC-8004 registries on Celo that adds a zero-knowledge proof-of-human to each agent identity — see [Self Agent ID](/build/agents/self-agent-id)
 
 ## Resources
 
@@ -461,8 +461,8 @@ ERC-8004 works seamlessly with Celo's ecosystem:
 
 ## Related
 
-- [Self Agent ID](/build-on-celo/build-with-ai/self-agent-id) - ERC-8004 registries with proof-of-human, live on Celo
-- [x402](/build-on-celo/build-with-ai/x402) - Payment layer for AI agents
-- [MPP](/build-on-celo/build-with-ai/mpp) - Machine Payments Protocol: charge USDC per request over HTTP
-- [Celopedia](/build-on-celo/build-with-ai/celopedia) - Celo ecosystem knowledge for coding assistants
-- [MCP Servers](/build-on-celo/build-with-ai/mcp/index) - Connect agents to data and tools
+- [Self Agent ID](/build/agents/self-agent-id) - ERC-8004 registries with proof-of-human, live on Celo
+- [x402](/build/agents/x402) - Payment layer for AI agents
+- [MPP](/build/agents/mpp) - Machine Payments Protocol: charge USDC per request over HTTP
+- [Celopedia](/build/agents/celopedia) - Celo ecosystem knowledge for coding assistants
+- [MCP Servers](/build/agents/mcp/index) - Connect agents to data and tools
diff --git a/build-on-celo/attribution-tags.mdx b/build/agents/attribution-tags.mdx
similarity index 95%
rename from build-on-celo/attribution-tags.mdx
rename to build/agents/attribution-tags.mdx
index 2abb27ffa3..afbc9ca46c 100644
--- a/build-on-celo/attribution-tags.mdx
+++ b/build/agents/attribution-tags.mdx
@@ -113,6 +113,6 @@ console.log(result); // { codes: ["celo_b7k3p9da"], schemaId: 0 }
 
 ## Related
 
-- [x402: Agent Payments](/build-on-celo/build-with-ai/x402)
-- [Fund your Project](/build-on-celo/fund-your-project) — grant and funding programs in the Celo ecosystem
-- [Launch Checklist](/build-on-celo/launch-checklist)
+- [x402: Agent Payments](/build/agents/x402)
+- [Fund your Project](/build/fund-your-project) — grant and funding programs in the Celo ecosystem
+- [Launch Checklist](/build/launch-checklist)
diff --git a/build-on-celo/build-with-ai/celopedia.mdx b/build/agents/celopedia.mdx
similarity index 100%
rename from build-on-celo/build-with-ai/celopedia.mdx
rename to build/agents/celopedia.mdx
diff --git a/build-on-celo/build-with-ai/mcp/celina.mdx b/build/agents/mcp/celina.mdx
similarity index 100%
rename from build-on-celo/build-with-ai/mcp/celina.mdx
rename to build/agents/mcp/celina.mdx
diff --git a/build-on-celo/build-with-ai/mcp/celo-mcp.mdx b/build/agents/mcp/celo-mcp.mdx
similarity index 96%
rename from build-on-celo/build-with-ai/mcp/celo-mcp.mdx
rename to build/agents/mcp/celo-mcp.mdx
index 56fa458e21..4563b11a4e 100644
--- a/build-on-celo/build-with-ai/mcp/celo-mcp.mdx
+++ b/build/agents/mcp/celo-mcp.mdx
@@ -5,7 +5,7 @@ description: Connect AI assistants to Celo blockchain data, balances, governance
 
 The **Celo MCP Server** gives AI assistants and editors read access to Celo — blocks, transactions, token balances, gas fees, governance proposals, staking and validator data. It runs locally over stdio, or as a remote endpoint over Streamable HTTP.
 
-Every tool is a query. The server never signs or sends a transaction, so it cannot move funds. To give an agent a wallet, see [Celina](/build-on-celo/build-with-ai/mcp/celina).
+Every tool is a query. The server never signs or sends a transaction, so it cannot move funds. To give an agent a wallet, see [Celina](/build/agents/mcp/celina).
 
 ## What it covers
 
@@ -235,7 +235,7 @@ mypy src/              # type-check
 
 ## Related
 
-- [What is MCP?](/build-on-celo/build-with-ai/mcp/index) - how the protocol works and which Celo servers exist
-- [Celo Docs MCP Server](/build-on-celo/build-with-ai/use-docs-with-ai) - search these docs from your editor
-- [Celina](/build-on-celo/build-with-ai/mcp/celina) - an agent wallet, for the write side
+- [What is MCP?](/build/agents/mcp/index) - how the protocol works and which Celo servers exist
+- [Celo Docs MCP Server](/build/agents/use-docs-with-ai) - search these docs from your editor
+- [Celina](/build/agents/mcp/celina) - an agent wallet, for the write side
 - [Network information](/learn/network/overview) - chain IDs, RPC URLs and explorers
diff --git a/build-on-celo/build-with-ai/mcp/index.mdx b/build/agents/mcp/index.mdx
similarity index 94%
rename from build-on-celo/build-with-ai/mcp/index.mdx
rename to build/agents/mcp/index.mdx
index 46f227241a..ddcd6e6d7b 100644
--- a/build-on-celo/build-with-ai/mcp/index.mdx
+++ b/build/agents/mcp/index.mdx
@@ -7,14 +7,14 @@ description: Learn about the Model Context Protocol and how to use Celo-specific
 
 ## Celo specific MCPs:
 
-- [Celo MCP Server](/build-on-celo/build-with-ai/mcp/celo-mcp)
+- [Celo MCP Server](/build/agents/mcp/celo-mcp)
   - Chain info, balances, gas fees
   - Governance proposals
   - Staking and validators
   - Runs locally (stdio) or as a remote HTTP endpoint
-- [Celo Docs MCP Server](/build-on-celo/build-with-ai/use-docs-with-ai)
+- [Celo Docs MCP Server](/build/agents/use-docs-with-ai)
   - Search the documentation from your editor
-- [Celina](/build-on-celo/build-with-ai/mcp/celina)
+- [Celina](/build/agents/mcp/celina)
   - Give your LLM a wallet on Celo — balances, transfers, DeFi, governance, staking, and Self Agent ID
 
 <iframe
diff --git a/build-on-celo/build-with-ai/mpp.mdx b/build/agents/mpp.mdx
similarity index 100%
rename from build-on-celo/build-with-ai/mpp.mdx
rename to build/agents/mpp.mdx
diff --git a/build-on-celo/build-with-ai/overview.mdx b/build/agents/overview.mdx
similarity index 77%
rename from build-on-celo/build-with-ai/overview.mdx
rename to build/agents/overview.mdx
index ed2430589d..12f4ad52f7 100644
--- a/build-on-celo/build-with-ai/overview.mdx
+++ b/build/agents/overview.mdx
@@ -8,7 +8,7 @@ description: Build AI agents on Celo that pay, transact, and coordinate onchain
 
 Celo is a leading Ethereum Layer 2 optimized for agentic activity with real-world utility, enabling AI agents to autonomously perform onchain actions tied directly to payments, commerce, and financial coordination.
 
-Agents on Celo can tap into the network's expansive payments ecosystem, leveraging fast finality, sub-cent transaction costs, and a stablecoin-optimized financial stack spanning peer-to-peer transfers, merchant payments, remittances, and onchain FX. Combined with native support for agent standards like [ERC-8004](/build-on-celo/build-with-ai/8004) for trust, [x402](/build-on-celo/build-with-ai/x402) and [MPP](/build-on-celo/build-with-ai/mpp) for HTTP-native payments, and Celo's [Celopedia](/build-on-celo/build-with-ai/celopedia), Celo provides a production-ready environment for deploying AI agents that do more than trade tokens—they move money, coordinate economic activity, and interact with real users at global scale.
+Agents on Celo can tap into the network's expansive payments ecosystem, leveraging fast finality, sub-cent transaction costs, and a stablecoin-optimized financial stack spanning peer-to-peer transfers, merchant payments, remittances, and onchain FX. Combined with native support for agent standards like [ERC-8004](/build/agents/8004) for trust, [x402](/build/agents/x402) and [MPP](/build/agents/mpp) for HTTP-native payments, and Celo's [Celopedia](/build/agents/celopedia), Celo provides a production-ready environment for deploying AI agents that do more than trade tokens—they move money, coordinate economic activity, and interact with real users at global scale.
 
 ## Why Build AI Agents on Celo
 
@@ -56,14 +56,14 @@ On Celo, agents are first-class participants in the economy. They can send and r
 
 Agents on Celo can charge and pay for services over plain HTTP, settling in stablecoins in a single request — no accounts, invoices, or checkout flows.
 
-- **[x402](/build-on-celo/build-with-ai/x402)** gives meaning to the HTTP `402 Payment Required` status code, letting an agent settle a stablecoin micropayment inline with the request.
-- **[MPP (Machine Payments Protocol)](/build-on-celo/build-with-ai/mpp)** builds on the same flow so any service can charge USDC per request through a hosted facilitator — the buyer pays no gas.
+- **[x402](/build/agents/x402)** gives meaning to the HTTP `402 Payment Required` status code, letting an agent settle a stablecoin micropayment inline with the request.
+- **[MPP (Machine Payments Protocol)](/build/agents/mpp)** builds on the same flow so any service can charge USDC per request through a hosted facilitator — the buyer pays no gas.
 
-Both settle on-chain in seconds, making them well-suited to paid APIs, pay-per-use tools, and agent-to-agent commerce. A paid API, MCP server, or bot can also carry its own ERC-8004 identity, so agents can discover it and rate it — see [Register a service](/build-on-celo/build-with-ai/8004#register-a-service).
+Both settle on-chain in seconds, making them well-suited to paid APIs, pay-per-use tools, and agent-to-agent commerce. A paid API, MCP server, or bot can also carry its own ERC-8004 identity, so agents can discover it and rate it — see [Register a service](/build/agents/8004#register-a-service).
 
 ## Giving an agent a wallet
 
-An agent that pays for things needs an account it can read from and sign with. You can wire this up directly with [viem](/tooling/libraries-sdks/viem), or use a tool that exposes the calls to an LLM: [Celina](/build-on-celo/build-with-ai/mcp/celina) is a third-party, open-source stack covering balances, transfers, DeFi, governance, staking and Self Agent ID through an SDK, an MCP server, a REST API, and a read-only Telegram bot.
+An agent that pays for things needs an account it can read from and sign with. You can wire this up directly with [viem](/build/tools/libraries-sdks/viem), or use a tool that exposes the calls to an LLM: [Celina](/build/agents/mcp/celina) is a third-party, open-source stack covering balances, transfers, DeFi, governance, staking and Self Agent ID through an SDK, an MCP server, a REST API, and a read-only Telegram bot.
 
 ## Fee Abstraction for Agents
 
@@ -120,10 +120,10 @@ await sendUSDCWithFeeAbstraction("0xRecipient...", parseUnits("1", 6));
   When using USDC or USDT as fee currency, always use the **adapter address** (not the token address). Adapters normalize the 6-decimal tokens to the 18-decimal format that Celo's gas pricing requires. For 18-decimal tokens like USDm, use the token address directly.
 </Note>
 
-For the current token and adapter addresses on Mainnet and Celo Sepolia, see [Fee Currencies](/tooling/contracts/fee-currencies) — generated from the on-chain `FeeCurrencyDirectory` allowlist.
+For the current token and adapter addresses on Mainnet and Celo Sepolia, see [Fee Currencies](/build/tools/contracts/fee-currencies) — generated from the on-chain `FeeCurrencyDirectory` allowlist.
 
-For the full guide — including gas estimation, CIP-64 transaction types, and CLI usage — see [Fee Abstraction](/build-on-celo/fee-abstraction/using-fee-abstraction).
+For the full guide — including gas estimation, CIP-64 transaction types, and CLI usage — see [Fee Abstraction](/build/fee-abstraction/using-fee-abstraction).
 
 ## Crediting Agent Transactions to Your App
 
-Agents transacting on behalf of your app can also carry an [attribution tag](/build-on-celo/attribution-tags), so the on-chain activity they generate is credited back to you — useful for tracking usage across MiniPay or your own analytics.
+Agents transacting on behalf of your app can also carry an [attribution tag](/build/agents/attribution-tags), so the on-chain activity they generate is credited back to you — useful for tracking usage across MiniPay or your own analytics.
diff --git a/build-on-celo/build-with-ai/self-agent-id.mdx b/build/agents/self-agent-id.mdx
similarity index 93%
rename from build-on-celo/build-with-ai/self-agent-id.mdx
rename to build/agents/self-agent-id.mdx
index 57df70d6dd..416fda261d 100644
--- a/build-on-celo/build-with-ai/self-agent-id.mdx
+++ b/build/agents/self-agent-id.mdx
@@ -4,9 +4,9 @@ sidebarTitle: "Self: Agent Identity"
 description: Give an AI agent a soulbound on-chain identity on Celo, backed by a zero-knowledge passport proof, and verify agent requests in your service with Self Agent ID
 ---
 
-This page is for developers who build AI agents and for services that want to accept requests from agents without accepting bots. Self Agent ID is an on-chain registry on Celo that binds an agent's signing key to a zero-knowledge proof that one real, unique human stands behind it. The agent receives a soulbound ERC-721 NFT; services check it with one middleware call. It implements the [ERC-8004](/build-on-celo/build-with-ai/8004) registries and adds a proof-of-human extension.
+This page is for developers who build AI agents and for services that want to accept requests from agents without accepting bots. Self Agent ID is an on-chain registry on Celo that binds an agent's signing key to a zero-knowledge proof that one real, unique human stands behind it. The agent receives a soulbound ERC-721 NFT; services check it with one middleware call. It implements the [ERC-8004](/build/agents/8004) registries and adds a proof-of-human extension.
 
-For verifying *humans* in your app (passport, EU ID, Aadhaar), see [Build with Self](/build-on-celo/build-with-self).
+For verifying *humans* in your app (passport, EU ID, Aadhaar), see [Build with Self](/build/build-with-self).
 
 ## How it works
 
@@ -149,7 +149,7 @@ Flow: register → transact on Celo → check eligibility → claim (tiers 1–2
 
 Self Agent ID implements all three ERC-8004 registry roles — identity (`SelfAgentRegistry`), reputation (`SelfReputationRegistry`) and validation (`SelfValidationRegistry`) — and extends the identity registry with `registerWithHumanProof()`, `revokeHumanProof()`, proof-validity queries, and nullifier-based sybil detection. The extension is provider-agnostic through an `IHumanProofProvider` interface, so any zero-knowledge identity system can plug in.
 
-These are Self's own deployments. The reference ERC-8004 registries on Celo (`0x8004A169…` mainnet) listed on the [ERC-8004 page](/build-on-celo/build-with-ai/8004#contract-deployments) are separate contracts; an agent can be registered in both.
+These are Self's own deployments. The reference ERC-8004 registries on Celo (`0x8004A169…` mainnet) listed on the [ERC-8004 page](/build/agents/8004#contract-deployments) are separate contracts; an agent can be registered in both.
 
 ## Resources
 
@@ -166,8 +166,8 @@ These are Self's own deployments. The reference ERC-8004 registries on Celo (`0x
 
 ## Related
 
-- [ERC-8004](/build-on-celo/build-with-ai/8004) - The trust standard Self Agent ID implements
-- [Build with Self](/build-on-celo/build-with-self) - Verify humans, not agents, with the same proofs
-- [x402](/build-on-celo/build-with-ai/x402) - Let a verified agent pay per request
-- [MPP](/build-on-celo/build-with-ai/mpp) - Charge agents per API call in USDC
-- [Fee abstraction](/build-on-celo/fee-abstraction/overview) - Pay gas in stablecoins from the agent wallet
+- [ERC-8004](/build/agents/8004) - The trust standard Self Agent ID implements
+- [Build with Self](/build/build-with-self) - Verify humans, not agents, with the same proofs
+- [x402](/build/agents/x402) - Let a verified agent pay per request
+- [MPP](/build/agents/mpp) - Charge agents per API call in USDC
+- [Fee abstraction](/build/fee-abstraction/overview) - Pay gas in stablecoins from the agent wallet
diff --git a/build-on-celo/build-with-ai/use-docs-with-ai.mdx b/build/agents/use-docs-with-ai.mdx
similarity index 92%
rename from build-on-celo/build-with-ai/use-docs-with-ai.mdx
rename to build/agents/use-docs-with-ai.mdx
index 76e0db4ba9..9f62f163d5 100644
--- a/build-on-celo/build-with-ai/use-docs-with-ai.mdx
+++ b/build/agents/use-docs-with-ai.mdx
@@ -18,7 +18,7 @@ This matters because model training data goes stale. Celo became an Ethereum L2
 
 ## Connect the docs MCP server
 
-The [Model Context Protocol](/build-on-celo/build-with-ai/mcp/index) lets an AI tool call external tools directly. Celo Docs hosts an MCP server at:
+The [Model Context Protocol](/build/agents/mcp/index) lets an AI tool call external tools directly. Celo Docs hosts an MCP server at:
 
 ```
 https://docs.celo.org/mcp
@@ -35,7 +35,7 @@ It uses streamable HTTP, needs no authentication, and exposes three tools:
 It also serves a **Celo Developer Playbook** skill resource — condensed guidance on deploying contracts, integrating wallets, fee abstraction, running nodes, and governance — which supporting clients load automatically.
 
 <Note>
-  This server answers questions about the **documentation**. To let an assistant read **live chain data** — balances, blocks, governance proposals — use the [Celo MCP Server](/build-on-celo/build-with-ai/mcp/celo-mcp) instead. The two are complementary, and you can run both.
+  This server answers questions about the **documentation**. To let an assistant read **live chain data** — balances, blocks, governance proposals — use the [Celo MCP Server](/build/agents/mcp/celo-mcp) instead. The two are complementary, and you can run both.
 </Note>
 
 <Tabs>
@@ -222,21 +222,21 @@ Every page has a contextual menu beside its title:
 - **Open in ChatGPT / Claude / Cursor / VS Code** — starts a session with the page as context, or installs the docs MCP server.
 - **Copy MCP server URL** — copies `https://docs.celo.org/mcp` to your clipboard.
 
-You can also skip the menu: **append `.md` to any docs URL** to get the Markdown directly. For example, [`docs.celo.org/build-on-celo/quickstart.md`](https://docs.celo.org/build-on-celo/quickstart.md). This works well in scripts and agent tooling that fetches URLs.
+You can also skip the menu: **append `.md` to any docs URL** to get the Markdown directly. For example, [`docs.celo.org/build/quickstart.md`](https://docs.celo.org/build/quickstart.md). This works well in scripts and agent tooling that fetches URLs.
 
 ## Related
 
 <CardGroup cols={2}>
-  <Card title="Celo MCP Server" icon="server" href="/build-on-celo/build-with-ai/mcp/celo-mcp">
+  <Card title="Celo MCP Server" icon="server" href="/build/agents/mcp/celo-mcp">
     Query live chain data — blocks, transactions, balances, gas fees, governance and staking — from your editor.
   </Card>
-  <Card title="Celopedia" icon="graduation-cap" href="/build-on-celo/build-with-ai/celopedia">
+  <Card title="Celopedia" icon="graduation-cap" href="/build/agents/celopedia">
     A skill that gives your coding assistant curated Celo knowledge: contract addresses, protocols, MiniPay, and grants.
   </Card>
-  <Card title="What is MCP?" icon="plug" href="/build-on-celo/build-with-ai/mcp/index">
+  <Card title="What is MCP?" icon="plug" href="/build/agents/mcp/index">
     How the Model Context Protocol works and why AI tools use it.
   </Card>
-  <Card title="Vibe Coding Tools" icon="wand-magic-sparkles" href="/build-on-celo/build-with-ai/vibe-coding">
+  <Card title="Vibe Coding Tools" icon="wand-magic-sparkles" href="/build/agents/vibe-coding">
     AI-assisted development tools that work well for building on Celo.
   </Card>
 </CardGroup>
diff --git a/build-on-celo/build-with-ai/usecases.mdx b/build/agents/usecases.mdx
similarity index 100%
rename from build-on-celo/build-with-ai/usecases.mdx
rename to build/agents/usecases.mdx
diff --git a/build-on-celo/build-with-ai/vibe-coding.mdx b/build/agents/vibe-coding.mdx
similarity index 97%
rename from build-on-celo/build-with-ai/vibe-coding.mdx
rename to build/agents/vibe-coding.mdx
index a502cc0412..981b2482ed 100644
--- a/build-on-celo/build-with-ai/vibe-coding.mdx
+++ b/build/agents/vibe-coding.mdx
@@ -7,7 +7,7 @@ description: Learn how to set up your environment for Vibe Coding and discover t
 
 Vibe Coding refers to an approach to software development where you use chat agents inside your IDE and build an application mainly by using prompts. This guide introduces you to a curated collection of tools that can significantly improve your development process, from full-stack application development to code editing and research.
 
-Watch a quick intro to Vibe Coding with the Celo MCP Servers. You can find out more about them in the [MCP section](/build-on-celo/build-with-ai/mcp/index).
+Watch a quick intro to Vibe Coding with the Celo MCP Servers. You can find out more about them in the [MCP section](/build/agents/mcp/index).
 
 <iframe
   src="https://www.youtube.com/embed/QOCO1G8cJyI"
diff --git a/build-on-celo/build-with-ai/x402-get-discovered.mdx b/build/agents/x402-get-discovered.mdx
similarity index 89%
rename from build-on-celo/build-with-ai/x402-get-discovered.mdx
rename to build/agents/x402-get-discovered.mdx
index 27f66a0379..8d7918eab0 100644
--- a/build-on-celo/build-with-ai/x402-get-discovered.mdx
+++ b/build/agents/x402-get-discovered.mdx
@@ -4,11 +4,11 @@ sidebarTitle: "x402: Get discovered"
 description: Make an x402 endpoint on Celo findable by agents with a self-describing 402 response, index registrations, and an ERC-8004 identity
 ---
 
-This page is for developers who sell an API, a tool, or content over [x402](/build-on-celo/build-with-ai/x402) on Celo and want agents to find it. A working 402 endpoint is invisible until it is described in a way agents can read and listed where agents look. There is no single index. Each one has its own entry rule, and this page lists them.
+This page is for developers who sell an API, a tool, or content over [x402](/build/agents/x402) on Celo and want agents to find it. A working 402 endpoint is invisible until it is described in a way agents can read and listed where agents look. There is no single index. Each one has its own entry rule, and this page lists them.
 
 ## Prerequisites
 
-- A resource server that returns `402 Payment Required` on Celo. Set one up on the [x402 page](/build-on-celo/build-with-ai/x402#pointing-a-resource-server-at-it) first.
+- A resource server that returns `402 Payment Required` on Celo. Set one up on the [x402 page](/build/agents/x402#pointing-a-resource-server-at-it) first.
 - A public HTTPS origin. Indexes probe your endpoint from the outside, and some probe it every hour.
 - Node.js 20 or later and the v2 packages: `@x402/express`, `@x402/core`, `@x402/evm`, `@x402/extensions`.
 
@@ -24,7 +24,7 @@ Discovery has two halves.
 | [agent402.tools](https://agent402.tools/sell) | One `POST` with your origin; the crawler probes it hourly | A public origin that answers with a 402 |
 | [Coinbase x402 discovery](https://docs.cdp.coinbase.com/x402/seller/get-discovered) | Automatic after a paid call settles through Coinbase's facilitator | Coinbase's facilitator settles on Base, Base Sepolia, Polygon, Arbitrum, World and Solana. Listings without a settlement for 30 days are removed |
 | [x402scan](https://www.x402scan.com/resources/register) | Submit the URL; it is added if it returns a valid challenge | Registration accepts Base and Solana resources |
-| [8004scan](https://8004scan.io) | Register an [ERC-8004](/build-on-celo/build-with-ai/8004) identity whose registration file lists your endpoints and sets `x402Support` | An identity on Celo |
+| [8004scan](https://8004scan.io) | Register an [ERC-8004](/build/agents/8004) identity whose registration file lists your endpoints and sets `x402Support` | An identity on Celo |
 | [Buy catalog](https://usebuy.ai) | Ask for a listing with the [buy-skill issue form](https://github.com/celo-org/buy-skill/issues/new?template=list-your-service.yml) | A public origin, a description, a price, and the networks and tokens you accept |
 
 ## Describe your endpoint in the 402
@@ -122,7 +122,7 @@ Submit the endpoint URL at [x402scan.com/resources/register](https://www.x402sca
 
 ## Register an ERC-8004 identity
 
-Agents that look up sellers on [8004scan](https://8004scan.io) read the on-chain registry. Register an identity on Celo, list your endpoints under `services` in the registration file, and set `x402Support` to `true`. The [ERC-8004 page](/build-on-celo/build-with-ai/8004) covers registration and the registry addresses.
+Agents that look up sellers on [8004scan](https://8004scan.io) read the on-chain registry. Register an identity on Celo, list your endpoints under `services` in the registration file, and set `x402Support` to `true`. The [ERC-8004 page](/build/agents/8004) covers registration and the registry addresses.
 
 ## Ask for a listing in the Buy catalog
 
@@ -151,7 +151,7 @@ Buy's catalog is curated. Open a listing request with the [buy-skill issue form]
 
 ## Related
 
-- [x402: Agent Payments](/build-on-celo/build-with-ai/x402) - Set up the resource server this page assumes
-- [ERC-8004: Agent Trust Protocol](/build-on-celo/build-with-ai/8004) - Identity and reputation for the seller behind the endpoint
-- [Attribution Tags](/build-on-celo/attribution-tags) - Credit on-chain activity back to your app
-- [MPP](/build-on-celo/build-with-ai/mpp) - Machine Payments Protocol: charge USDC per request over HTTP
+- [x402: Agent Payments](/build/agents/x402) - Set up the resource server this page assumes
+- [ERC-8004: Agent Trust Protocol](/build/agents/8004) - Identity and reputation for the seller behind the endpoint
+- [Attribution Tags](/build/agents/attribution-tags) - Credit on-chain activity back to your app
+- [MPP](/build/agents/mpp) - Machine Payments Protocol: charge USDC per request over HTTP
diff --git a/build-on-celo/build-with-ai/x402.mdx b/build/agents/x402.mdx
similarity index 94%
rename from build-on-celo/build-with-ai/x402.mdx
rename to build/agents/x402.mdx
index 05cb3ffe63..d8c07c4e95 100644
--- a/build-on-celo/build-with-ai/x402.mdx
+++ b/build/agents/x402.mdx
@@ -184,7 +184,7 @@ Celo is an ideal network for x402 due to:
 - **Low fees**: Gas costs under $0.001 per transaction
 - **Fast finality**: ~1 second block times
 - **Stablecoin support**: Native USDC and USDT for predictable pricing
-- **Fee abstraction**: Agents can pay gas in the same stablecoins used for x402 payments — no separate CELO balance needed. See [Fee Abstraction for Agents](/build-on-celo/build-with-ai/overview#fee-abstraction-for-agents)
+- **Fee abstraction**: Agents can pay gas in the same stablecoins used for x402 payments — no separate CELO balance needed. See [Fee Abstraction for Agents](/build/agents/overview#fee-abstraction-for-agents)
 
 ### Supported Payment Tokens on Celo
 
@@ -265,9 +265,9 @@ thirdweb runs a hosted x402 facilitator that supports Celo — see the [thirdweb
 
 ## Related
 
-- [ERC-8004](/build-on-celo/build-with-ai/8004) - Trust layer for AI agents
-- [x402: Get your endpoint discovered](/build-on-celo/build-with-ai/x402-get-discovered) - Make the endpoint findable by agents and indexes
-- [MPP](/build-on-celo/build-with-ai/mpp) - Machine Payments Protocol: charge USDC per request over HTTP
-- [Celopedia](/build-on-celo/build-with-ai/celopedia) - Celo ecosystem knowledge for coding assistants
-- [Fee Abstraction](/build-on-celo/fee-abstraction/overview) - Pay gas with stablecoins on Celo
-- [Attribution Tags](/build-on-celo/attribution-tags) - Credit on-chain activity back to your app
+- [ERC-8004](/build/agents/8004) - Trust layer for AI agents
+- [x402: Get your endpoint discovered](/build/agents/x402-get-discovered) - Make the endpoint findable by agents and indexes
+- [MPP](/build/agents/mpp) - Machine Payments Protocol: charge USDC per request over HTTP
+- [Celopedia](/build/agents/celopedia) - Celo ecosystem knowledge for coding assistants
+- [Fee Abstraction](/build/fee-abstraction/overview) - Pay gas with stablecoins on Celo
+- [Attribution Tags](/build/agents/attribution-tags) - Credit on-chain activity back to your app
diff --git a/build-on-celo/build-on-socialconnect.mdx b/build/build-on-socialconnect.mdx
similarity index 87%
rename from build-on-celo/build-on-socialconnect.mdx
rename to build/build-on-socialconnect.mdx
index 379c41cee5..b49c63d57c 100644
--- a/build-on-celo/build-on-socialconnect.mdx
+++ b/build/build-on-socialconnect.mdx
@@ -36,9 +36,9 @@ For detailed guides and examples, refer to the [SocialConnect documentation](htt
 
 ## Related
 
-- [ODIS](/tooling/libraries-sdks/contractkit/odis) - the phone-number privacy service SocialConnect looks identifiers up through
-- [Build with Self](/build-on-celo/build-with-self) - proof of personhood from a passport or ID document
-- [MiniPay](/build-on-celo/build-on-minipay/overview) - maps phone numbers to addresses through SocialConnect
+- [ODIS](/build/tools/libraries-sdks/contractkit/odis) - the phone-number privacy service SocialConnect looks identifiers up through
+- [Build with Self](/build/build-with-self) - proof of personhood from a passport or ID document
+- [MiniPay](/build/mini-apps/overview) - maps phone numbers to addresses through SocialConnect
 
 ## Resources
 
diff --git a/build-on-celo/build-with-defi.mdx b/build/build-with-defi.mdx
similarity index 88%
rename from build-on-celo/build-with-defi.mdx
rename to build/build-with-defi.mdx
index 1e79d378a2..ff6e9bcd95 100644
--- a/build-on-celo/build-with-defi.mdx
+++ b/build/build-with-defi.mdx
@@ -15,13 +15,13 @@ Explore below how to integrate stablecoins, exchanges, and oracles into your nex
 
 ## Why Stablecoins Matter
 
-[Stablecoins](/build-on-celo/build-with-local-stablecoin) are digital assets pegged to a stable reserve, such as fiat currency or a basket of assets. They provide key benefits in DeFi and financial transactions and financial inclusion:
+[Stablecoins](/build/build-with-local-stablecoin) are digital assets pegged to a stable reserve, such as fiat currency or a basket of assets. They provide key benefits in DeFi and financial transactions and financial inclusion:
 
 <Info>
   Check out [Build with Local
-  Stablecoins](/build-on-celo/build-with-local-stablecoin) for an overview of
+  Stablecoins](/build/build-with-local-stablecoin) for an overview of
   Celo's stablecoin ecosystem, or [Stablecoin
-  Contracts](/tooling/contracts/stablecoin-contracts) for their addresses.
+  Contracts](/build/tools/contracts/stablecoin-contracts) for their addresses.
 </Info>
 
 - **Price Stability** – Unlike volatile cryptocurrencies, stablecoins maintain a predictable value.
@@ -46,7 +46,7 @@ Celo supports a vibrant ecosystem of DeFi protocols that utilize stablecoins:
 
 ### Exchanges
 
-Find all Exchanges [here](/learn/exchanges). For cross-chain exchanges check out the [bridges](/tooling/bridges) and [cross-chain messaging](/tooling/bridges/cross-chain-messaging) pages.
+Find all Exchanges [here](/learn/exchanges). For cross-chain exchanges check out the [bridges](/build/tools/bridges/bridges) and [cross-chain messaging](/build/tools/bridges/cross-chain-messaging) pages.
 
 - **[Uniswap v4](https://app.uniswap.org/)** – Launched on Celo in early 2025, bringing advanced "Hooks" features for developer customizations, low-cost swaps, and sub-cent transaction fees. Enables seamless integration with Ethereum liquidity.
 - **[Velodrome](https://velodrome.finance/)** – Decentralized exchange where you can execute low-fee swaps, deposit tokens to earn rewards, and actively participate in the onchain economy. Offers high liquidity mining yields.
@@ -70,12 +70,12 @@ Find all Exchanges [here](/learn/exchanges). For cross-chain exchanges check out
 
 ### Oracles
 
-Oracles are a crucial part to get real time price information on tokens. Speed is crucial when it comes to building DeFi applications, and you should not rely on web2 APIs for price feeds. Find all Oracles in the [tooling section](/tooling/oracles).
+Oracles are a crucial part to get real time price information on tokens. Speed is crucial when it comes to building DeFi applications, and you should not rely on web2 APIs for price feeds. Find all Oracles in the [tooling section](/build/tools/oracles).
 
-- [RedStone Oracles](/tooling/oracles/redstone)
+- [RedStone Oracles](/build/tools/oracles/redstone)
 - [Chainlink Price Feed Oracles](https://docs.chain.link/data-feeds/price-feeds/addresses?network=celo)
-- [Supra Oracles](/tooling/oracles/supra)
-- [Band Protocol](/tooling/oracles/band-protocol)
+- [Supra Oracles](/build/tools/oracles/supra)
+- [Band Protocol](/build/tools/oracles/band-protocol)
 
 ### Human-Centered Security Tools
 
diff --git a/build-on-celo/build-with-farcaster.mdx b/build/build-with-farcaster.mdx
similarity index 97%
rename from build-on-celo/build-with-farcaster.mdx
rename to build/build-with-farcaster.mdx
index 6cec840348..a820167967 100644
--- a/build-on-celo/build-with-farcaster.mdx
+++ b/build/build-with-farcaster.mdx
@@ -225,14 +225,14 @@ function ApproveAndSwap() {
             abi: erc20Abi,
             functionName: "approve",
             args: [
-              "0xYourSwapRouterAddress", // a router deployed on Celo — see /tooling/contracts/uniswap-contracts
+              "0xYourSwapRouterAddress", // a router deployed on Celo — see /build/tools/contracts/uniswap-contracts
               parseUnits("100", 6), // Amount
             ],
           }),
         },
         // Swap USDC for CELO
         {
-          to: "0xYourSwapRouterAddress", // a router deployed on Celo — see /tooling/contracts/uniswap-contracts
+          to: "0xYourSwapRouterAddress", // a router deployed on Celo — see /build/tools/contracts/uniswap-contracts
           data: encodeFunctionData({
             abi: uniswapAbi,
             functionName: "swapExactTokensForETH",
@@ -250,7 +250,7 @@ function ApproveAndSwap() {
 ```
 
 <Warning>
-The swap example is a shape, not a recipe: the router address must be one deployed on Celo — pick it from [Uniswap contracts on Celo](/tooling/contracts/uniswap-contracts) — and the ABI must match that router (Celo has Uniswap v3/v4; the v2-style `swapExactTokensForETH` shown here will not work against them unchanged).
+The swap example is a shape, not a recipe: the router address must be one deployed on Celo — pick it from [Uniswap contracts on Celo](/build/tools/contracts/uniswap-contracts) — and the ABI must match that router (Celo has Uniswap v3/v4; the v2-style `swapExactTokensForETH` shown here will not work against them unchanged).
 </Warning>
 
 <Info>
diff --git a/build-on-celo/build-with-local-stablecoin.mdx b/build/build-with-local-stablecoin.mdx
similarity index 78%
rename from build-on-celo/build-with-local-stablecoin.mdx
rename to build/build-with-local-stablecoin.mdx
index df31086ba6..6515241636 100644
--- a/build-on-celo/build-with-local-stablecoin.mdx
+++ b/build/build-with-local-stablecoin.mdx
@@ -5,7 +5,7 @@ description: An overview of all stablecoins on Celo
 
 Celo supports more than 30 fiat-referenced stablecoins: 7 USD-pegged assets, 27 pegged to regional currencies, and GoodDollar's UBI token. Most chains give builders a dollar and little else. On Celo, a payments app in Nairobi can settle in KESm, a remittance corridor into Brazil can settle in BRLm, and neither has to route through a dollar first.
 
-<Card title="Stablecoin Contracts" icon="file-contract" href="/tooling/contracts/stablecoin-contracts" arrow>
+<Card title="Stablecoin Contracts" icon="file-contract" href="/build/tools/contracts/stablecoin-contracts" arrow>
   Contract addresses for every stablecoin on Celo Mainnet and the Celo Sepolia Testnet.
 </Card>
 
@@ -39,7 +39,7 @@ Alongside Mento, independent issuers have deployed stablecoins on Celo:
 | ------ | ------ |
 | [Circle](https://www.circle.com/usdc) | USDC |
 | [Tether](https://tether.to/en/) | USD₮ |
-| [Anchorage Digital Bank](https://usat.io/) | [USA₮](/build-on-celo/build-with-usat) |
+| [Anchorage Digital Bank](https://usat.io/) | [USA₮](/build/build-with-usat) |
 | [Ripio](https://ripio.com/) | wARS, wBRL, wMXN, wCOP, wPEN, wCLP |
 | [VNX](https://vnx.io/) | vGBP, vCHF |
 | [Africa Stablecoin Consortium](https://cngn.co/) | cNGN |
@@ -53,21 +53,21 @@ Alongside Mento, independent issuers have deployed stablecoins on Celo:
 
 ## Paying Gas in Stablecoins
 
-Users don't need to hold CELO to transact. Celo's [fee abstraction](/build-on-celo/fee-abstraction/overview) lets them pay gas in ERC20 tokens, and every Mento stablecoin plus USDC, USD₮ and USA₮ is on the allowlist — so a wallet holding only KESm can still send a transaction. See [Fee Currencies](/tooling/contracts/fee-currencies) for the current list.
+Users don't need to hold CELO to transact. Celo's [fee abstraction](/build/fee-abstraction/overview) lets them pay gas in ERC20 tokens, and every Mento stablecoin plus USDC, USD₮ and USA₮ is on the allowlist — so a wallet holding only KESm can still send a transaction. See [Fee Currencies](/build/tools/contracts/fee-currencies) for the current list.
 
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Stablecoin Contracts" icon="file-contract" href="/tooling/contracts/stablecoin-contracts">
+  <Card title="Stablecoin Contracts" icon="file-contract" href="/build/tools/contracts/stablecoin-contracts">
     Contract addresses on Celo Mainnet and the Celo Sepolia Testnet.
   </Card>
-  <Card title="Fee Abstraction" icon="gas-pump" href="/build-on-celo/fee-abstraction/overview">
+  <Card title="Fee Abstraction" icon="gas-pump" href="/build/fee-abstraction/overview">
     Let users pay gas fees in the stablecoin they already hold.
   </Card>
-  <Card title="Build for MiniPay" icon="mobile" href="/build-on-celo/build-on-minipay/overview">
+  <Card title="Build for MiniPay" icon="mobile" href="/build/mini-apps/overview">
     Reach mobile users of a stablecoin wallet built into Opera Mini.
   </Card>
-  <Card title="Build with DeFi" icon="chart-line" href="/build-on-celo/build-with-defi">
+  <Card title="Build with DeFi" icon="chart-line" href="/build/build-with-defi">
     Integrate swaps, lending, and oracles on top of these assets.
   </Card>
 </CardGroup>
diff --git a/build-on-celo/build-with-self.mdx b/build/build-with-self.mdx
similarity index 84%
rename from build-on-celo/build-with-self.mdx
rename to build/build-with-self.mdx
index 8376a94151..b064c57a20 100644
--- a/build-on-celo/build-with-self.mdx
+++ b/build/build-with-self.mdx
@@ -5,7 +5,7 @@ description: Verify that your users are real, unique humans — and prove age or
 
 This page is for app developers who need to know that a user is a real, unique human, or that they meet an age or nationality rule, without collecting their documents. [Self](https://self.xyz/) is an open-source identity protocol: the user scans a passport, EU ID card or Indian Aadhaar with their phone, a zero-knowledge proof is generated on the device, and your app receives only the facts the user chose to disclose. Attestations are recorded on Celo.
 
-If you are giving an **AI agent** an identity rather than verifying a person, go to [Self Agent ID](/build-on-celo/build-with-ai/self-agent-id).
+If you are giving an **AI agent** an identity rather than verifying a person, go to [Self Agent ID](/build/agents/self-agent-id).
 
 ## How it works
 
@@ -30,7 +30,7 @@ No personal data leaves the device. The same proof also yields a nullifier, so y
 2. Follow the [Self quickstart](https://docs.self.xyz/docs/self-pass/quickstart) to add the QR-code flow to your frontend with the [QRCode SDK](https://docs.self.xyz/docs/self-pass/frontend/qrcode-sdk).
 3. Verify proofs either on-chain with the [contract integration guide](https://docs.self.xyz/docs/self-pass/contracts/basic-integration) — deployed hub addresses are in [Deployed contracts](https://docs.self.xyz/docs/self-pass/contracts/deployed-contracts) — or in your backend with the [backend integration guide](https://docs.self.xyz/docs/self-pass/backend/basic-integration).
 
-Self's contracts on Celo follow the same fee rules as any other contract: your users can pay gas in USDm, USDC or USDT through [fee abstraction](/build-on-celo/fee-abstraction/overview), so a verification flow never requires them to hold CELO.
+Self's contracts on Celo follow the same fee rules as any other contract: your users can pay gas in USDm, USDC or USDT through [fee abstraction](/build/fee-abstraction/overview), so a verification flow never requires them to hold CELO.
 
 ## Resources
 
@@ -45,7 +45,7 @@ Self's contracts on Celo follow the same fee rules as any other contract: your u
 
 ## Related
 
-- [Self Agent ID](/build-on-celo/build-with-ai/self-agent-id) - Proof-of-human identity for AI agents
-- [ERC-8004](/build-on-celo/build-with-ai/8004) - Agent identity, reputation and validation registries
-- [SocialConnect](/build-on-celo/build-on-socialconnect) - Map phone numbers to addresses
-- [Fee abstraction](/build-on-celo/fee-abstraction/overview) - Let users pay gas in stablecoins
+- [Self Agent ID](/build/agents/self-agent-id) - Proof-of-human identity for AI agents
+- [ERC-8004](/build/agents/8004) - Agent identity, reputation and validation registries
+- [SocialConnect](/build/build-on-socialconnect) - Map phone numbers to addresses
+- [Fee abstraction](/build/fee-abstraction/overview) - Let users pay gas in stablecoins
diff --git a/build-on-celo/build-with-usat.mdx b/build/build-with-usat.mdx
similarity index 81%
rename from build-on-celo/build-with-usat.mdx
rename to build/build-with-usat.mdx
index fbf8fc041f..9ff55012b0 100644
--- a/build-on-celo/build-with-usat.mdx
+++ b/build/build-with-usat.mdx
@@ -50,7 +50,7 @@ const tx = {
 
 > Passing the token address instead of the adapter address is a common bug. Always use the adapter for 6-decimal tokens.
 
-For a full implementation guide, see [Using Fee Abstraction](/build-on-celo/fee-abstraction/using-fee-abstraction).
+For a full implementation guide, see [Using Fee Abstraction](/build/fee-abstraction/using-fee-abstraction).
 
 ## What to Build
 
@@ -58,7 +58,7 @@ For a full implementation guide, see [Using Fee Abstraction](/build-on-celo/fee-
 
 **Self faucet client** — Walk through the ZK proof-of-humanity flow: verify through the Self SDK, clear the check, claim USA₮. Useful reference for any app integrating the same pattern.
 
-**AI agent payments** — Use [x402](/build-on-celo/build-with-ai/x402) (HTTP-native micropayments) to build an agent that settles in USA₮ — a regulated dollar as the settlement asset for agentic flows.
+**AI agent payments** — Use [x402](/build/agents/x402) (HTTP-native micropayments) to build an agent that settles in USA₮ — a regulated dollar as the settlement asset for agentic flows.
 
 **DeFi integration** — Build USA₮ liquidity pools on Aave V3, Uniswap V3, Velodrome, or Morpho Blue on Celo. Pool creation is permissionless on all three. Morpho Blue allows permissionless isolated lending markets — no governance approval needed to create a USA₮ lending or collateral market.
 
@@ -68,9 +68,9 @@ For a full implementation guide, see [Using Fee Abstraction](/build-on-celo/fee-
 
 ## Related
 
-- [Build with Local Stablecoins](/build-on-celo/build-with-local-stablecoin) — Full list of stablecoins on Celo
-- [Fee Abstraction Overview](/build-on-celo/fee-abstraction/overview) — How fee abstraction works and whitelisted fee currencies
-- [Using Fee Abstraction](/build-on-celo/fee-abstraction/using-fee-abstraction) — Implementation guide
-- [Build with Self](/build-on-celo/build-with-self) — ZK proof-of-humanity integration
-- [x402: Agent Payments](/build-on-celo/build-with-ai/x402) — HTTP-native stablecoin payments
+- [Build with Local Stablecoins](/build/build-with-local-stablecoin) — Full list of stablecoins on Celo
+- [Fee Abstraction Overview](/build/fee-abstraction/overview) — How fee abstraction works and whitelisted fee currencies
+- [Using Fee Abstraction](/build/fee-abstraction/using-fee-abstraction) — Implementation guide
+- [Build with Self](/build/build-with-self) — ZK proof-of-humanity integration
+- [x402: Agent Payments](/build/agents/x402) — HTTP-native stablecoin payments
 - [Celopedia](https://celopedia.celo.org/) — Celo's builder knowledge base
diff --git a/build-on-celo/fee-abstraction/add-fee-currency.mdx b/build/fee-abstraction/add-fee-currency.mdx
similarity index 93%
rename from build-on-celo/fee-abstraction/add-fee-currency.mdx
rename to build/fee-abstraction/add-fee-currency.mdx
index 96f413854c..41a221fdca 100644
--- a/build-on-celo/fee-abstraction/add-fee-currency.mdx
+++ b/build/fee-abstraction/add-fee-currency.mdx
@@ -11,7 +11,7 @@ Any ERC20 token can become a fee currency on Celo. Two steps are required:
 
 This guide walks through both steps.
 
-For background on how fee abstraction works, see the [Overview](/build-on-celo/fee-abstraction/overview).
+For background on how fee abstraction works, see the [Overview](/build/fee-abstraction/overview).
 
 ---
 
@@ -155,8 +155,8 @@ Key things to test:
 
 ## Step 2: Register Through Governance
 
-Once your token implements `IFeeCurrency`, it must be added to the on-chain allowlist in [**FeeCurrencyDirectory.sol**](/tooling/contracts/core-contracts) through a governance proposal. The governance process ensures that fee currencies meet the necessary requirements for network stability.
+Once your token implements `IFeeCurrency`, it must be added to the on-chain allowlist in [**FeeCurrencyDirectory.sol**](/build/tools/contracts/core-contracts) through a governance proposal. The governance process ensures that fee currencies meet the necessary requirements for network stability.
 
 Unlike step 1, you don't have to navigate this step alone — the Celo team can support you through the governance process. Reach out on the [Celo Discord server](https://discord.com/invite/celo) to get started.
 
-If your token uses decimals other than 18, you will also need to deploy an adapter contract. See [Adapters for Non-18-Decimal Tokens](/build-on-celo/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens) for details.
+If your token uses decimals other than 18, you will also need to deploy an adapter contract. See [Adapters for Non-18-Decimal Tokens](/build/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens) for details.
diff --git a/build-on-celo/fee-abstraction/overview.mdx b/build/fee-abstraction/overview.mdx
similarity index 61%
rename from build-on-celo/fee-abstraction/overview.mdx
rename to build/fee-abstraction/overview.mdx
index 4be48f5fe4..2765c11449 100644
--- a/build-on-celo/fee-abstraction/overview.mdx
+++ b/build/fee-abstraction/overview.mdx
@@ -4,7 +4,7 @@ sidebarTitle: "Overview"
 description: Pay gas fees in ERC20 tokens instead of CELO, how the protocol charges them, and which wallets build the CIP-64 transaction that makes it work
 ---
 
-This page is the guide to fee abstraction for app and agent developers. To send a transaction, see [Using fee abstraction](/build-on-celo/fee-abstraction/using-fee-abstraction). For token and adapter addresses, see [Fee currency contracts](/tooling/contracts/fee-currencies). For the protocol rules (exchange rates, tx-pool checks, intrinsic gas, node flags), see the [fee abstraction specification](/operate/specification/fee-abstraction).
+This page is the guide to fee abstraction for app and agent developers. To send a transaction, see [Using fee abstraction](/build/fee-abstraction/using-fee-abstraction). For token and adapter addresses, see [Fee currency contracts](/build/tools/contracts/fee-currencies). For the protocol rules (exchange rates, tx-pool checks, intrinsic gas, node flags), see the [fee abstraction specification](/operate/specification/fee-abstraction).
 
 Fee abstraction is one of Celo's core protocol features. It allows users to pay gas fees in ERC20 tokens — like USDC, USDT, or Mento stablecoins — instead of needing to hold the native CELO token.
 
@@ -30,7 +30,7 @@ This means fee abstraction works with any externally owned account (EOA) at the
 
 To use an alternate fee currency, set its token or adapter address as the `feeCurrency` property on the transaction object.
 
-For implementation details, see [Using Fee Abstraction](/build-on-celo/fee-abstraction/using-fee-abstraction). To add a new fee currency to the protocol, see [Adding Fee Currencies](/build-on-celo/fee-abstraction/add-fee-currency).
+For implementation details, see [Using Fee Abstraction](/build/fee-abstraction/using-fee-abstraction). To add a new fee currency to the protocol, see [Adding Fee Currencies](/build/fee-abstraction/add-fee-currency).
 
 ## Wallet support for CIP-64
 
@@ -42,28 +42,28 @@ The protocol accepts a `feeCurrency` transaction from any account, but something
 
 | Wallet | How `feeCurrency` is handled |
 |---|---|
-| [MiniPay](/build-on-celo/build-on-minipay/overview) | Pays gas in the stablecoin the user holds the most of, and [may override](/build-on-celo/build-on-minipay/overview#gas-is-paid-in-stablecoins) a `feeCurrency` you set |
+| [MiniPay](/build/mini-apps/overview) | Pays gas in the stablecoin the user holds the most of, and [may override](/build/mini-apps/overview#gas-is-paid-in-stablecoins) a `feeCurrency` you set |
 | [Valora](https://valora.xyz/) | Builds CIP-64 itself and ignores a `feeCurrency` you set. It re-selects, paying in CELO when the balance covers the fee and otherwise in the fee currency the user holds the most of by value. See the [wallet source](https://github.com/valora-xyz/wallet-stack/blob/df76b6befdc50b94a19646234d7128d67159d1cd/packages/wallet-stack/src/walletConnect/saga.ts) |
-| [Ledger Live](/tooling/wallets/ledger/setup) | Ledger Live's own send flow builds CIP-64 and lets the user choose the fee currency, on Ledger Live 4.8 or later. This does not extend to apps: a Ledger used through MetaMask signs what MetaMask builds, and MetaMask drops `feeCurrency` |
-| [MetaMask](/tooling/wallets/metamask/setup) | Not supported. The [transaction controller](https://github.com/MetaMask/core/blob/418d6759bdde9cdf450444a8db66d41b78f8128c/packages/transaction-controller/src/utils/utils.ts) keeps only the fields it knows, so `feeCurrency` is dropped and gas is charged in CELO |
+| [Ledger Live](/build/tools/wallets/ledger/setup) | Ledger Live's own send flow builds CIP-64 and lets the user choose the fee currency, on Ledger Live 4.8 or later. This does not extend to apps: a Ledger used through MetaMask signs what MetaMask builds, and MetaMask drops `feeCurrency` |
+| [MetaMask](/build/tools/wallets/metamask/setup) | Not supported. The [transaction controller](https://github.com/MetaMask/core/blob/418d6759bdde9cdf450444a8db66d41b78f8128c/packages/transaction-controller/src/utils/utils.ts) keeps only the fields it knows, so `feeCurrency` is dropped and gas is charged in CELO |
 
 A wallet not listed here has not been confirmed either way. Check with the wallet before assuming. If a flow depends on fee abstraction, such as onboarding a user who holds no CELO, either target a wallet on this list or keep a path that works when gas is charged in CELO.
 
-Library support is a separate question from wallet support, and a library in a wallet's stack says nothing about whether that wallet forwards an app's `feeCurrency`. For viem, Ethers.js and web3.js, see [Using Fee Abstraction](/build-on-celo/fee-abstraction/using-fee-abstraction#using-fee-abstraction-with-viem).
+Library support is a separate question from wallet support, and a library in a wallet's stack says nothing about whether that wallet forwards an app's `feeCurrency`. For viem, Ethers.js and web3.js, see [Using Fee Abstraction](/build/fee-abstraction/using-fee-abstraction#using-fee-abstraction-with-viem).
 
 ## Fee currencies and adapters
 
-The allowlist, with token and adapter addresses for each network, is on [Fee currency contracts](/tooling/contracts/fee-currencies). Tokens with 6 decimals (USDC, USDT, USA₮) go through an adapter, and the adapter address, not the token address, is the `feeCurrency` value; see [adapters for non-18-decimal tokens](/build-on-celo/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens).
+The allowlist, with token and adapter addresses for each network, is on [Fee currency contracts](/build/tools/contracts/fee-currencies). Tokens with 6 decimals (USDC, USDT, USA₮) go through an adapter, and the adapter address, not the token address, is the `feeCurrency` value; see [adapters for non-18-decimal tokens](/build/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens).
 
 ---
 
 ## Related
 
-- [Fee currency contracts](/tooling/contracts/fee-currencies) — Allowlisted tokens with their `feeCurrency` and token addresses
+- [Fee currency contracts](/build/tools/contracts/fee-currencies) — Allowlisted tokens with their `feeCurrency` and token addresses
 - [Fee abstraction specification](/operate/specification/fee-abstraction) — Protocol rules, JSON-RPC changes and node flags
-- [Fee Abstraction for AI Agents](/build-on-celo/build-with-ai/overview#fee-abstraction-for-agents) — Using fee abstraction in autonomous agent backends
-- [x402: Agent Payments](/build-on-celo/build-with-ai/x402) — HTTP-native stablecoin payments for agents
-- [Using Fee Abstraction](/build-on-celo/fee-abstraction/using-fee-abstraction) — How to pay gas with alternate fee currencies in your transactions
-- [Adding Fee Currencies](/build-on-celo/fee-abstraction/add-fee-currency) — How to implement and register a new fee currency
+- [Fee Abstraction for AI Agents](/build/agents/overview#fee-abstraction-for-agents) — Using fee abstraction in autonomous agent backends
+- [x402: Agent Payments](/build/agents/x402) — HTTP-native stablecoin payments for agents
+- [Using Fee Abstraction](/build/fee-abstraction/using-fee-abstraction) — How to pay gas with alternate fee currencies in your transactions
+- [Adding Fee Currencies](/build/fee-abstraction/add-fee-currency) — How to implement and register a new fee currency
 - [Wallets for users](/learn/wallets) — Wallets a holder can install, including the ones in the table above
-- [Wallet integration](/tooling/wallets) — Providers an app can integrate to add wallets
+- [Wallet integration](/build/tools/wallets) — Providers an app can integrate to add wallets
diff --git a/build-on-celo/fee-abstraction/using-fee-abstraction.mdx b/build/fee-abstraction/using-fee-abstraction.mdx
similarity index 85%
rename from build-on-celo/fee-abstraction/using-fee-abstraction.mdx
rename to build/fee-abstraction/using-fee-abstraction.mdx
index d9b66d41ec..55377d307e 100644
--- a/build-on-celo/fee-abstraction/using-fee-abstraction.mdx
+++ b/build/fee-abstraction/using-fee-abstraction.mdx
@@ -4,13 +4,13 @@ sidebarTitle: "Using Fee Abstraction"
 description: How to pay gas fees using alternate fee currencies on Celo with viem and celocli
 ---
 
-This page is the how-to for app and agent developers: send transactions that pay gas fees in ERC20 tokens instead of CELO. For background and wallet support, see the [overview](/build-on-celo/fee-abstraction/overview). For token and adapter addresses, see [Fee currency contracts](/tooling/contracts/fee-currencies). For the protocol rules, see the [fee abstraction specification](/operate/specification/fee-abstraction).
+This page is the how-to for app and agent developers: send transactions that pay gas fees in ERC20 tokens instead of CELO. For background and wallet support, see the [overview](/build/fee-abstraction/overview). For token and adapter addresses, see [Fee currency contracts](/build/tools/contracts/fee-currencies). For the protocol rules, see the [fee abstraction specification](/operate/specification/fee-abstraction).
 
 ---
 
 ## Allowlisted Fee Currencies
 
-The protocol maintains a governable allowlist of smart contract addresses that can be used as fee currencies. These contracts implement an extension of the ERC20 interface with additional functions for debiting and crediting transaction fees (see [Adding Fee Currencies](/build-on-celo/fee-abstraction/add-fee-currency)).
+The protocol maintains a governable allowlist of smart contract addresses that can be used as fee currencies. These contracts implement an extension of the ERC20 interface with additional functions for debiting and crediting transaction fees (see [Adding Fee Currencies](/build/fee-abstraction/add-fee-currency)).
 
 To fetch the current allowlist, call `getCurrencies()` on the `FeeCurrencyDirectory` contract, or use `celocli`:
 ```bash
@@ -37,7 +37,7 @@ For more on gas pricing, see [Transaction Fees](/operate/specification/transacti
 
 ### Adapter Addresses
 
-The current adapter and token addresses for each network are listed on the [Fee currency contracts](/tooling/contracts/fee-currencies) page, which is generated from the on-chain `FeeCurrencyDirectory` allowlist.
+The current adapter and token addresses for each network are listed on the [Fee currency contracts](/build/tools/contracts/fee-currencies) page, which is generated from the on-chain `FeeCurrencyDirectory` allowlist.
 
 ---
 
@@ -71,7 +71,7 @@ celocli transfer:erc20 \
 
 ## Using Fee Abstraction with viem
 
-We recommend [viem](https://viem.sh/), which serializes CIP-64 natively when you pass a Celo chain from `viem/chains`. Ethers.js and web3.js do not support the field on their own; use the [Celo Ethers.js wrapper](/tooling/libraries-sdks/ethers) or the [web3 transaction-types plugin](/tooling/libraries-sdks/web3). Whichever library you use, the wallet that signs the transaction must also support CIP-64; see [wallet support](/build-on-celo/fee-abstraction/overview#wallet-support-for-cip-64).
+We recommend [viem](https://viem.sh/), which serializes CIP-64 natively when you pass a Celo chain from `viem/chains`. Ethers.js and web3.js do not support the field on their own; use the [Celo Ethers.js wrapper](/build/tools/libraries-sdks/ethers) or the [web3 transaction-types plugin](/build/tools/libraries-sdks/web3). Whichever library you use, the wallet that signs the transaction must also support CIP-64; see [wallet support](/build/fee-abstraction/overview#wallet-support-for-cip-64).
 
 ### 1. Estimate the Gas Fee
 
@@ -198,10 +198,10 @@ async function send(amountInWei) {
 
 | Symptom | Cause and fix |
 |---|---|
-| `fee currency not registered: 0x…` from `eth_estimateGas` | The `feeCurrency` value is not on the allowlist. For USDC, USDT and USA₮ it is usually the token address: use the adapter address from [Fee currency contracts](/tooling/contracts/fee-currencies). The zero address is not an alias for CELO either; omit `feeCurrency` to pay in CELO. |
+| `fee currency not registered: 0x…` from `eth_estimateGas` | The `feeCurrency` value is not on the allowlist. For USDC, USDT and USA₮ it is usually the token address: use the adapter address from [Fee currency contracts](/build/tools/contracts/fee-currencies). The zero address is not an alias for CELO either; omit `feeCurrency` to pay in CELO. |
 | `execution reverted: Currency not in the directory` from `eth_gasPrice` | Same cause: the address passed as the `feeCurrency` parameter is a token address, not an adapter or directory entry. |
 | `could not convert from native to fee currency (fee-currency=0x…): unregistered fee-currency address` from `eth_maxPriorityFeePerGas` | Same cause: pass the adapter address, not the token address. |
-| The transaction succeeds but gas was charged in CELO, or fails with an insufficient-funds error although the user holds the stablecoin | The wallet dropped `feeCurrency`. Check [wallet support for CIP-64](/build-on-celo/fee-abstraction/overview#wallet-support-for-cip-64). |
+| The transaction succeeds but gas was charged in CELO, or fails with an insufficient-funds error although the user holds the stablecoin | The wallet dropped `feeCurrency`. Check [wallet support for CIP-64](/build/fee-abstraction/overview#wallet-support-for-cip-64). |
 | A transfer or fee is 10¹² times too large or too small | USDC, USDT and USA₮ have 6 decimals, but `eth_gasPrice` and `balanceOf` on the adapter report 18 decimals. Use 6 decimals for token transfers and 18 for gas math. |
 
 Where to set the fee currency:
@@ -210,7 +210,7 @@ Where to set the fee currency:
 |---|---|
 | viem | `feeCurrency` on the transaction, with a Celo chain from `viem/chains` |
 | Celo CLI | `--gasCurrency` |
-| Ethers.js, web3.js | Not supported on their own; use the [Celo Ethers.js wrapper](/tooling/libraries-sdks/ethers) or the [web3 transaction-types plugin](/tooling/libraries-sdks/web3) |
+| Ethers.js, web3.js | Not supported on their own; use the [Celo Ethers.js wrapper](/build/tools/libraries-sdks/ethers) or the [web3 transaction-types plugin](/build/tools/libraries-sdks/web3) |
 | JSON-RPC | `feeCurrency` in the `eth_estimateGas` call, and the fee currency address as the parameter of `eth_gasPrice` and `eth_maxPriorityFeePerGas` |
 
 ## Resources
@@ -222,7 +222,7 @@ Where to set the fee currency:
 
 ## Related
 
-- [Fee abstraction guide](/build-on-celo/fee-abstraction/overview) — Background, why it matters and which wallets support it
-- [Fee currency contracts](/tooling/contracts/fee-currencies) — Token and adapter addresses for each network
+- [Fee abstraction guide](/build/fee-abstraction/overview) — Background, why it matters and which wallets support it
+- [Fee currency contracts](/build/tools/contracts/fee-currencies) — Token and adapter addresses for each network
 - [Fee abstraction specification](/operate/specification/fee-abstraction) — Protocol rules, JSON-RPC changes and node flags
-- [Adding fee currencies](/build-on-celo/fee-abstraction/add-fee-currency) — Register a new fee currency
+- [Adding fee currencies](/build/fee-abstraction/add-fee-currency) — Register a new fee currency
diff --git a/build-on-celo/fund-your-project.mdx b/build/fund-your-project.mdx
similarity index 100%
rename from build-on-celo/fund-your-project.mdx
rename to build/fund-your-project.mdx
diff --git a/build-on-celo/index.mdx b/build/index.mdx
similarity index 94%
rename from build-on-celo/index.mdx
rename to build/index.mdx
index 1fa201b0a8..a7894e6080 100644
--- a/build-on-celo/index.mdx
+++ b/build/index.mdx
@@ -16,13 +16,13 @@ Whether you're building your first app or looking to integrate an existing proto
 
 - **EVM Compatibile:** Celo is fully EVM-compatible, offering the same development experience as Ethereum with improved scalability and lower costs.
 - **Fast Transactions:** After the migrations to an L2 Celo now has a **1-second block finality** compared to formerly 5 seconds.
-- **Easy, Low-Cost Payments:** Celo's seamless payment infrastructure, including [Fee Abstraction](/build-on-celo/fee-abstraction/overview), **sub-cent fees**, and **native stablecoins**, enables simple and affordable transactions.
+- **Easy, Low-Cost Payments:** Celo's seamless payment infrastructure, including [Fee Abstraction](/build/fee-abstraction/overview), **sub-cent fees**, and **native stablecoins**, enables simple and affordable transactions.
 - **Global Reach:** Celo provides access to more than **8 million real-world users** with some apps having more than **200,000 DAUs**.
 
 ## Getting Started
 
 <Columns cols={2}>
-    <Card title="Quickstart" href="/build-on-celo/build-with-ai/celopedia" arrow>
+    <Card title="Quickstart" href="/build/agents/celopedia" arrow>
         Get started fast with Celopedia
     </Card>
     <Card title="Deploy on Celo" href="/developer/deploy/index" arrow>
diff --git a/build-on-celo/launch-checklist.mdx b/build/launch-checklist.mdx
similarity index 96%
rename from build-on-celo/launch-checklist.mdx
rename to build/launch-checklist.mdx
index 0430b57d67..331e3a5d22 100644
--- a/build-on-celo/launch-checklist.mdx
+++ b/build/launch-checklist.mdx
@@ -30,7 +30,7 @@ description: A comprehensive guide to assist you in launching apps on Celo.
 
 ### Analytics & Monitoring
 
-- [ ] **Attribution Tags**: Add [attribution tags](/build-on-celo/attribution-tags) to your transactions so on-chain activity is credited to your app (used by MiniPay tracking)
+- [ ] **Attribution Tags**: Add [attribution tags](/build/agents/attribution-tags) to your transactions so on-chain activity is credited to your app (used by MiniPay tracking)
 - [ ] **Analytics Setup**: Configure analytics tracking (e.g., Google Analytics, Mixpanel)
 - [ ] **Monitoring Tools**: Set up monitoring and alerting (e.g., Sentry, DataDog)
 - [ ] **On-Chain Analytics**: Integrate on-chain analytics tools (e.g., Dune, The Graph)
diff --git a/build-on-celo/build-on-minipay/overview.mdx b/build/mini-apps/overview.mdx
similarity index 86%
rename from build-on-celo/build-on-minipay/overview.mdx
rename to build/mini-apps/overview.mdx
index 46314d43e9..68c8c7bfc3 100644
--- a/build-on-celo/build-on-minipay/overview.mdx
+++ b/build/mini-apps/overview.mdx
@@ -11,7 +11,7 @@ MiniPay runs only on Celo (mainnet) and Celo Sepolia (testnet). It has more than
 ## Prerequisites
 
 - A web app (any framework) reachable over HTTPS; for local development use `ngrok http 3000` to expose `localhost`
-- [viem](/tooling/libraries-sdks/viem/index) or [wagmi](https://wagmi.sh/) — both support Celo's fee-currency transactions natively
+- [viem](/build/tools/libraries-sdks/viem/index) or [wagmi](https://wagmi.sh/) — both support Celo's fee-currency transactions natively
 - Testnet funds: CELO from the [Celo Sepolia faucet](https://faucet.celo.org/celo-sepolia), swapped to a stablecoin in the [Mento app](https://app.mento.org/)
 - To scaffold: `npx @celo/celo-composer@latest create -t minipay` (the [MiniPay template](https://github.com/celo-org/minipay-template)), or follow the [MiniPay quick start](https://docs.minipay.xyz/getting-started/quick-start.html)
 
@@ -46,11 +46,11 @@ const hash = await walletClient.sendTransaction({
 });
 ```
 
-Testnet addresses are on [Fee currency contracts](/tooling/contracts/fee-currencies).
+Testnet addresses are on [Fee currency contracts](/build/tools/contracts/fee-currencies).
 
 ### Gas is paid in stablecoins
 
-MiniPay uses [fee abstraction](/build-on-celo/fee-abstraction/overview): the user never holds CELO, and the wallet pays gas in the stablecoin the user holds the most of. You may set `feeCurrency` on `eth_sendTransaction`, but MiniPay can override it. Do not build flows that assume a CELO balance, and do not show a "buy CELO for gas" step.
+MiniPay uses [fee abstraction](/build/fee-abstraction/overview): the user never holds CELO, and the wallet pays gas in the stablecoin the user holds the most of. You may set `feeCurrency` on `eth_sendTransaction`, but MiniPay can override it. Do not build flows that assume a CELO balance, and do not show a "buy CELO for gas" step.
 
 To show a fee estimate in the user's currency, estimate gas and gas price in that token. The JSON-RPC methods accept the fee currency directly:
 
@@ -99,7 +99,7 @@ Check for `window.ethereum` before initialising any web3 library; the provider i
 
 ### Resolve MiniPay phone numbers to addresses
 
-MiniPay maps phone numbers to addresses through [SocialConnect](/build-on-celo/build-on-socialconnect) and ODIS. To look a number up you act as an *issuer*: an account that has verified the user owns the number (for example by SMS), has a [data encryption key (DEK)](https://github.com/celo-org/social-connect) registered on the Accounts contract, and holds ODIS quota.
+MiniPay maps phone numbers to addresses through [SocialConnect](/build/build-on-socialconnect) and ODIS. To look a number up you act as an *issuer*: an account that has verified the user owns the number (for example by SMS), has a [data encryption key (DEK)](https://github.com/celo-org/social-connect) registered on the Accounts contract, and holds ODIS quota.
 
 ```bash
 npm install @celo/identity @celo/abis viem
@@ -146,7 +146,7 @@ const [, accounts] = await publicClient.readContract({
 console.log(accounts);
 ```
 
-Contract addresses are from the on-chain registry (`FederatedAttestations`, `OdisPayments`) and listed on [Core contracts](/tooling/contracts/core-contracts). The MiniPay reference for this is [Phone number lookup](https://docs.minipay.xyz/technical-references/phone-number-lookup.html).
+Contract addresses are from the on-chain registry (`FederatedAttestations`, `OdisPayments`) and listed on [Core contracts](/build/tools/contracts/core-contracts). The MiniPay reference for this is [Phone number lookup](https://docs.minipay.xyz/technical-references/phone-number-lookup.html).
 
 ### Deeplinks
 
@@ -209,12 +209,12 @@ Everything below lives at docs.minipay.xyz and is maintained by the MiniPay team
 ## Funding and programs
 
 - Raising? Send a deck or product demo to team@verda.ventures.
-- Grants and accelerators: [Fund your project](/build-on-celo/fund-your-project).
+- Grants and accelerators: [Fund your project](/build/fund-your-project).
 
 ## Related
 
-- [Fee abstraction](/build-on-celo/fee-abstraction/overview) - How gas in stablecoins works and the adapter addresses for USDC and USDT
-- [Fee currency contracts](/tooling/contracts/fee-currencies) - Token and adapter addresses per network
-- [Build with local stablecoins](/build-on-celo/build-with-local-stablecoin) - Mento stablecoins beyond USDm
-- [SocialConnect](/build-on-celo/build-on-socialconnect) - Phone-number to address mapping
-- [Celo Composer](/build-on-celo/quickstart) - Scaffold a MiniPay-ready app
+- [Fee abstraction](/build/fee-abstraction/overview) - How gas in stablecoins works and the adapter addresses for USDC and USDT
+- [Fee currency contracts](/build/tools/contracts/fee-currencies) - Token and adapter addresses per network
+- [Build with local stablecoins](/build/build-with-local-stablecoin) - Mento stablecoins beyond USDm
+- [SocialConnect](/build/build-on-socialconnect) - Phone-number to address mapping
+- [Celo Composer](/build/quickstart) - Scaffold a MiniPay-ready app
diff --git a/build-on-celo/nightfall.mdx b/build/nightfall.mdx
similarity index 100%
rename from build-on-celo/nightfall.mdx
rename to build/nightfall.mdx
diff --git a/build-on-celo/quickstart.mdx b/build/quickstart.mdx
similarity index 89%
rename from build-on-celo/quickstart.mdx
rename to build/quickstart.mdx
index 8234e163a0..514f83610d 100644
--- a/build-on-celo/quickstart.mdx
+++ b/build/quickstart.mdx
@@ -57,7 +57,7 @@ npx @celo/celo-composer@latest create --template farcaster-miniapp
 
 ### MiniPay app
 
-Mobile-first, for apps that run inside the MiniPay wallet. See [MiniPay](/build-on-celo/build-on-minipay/overview) for what MiniPay expects from a Mini App.
+Mobile-first, for apps that run inside the MiniPay wallet. See [MiniPay](/build/mini-apps/overview) for what MiniPay expects from a Mini App.
 
 ```bash
 npx @celo/celo-composer@latest create --template minipay
@@ -73,7 +73,7 @@ npx @celo/celo-composer@latest create --template ai-chat
 
 ### x402 paid API
 
-Keeps the basic web app and adds an `apps/api` workspace with an [x402](/build-on-celo/build-with-ai/x402)-paid endpoint and a buyer script that pays it in USDC.
+Keeps the basic web app and adds an `apps/api` workspace with an [x402](/build/agents/x402)-paid endpoint and a buyer script that pays it in USDC.
 
 ```bash
 npx @celo/celo-composer@latest create --template x402
@@ -139,7 +139,7 @@ If you selected Hardhat or Foundry, the root `package.json` also exposes the con
 cp my-celo-app/apps/web/.env.template my-celo-app/apps/web/.env
 ```
 
-With the default RainbowKit provider, set `NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID` to a project ID from [Reown](/tooling/libraries-sdks/reown) (formerly WalletConnect). Without it the config falls back to the placeholder string `YOUR_PROJECT_ID`, and any connection that goes through WalletConnect — mobile wallets and the QR flow — fails. A browser-extension wallet connects over its own injected provider and is unaffected.
+With the default RainbowKit provider, set `NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID` to a project ID from [Reown](/build/tools/libraries-sdks/reown) (formerly WalletConnect). Without it the config falls back to the placeholder string `YOUR_PROJECT_ID`, and any connection that goes through WalletConnect — mobile wallets and the QR flow — fails. A browser-extension wallet connects over its own injected provider and is unaffected.
 
 If you chose the thirdweb provider, set `NEXT_PUBLIC_THIRDWEB_CLIENT_ID` instead.
 
@@ -204,6 +204,6 @@ If the error names a file you have not edited, it comes from the template rather
 ## Related
 
 - [Network overview](/learn/network/overview) — chain IDs, RPC URLs and the faucet you need for Celo mainnet and Celo Sepolia
-- [MiniPay](/build-on-celo/build-on-minipay/overview) — what to change when the target is the MiniPay wallet
-- [Hardhat](/tooling/dev-environments/hardhat) — configure the generated contracts workspace for Celo
-- [Farcaster](/build-on-celo/build-with-farcaster) — build and publish a miniapp from the Farcaster template
+- [MiniPay](/build/mini-apps/overview) — what to change when the target is the MiniPay wallet
+- [Hardhat](/build/tools/dev-environments/hardhat) — configure the generated contracts workspace for Celo
+- [Farcaster](/build/build-with-farcaster) — build and publish a miniapp from the Farcaster template
diff --git a/build-on-celo/scaling-your-app.mdx b/build/scaling-your-app.mdx
similarity index 95%
rename from build-on-celo/scaling-your-app.mdx
rename to build/scaling-your-app.mdx
index 196ee3fda1..5190e7e9cc 100644
--- a/build-on-celo/scaling-your-app.mdx
+++ b/build/scaling-your-app.mdx
@@ -152,12 +152,12 @@ Cache API responses wherever it makes sense:
 If you need an indexer, choose cost-effective options:
 
 - The Graph (decentralized indexing)
-- [Envio](/tooling/indexers/envio) (self-host HyperIndex or deploy to Envio Cloud)
+- [Envio](/build/tools/indexers/envio) (self-host HyperIndex or deploy to Envio Cloud)
 - Alchemy (if you already use their RPC)
 - thirdweb Insight
 - A custom indexer, if none of the hosted options fit
 
-See [Indexers](/tooling/indexers/overview) for the providers documented on Celo.
+See [Indexers](/build/tools/indexers/overview) for the providers documented on Celo.
 
 <Info>
   Indexers can significantly reduce RPC calls by providing pre-indexed
@@ -292,9 +292,9 @@ Use Grafana for analytics and logs:
 
 ## Additional Resources
 
-- [Celo Documentation](/build-on-celo) - Explore Celo development resources
-- [Launch Checklist](/build-on-celo/launch-checklist) - Pre-launch preparation guide
-- [Indexers](/tooling/indexers/overview) - Indexing providers documented on Celo
+- [Celo Documentation](/build) - Explore Celo development resources
+- [Launch Checklist](/build/launch-checklist) - Pre-launch preparation guide
+- [Indexers](/build/tools/indexers/overview) - Indexing providers documented on Celo
 - [Vercel AI SDK](https://sdk.vercel.ai/) - AI SDK for JavaScript/TypeScript
 - [Sentry Documentation](https://docs.sentry.io/) - Error monitoring and performance tracking
 - [Grafana Documentation](https://grafana.com/docs/) - Analytics and observability platform
diff --git a/tooling/bridges/bridges.mdx b/build/tools/bridges/bridges.mdx
similarity index 100%
rename from tooling/bridges/bridges.mdx
rename to build/tools/bridges/bridges.mdx
diff --git a/tooling/bridges/cross-chain-messaging.mdx b/build/tools/bridges/cross-chain-messaging.mdx
similarity index 100%
rename from tooling/bridges/cross-chain-messaging.mdx
rename to build/tools/bridges/cross-chain-messaging.mdx
diff --git a/tooling/contract-verification/blockscout.mdx b/build/tools/contract-verification/blockscout.mdx
similarity index 100%
rename from tooling/contract-verification/blockscout.mdx
rename to build/tools/contract-verification/blockscout.mdx
diff --git a/tooling/contract-verification/celoscan.mdx b/build/tools/contract-verification/celoscan.mdx
similarity index 100%
rename from tooling/contract-verification/celoscan.mdx
rename to build/tools/contract-verification/celoscan.mdx
diff --git a/tooling/contract-verification/hardhat.mdx b/build/tools/contract-verification/hardhat.mdx
similarity index 100%
rename from tooling/contract-verification/hardhat.mdx
rename to build/tools/contract-verification/hardhat.mdx
diff --git a/tooling/contract-verification/index.mdx b/build/tools/contract-verification/index.mdx
similarity index 69%
rename from tooling/contract-verification/index.mdx
rename to build/tools/contract-verification/index.mdx
index 4ade407b02..39adac722f 100644
--- a/tooling/contract-verification/index.mdx
+++ b/build/tools/contract-verification/index.mdx
@@ -9,14 +9,14 @@ Verifying publishes your contract's source so anyone can read it on the block ex
 ## Verify contracts on Celo
 
 - [Using Foundry](#using-foundry)
-- [Using Hardhat](/tooling/contract-verification/hardhat)
-- [Using Blockscout](/tooling/contract-verification/blockscout)
-- [Using Remix](/tooling/contract-verification/remix)
-- [Using Celoscan](/tooling/contract-verification/celoscan)
+- [Using Hardhat](/build/tools/contract-verification/hardhat)
+- [Using Blockscout](/build/tools/contract-verification/blockscout)
+- [Using Remix](/build/tools/contract-verification/remix)
+- [Using Celoscan](/build/tools/contract-verification/celoscan)
 
 ## Using Foundry
 
-If you deployed with [Foundry](/tooling/dev-environments/foundry), verify with `forge verify-contract`. Set your API key first — get one at [etherscan.io/register](https://etherscan.io/register):
+If you deployed with [Foundry](/build/tools/dev-environments/foundry), verify with `forge verify-contract`. Set your API key first — get one at [etherscan.io/register](https://etherscan.io/register):
 
 ```bash
 export ETHERSCAN_API_KEY=<your etherscan API key>
diff --git a/tooling/contract-verification/remix.mdx b/build/tools/contract-verification/remix.mdx
similarity index 100%
rename from tooling/contract-verification/remix.mdx
rename to build/tools/contract-verification/remix.mdx
diff --git a/tooling/contracts/core-contracts.mdx b/build/tools/contracts/core-contracts.mdx
similarity index 100%
rename from tooling/contracts/core-contracts.mdx
rename to build/tools/contracts/core-contracts.mdx
diff --git a/tooling/contracts/fee-currencies.mdx b/build/tools/contracts/fee-currencies.mdx
similarity index 96%
rename from tooling/contracts/fee-currencies.mdx
rename to build/tools/contracts/fee-currencies.mdx
index 5b5e2e4dcb..b082014f69 100644
--- a/tooling/contracts/fee-currencies.mdx
+++ b/build/tools/contracts/fee-currencies.mdx
@@ -7,13 +7,13 @@ description: Tokens allowlisted to pay gas fees on Celo Mainnet and the Celo Sep
 [comment]: <> (DO NOT EDIT THIS FILE MANUALLY)
 [comment]: <> (Autogenerated by `scripts/update_contracts.py`)
 
-This page is the contract reference for fee currencies: the tokens currently on the governable on-chain allowlist, read from the `FeeCurrencyDirectory` core contract, with their `feeCurrency` and token addresses. To pay gas in one of them, see the [fee abstraction guide](/build-on-celo/fee-abstraction/overview). For how the protocol handles fee currencies, see the [fee abstraction specification](/operate/specification/fee-abstraction).
+This page is the contract reference for fee currencies: the tokens currently on the governable on-chain allowlist, read from the `FeeCurrencyDirectory` core contract, with their `feeCurrency` and token addresses. To pay gas in one of them, see the [fee abstraction guide](/build/fee-abstraction/overview). For how the protocol handles fee currencies, see the [fee abstraction specification](/operate/specification/fee-abstraction).
 
 <Note>
-This is not a list of every token on Celo. For stablecoin addresses, see [Stablecoin Contracts](/tooling/contracts/stablecoin-contracts). For an overview of Celo's stablecoin ecosystem, see [Build with Local Stablecoins](/build-on-celo/build-with-local-stablecoin).
+This is not a list of every token on Celo. For stablecoin addresses, see [Stablecoin Contracts](/build/tools/contracts/stablecoin-contracts). For an overview of Celo's stablecoin ecosystem, see [Build with Local Stablecoins](/build/build-with-local-stablecoin).
 </Note>
 
-Pass the **feeCurrency address** as the `feeCurrency` field on a transaction, and use the **token address** when transferring the token itself. The two differ for tokens that do not use 18 decimals — such as USDC, USD₮ and USA₮ — which are allowlisted through an adapter. See [Adapters for Non-18-Decimal Tokens](/build-on-celo/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens).
+Pass the **feeCurrency address** as the `feeCurrency` field on a transaction, and use the **token address** when transferring the token itself. The two differ for tokens that do not use 18 decimals — such as USDC, USD₮ and USA₮ — which are allowlisted through an adapter. See [Adapters for Non-18-Decimal Tokens](/build/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens).
 
 ---
 
diff --git a/tooling/contracts/l1-contracts.mdx b/build/tools/contracts/l1-contracts.mdx
similarity index 100%
rename from tooling/contracts/l1-contracts.mdx
rename to build/tools/contracts/l1-contracts.mdx
diff --git a/tooling/contracts/stablecoin-contracts.mdx b/build/tools/contracts/stablecoin-contracts.mdx
similarity index 97%
rename from tooling/contracts/stablecoin-contracts.mdx
rename to build/tools/contracts/stablecoin-contracts.mdx
index 74d0b24fb7..bc16926ac8 100644
--- a/tooling/contracts/stablecoin-contracts.mdx
+++ b/build/tools/contracts/stablecoin-contracts.mdx
@@ -7,7 +7,7 @@ description: Contract addresses for stablecoins on Celo Mainnet and the Celo Sep
 [comment]: <> (DO NOT EDIT THIS FILE MANUALLY)
 [comment]: <> (Autogenerated by `scripts/update_contracts.py`)
 
-Contract addresses for stablecoins on Celo Mainnet and the Celo Sepolia Testnet. For an overview of the ecosystem these assets belong to, see [Build with Local Stablecoins](/build-on-celo/build-with-local-stablecoin). To find out which of them can also pay gas fees, see [Fee Currencies](/tooling/contracts/fee-currencies).
+Contract addresses for stablecoins on Celo Mainnet and the Celo Sepolia Testnet. For an overview of the ecosystem these assets belong to, see [Build with Local Stablecoins](/build/build-with-local-stablecoin). To find out which of them can also pay gas fees, see [Fee Currencies](/build/tools/contracts/fee-currencies).
 
 <Note>
 These addresses are listed for convenience and do not imply any endorsement of the issuer or the asset. Verify an address against a block explorer before using it in production.
diff --git a/tooling/contracts/uniswap-contracts.mdx b/build/tools/contracts/uniswap-contracts.mdx
similarity index 100%
rename from tooling/contracts/uniswap-contracts.mdx
rename to build/tools/contracts/uniswap-contracts.mdx
diff --git a/tooling/dev-environments/foundry.mdx b/build/tools/dev-environments/foundry.mdx
similarity index 98%
rename from tooling/dev-environments/foundry.mdx
rename to build/tools/dev-environments/foundry.mdx
index 839814e92e..d85df02f94 100644
--- a/tooling/dev-environments/foundry.mdx
+++ b/build/tools/dev-environments/foundry.mdx
@@ -109,7 +109,7 @@ forge create --rpc-url celo-sepolia --private-key <your_private_key> src/Counter
 <Note>
 Notice the contract name after `:`, this is because a single solidity file can have multiple contracts.
 
-It is recommended to use `--verify` flag so that the contract gets verified right after deployment, see [verifying with Foundry](/tooling/contract-verification/index#using-foundry).
+It is recommended to use `--verify` flag so that the contract gets verified right after deployment, see [verifying with Foundry](/build/tools/contract-verification/index#using-foundry).
 </Note>
 
 On successful deployment, you should a following output!
diff --git a/tooling/dev-environments/hardhat.mdx b/build/tools/dev-environments/hardhat.mdx
similarity index 77%
rename from tooling/dev-environments/hardhat.mdx
rename to build/tools/dev-environments/hardhat.mdx
index 755dcd7318..7d95d4ac90 100644
--- a/tooling/dev-environments/hardhat.mdx
+++ b/build/tools/dev-environments/hardhat.mdx
@@ -16,9 +16,9 @@ How to deploy a smart contract to Celo testnet, Mainnet, or a local network usin
 
 Node.js and a package manager installed locally, plus an account funded from the [Celo Sepolia faucet](https://faucet.celo.org/celo-sepolia).
 
-The configuration below reads a mnemonic on Celo's derivation path, `m/44'/52752'/0'/0`. Generate one with [`celocli account:new`](/tooling/libraries-sdks/cli/account) — MetaMask cannot export or import along that path, so an existing MetaMask seed will not work here.
+The configuration below reads a mnemonic on Celo's derivation path, `m/44'/52752'/0'/0`. Generate one with [`celocli account:new`](/build/tools/libraries-sdks/cli/account) — MetaMask cannot export or import along that path, so an existing MetaMask seed will not work here.
 
-To deploy without a local environment, use [Remix](/tooling/dev-environments/remix) instead.
+To deploy without a local environment, use [Remix](/build/tools/dev-environments/remix) instead.
 
 ## Create Hardhat Project
 
@@ -32,7 +32,7 @@ Open [hardhat.config.js](https://hardhat.org/config/) in a text editor and repla
 
 ### Connect to Testnet using Forno
 
-Using [Forno](/tooling/nodes/forno) allows you to connect to the Celo test blockchain without running a local node. The testnet configuration uses Forno to connect you to the Celo Sepolia Testnet using HDWalletProvider and the mnemonic stored in your **.env** file.
+Using [Forno](/build/tools/nodes/forno) allows you to connect to the Celo test blockchain without running a local node. The testnet configuration uses Forno to connect you to the Celo Sepolia Testnet using HDWalletProvider and the mnemonic stored in your **.env** file.
 
 ```js
    celoSepolia: {
@@ -51,7 +51,7 @@ Celo uses a different account derivation path than Ethereum, so you have to spec
 
 ### Connect to Mainnet using Forno
 
-Using [Forno](/tooling/nodes/forno) also allows you to connect to the Celo main blockchain without running a local node. The Mainnet configuration uses Forno to connect you to the Celo Mainnet using HDWalletProvider and the mnemonic stored in your **.env** file.
+Using [Forno](/build/tools/nodes/forno) also allows you to connect to the Celo main blockchain without running a local node. The Mainnet configuration uses Forno to connect you to the Celo Mainnet using HDWalletProvider and the mnemonic stored in your **.env** file.
 
 ```js
    celo: {
@@ -65,7 +65,7 @@ Using [Forno](/tooling/nodes/forno) also allows you to connect to the Celo main
 ```
 
 <Tip>
-[Forno](/tooling/nodes/forno) is a cLabs hosted node service for interacting with the Celo network. This allows you to connect to the Celo Blockchain without having to run your own node.
+[Forno](/build/tools/nodes/forno) is a cLabs hosted node service for interacting with the Celo network. This allows you to connect to the Celo Blockchain without having to run your own node.
 </Tip>
 
 ## Deploy to Celo
diff --git a/tooling/dev-environments/index.mdx b/build/tools/dev-environments/index.mdx
similarity index 66%
rename from tooling/dev-environments/index.mdx
rename to build/tools/dev-environments/index.mdx
index c578096733..4e07d88fd6 100644
--- a/tooling/dev-environments/index.mdx
+++ b/build/tools/dev-environments/index.mdx
@@ -19,14 +19,14 @@ npx @celo/celo-composer@latest create
 ```
 
 <Tip>
-See the [Quickstart](/build-on-celo/quickstart) for the templates, the flags and how to check a scaffolded app runs, or read the [README](https://github.com/celo-org/celo-composer).
+See the [Quickstart](/build/quickstart) for the templates, the flags and how to check a scaffolded app runs, or read the [README](https://github.com/celo-org/celo-composer).
 </Tip>
 
 ## Using EVM Tools
 
 Developers can build with Celo using many [Ethereum](https://ethereum.org/en/) compatible tools including Remix, Hardhat, and others. By making a few adjustments to your project’s network configuration settings, you can deploy your new or existing app on Celo.
 
-- [Using Foundry](/tooling/dev-environments/foundry)
-- [Using Hardhat](/tooling/dev-environments/hardhat)
-- [Using Remix](/tooling/dev-environments/remix)
-- [Using thirdweb](/tooling/dev-environments/thirdweb)
\ No newline at end of file
+- [Using Foundry](/build/tools/dev-environments/foundry)
+- [Using Hardhat](/build/tools/dev-environments/hardhat)
+- [Using Remix](/build/tools/dev-environments/remix)
+- [Using thirdweb](/build/tools/dev-environments/thirdweb)
\ No newline at end of file
diff --git a/tooling/dev-environments/multibaas/contracts.mdx b/build/tools/dev-environments/multibaas/contracts.mdx
similarity index 100%
rename from tooling/dev-environments/multibaas/contracts.mdx
rename to build/tools/dev-environments/multibaas/contracts.mdx
diff --git a/tooling/dev-environments/multibaas/overview.mdx b/build/tools/dev-environments/multibaas/overview.mdx
similarity index 100%
rename from tooling/dev-environments/multibaas/overview.mdx
rename to build/tools/dev-environments/multibaas/overview.mdx
diff --git a/tooling/dev-environments/multibaas/webhooks.mdx b/build/tools/dev-environments/multibaas/webhooks.mdx
similarity index 100%
rename from tooling/dev-environments/multibaas/webhooks.mdx
rename to build/tools/dev-environments/multibaas/webhooks.mdx
diff --git a/tooling/dev-environments/remix.mdx b/build/tools/dev-environments/remix.mdx
similarity index 97%
rename from tooling/dev-environments/remix.mdx
rename to build/tools/dev-environments/remix.mdx
index 26312c0888..be4a992131 100644
--- a/tooling/dev-environments/remix.mdx
+++ b/build/tools/dev-environments/remix.mdx
@@ -60,7 +60,7 @@ To learn more about the features available to you as a smart contract developer
 
 - Click the **Deploy and Run Transactions Icon** on the left side menu.
 - Choose **Injected Web3** as your environment.
-- [Connect MetaMask to Celo](/tooling/wallets/metamask/use) testnet and verify that the environment reads:
+- [Connect MetaMask to Celo](/build/tools/wallets/metamask/use) testnet and verify that the environment reads:
   - **Custom (11142220) network** for Celo Sepolia testnet
   - **Custom (42220) network** for Celo Mainnet
 - Click **Deploy** and select **Confirm** in the MetaMask notification window to pay for the transaction
diff --git a/tooling/dev-environments/thirdweb.mdx b/build/tools/dev-environments/thirdweb.mdx
similarity index 71%
rename from tooling/dev-environments/thirdweb.mdx
rename to build/tools/dev-environments/thirdweb.mdx
index e94e768a34..45fbcbd729 100644
--- a/tooling/dev-environments/thirdweb.mdx
+++ b/build/tools/dev-environments/thirdweb.mdx
@@ -26,7 +26,7 @@ When deploying from the thirdweb dashboard, select **Celo** or **Celo Sepolia**
 
 ## Fee abstraction
 
-Paying gas in a stablecoin instead of CELO uses Celo's `feeCurrency` transaction field, which not every EVM library sets. [viem](/tooling/libraries-sdks/viem) and [wagmi](https://wagmi.sh) support it natively — see [Fee abstraction](/build-on-celo/fee-abstraction/overview) for what the field expects, including the adapter-address rule for 6-decimal tokens.
+Paying gas in a stablecoin instead of CELO uses Celo's `feeCurrency` transaction field, which not every EVM library sets. [viem](/build/tools/libraries-sdks/viem) and [wagmi](https://wagmi.sh) support it natively — see [Fee abstraction](/build/fee-abstraction/overview) for what the field expects, including the adapter-address rule for 6-decimal tokens.
 
 ## Resources
 
@@ -39,7 +39,7 @@ Paying gas in a stablecoin instead of CELO uses Celo's `feeCurrency` transaction
 
 ## Related
 
-- [Using Foundry](/tooling/dev-environments/foundry) - deploy and test contracts from the command line
-- [Using Hardhat](/tooling/dev-environments/hardhat) - deploy and test contracts with the Hardhat toolchain
-- [Using Remix](/tooling/dev-environments/remix) - deploy from the browser without local setup
-- [Celo SDKs](/tooling/libraries-sdks/celo-sdks) - the libraries available for reading and writing Celo state
+- [Using Foundry](/build/tools/dev-environments/foundry) - deploy and test contracts from the command line
+- [Using Hardhat](/build/tools/dev-environments/hardhat) - deploy and test contracts with the Hardhat toolchain
+- [Using Remix](/build/tools/dev-environments/remix) - deploy from the browser without local setup
+- [Celo SDKs](/build/tools/libraries-sdks/celo-sdks) - the libraries available for reading and writing Celo state
diff --git a/tooling/explorers/analytics.mdx b/build/tools/explorers/analytics.mdx
similarity index 100%
rename from tooling/explorers/analytics.mdx
rename to build/tools/explorers/analytics.mdx
diff --git a/tooling/explorers/block-explorers.mdx b/build/tools/explorers/block-explorers.mdx
similarity index 100%
rename from tooling/explorers/block-explorers.mdx
rename to build/tools/explorers/block-explorers.mdx
diff --git a/tooling/explorers/overview.mdx b/build/tools/explorers/overview.mdx
similarity index 100%
rename from tooling/explorers/overview.mdx
rename to build/tools/explorers/overview.mdx
diff --git a/tooling/indexers/codex.mdx b/build/tools/indexers/codex.mdx
similarity index 100%
rename from tooling/indexers/codex.mdx
rename to build/tools/indexers/codex.mdx
diff --git a/tooling/indexers/envio.mdx b/build/tools/indexers/envio.mdx
similarity index 98%
rename from tooling/indexers/envio.mdx
rename to build/tools/indexers/envio.mdx
index 0ab35fd956..47bece038b 100644
--- a/tooling/indexers/envio.mdx
+++ b/build/tools/indexers/envio.mdx
@@ -75,5 +75,5 @@ This opens the local Hasura console, where you can query the indexed data with G
 
 ## Related
 
-- [Data indexers overview](/tooling/indexers/overview) - other indexing options on Celo
+- [Data indexers overview](/build/tools/indexers/overview) - other indexing options on Celo
 - [Network overview](/learn/network/overview) - Celo chain IDs and RPC URLs
diff --git a/tooling/indexers/goldrush.mdx b/build/tools/indexers/goldrush.mdx
similarity index 100%
rename from tooling/indexers/goldrush.mdx
rename to build/tools/indexers/goldrush.mdx
diff --git a/tooling/indexers/indexing-co.mdx b/build/tools/indexers/indexing-co.mdx
similarity index 100%
rename from tooling/indexers/indexing-co.mdx
rename to build/tools/indexers/indexing-co.mdx
diff --git a/tooling/indexers/overview.mdx b/build/tools/indexers/overview.mdx
similarity index 98%
rename from tooling/indexers/overview.mdx
rename to build/tools/indexers/overview.mdx
index 2a964ac4ee..d6fafa2fb2 100644
--- a/tooling/indexers/overview.mdx
+++ b/build/tools/indexers/overview.mdx
@@ -17,7 +17,7 @@ Getting historical data on a smart contract can be frustrating when you’re bui
     - The Subgraph Explorer allows you to search and explore subgraphs that have been deployed to The Graph's decentralized network. You can use it to find subgraphs relevant to your app and see how they are structured.
 - [Envio](https://envio.dev/)
   - Envio HyperIndex indexes Celo contract events into a GraphQL API, using HyperSync as its data source on Celo mainnet. Run it locally, self-host it, or deploy to Envio Cloud.
-  - [Indexing Celo data with Envio](/tooling/indexers/envio)
+  - [Indexing Celo data with Envio](/build/tools/indexers/envio)
     - Create an indexer from a deployed Celo contract, run it locally, and query the result.
 - [SubQuery](https://subquery.network/)
   - SubQuery is a fast, flexible, and reliable data indexing solution for blockchain developers. It allows you to index and query blockchain data with ease, providing a powerful tool for building decentralized applications.
diff --git a/tooling/indexers/subquery.mdx b/build/tools/indexers/subquery.mdx
similarity index 100%
rename from tooling/indexers/subquery.mdx
rename to build/tools/indexers/subquery.mdx
diff --git a/tooling/indexers/the-graph.mdx b/build/tools/indexers/the-graph.mdx
similarity index 100%
rename from tooling/indexers/the-graph.mdx
rename to build/tools/indexers/the-graph.mdx
diff --git a/build/tools/libraries-sdks/celo-sdks.mdx b/build/tools/libraries-sdks/celo-sdks.mdx
new file mode 100644
index 0000000000..bd38c936aa
--- /dev/null
+++ b/build/tools/libraries-sdks/celo-sdks.mdx
@@ -0,0 +1,24 @@
+---
+title: Celo Libraries & SDKs
+description: List of Celo libraries & SDKs
+sidebarTitle: "Overview"
+---
+
+
+Because Celo is compatible with Ethereum any ethereum package can be used with Celo. Packages with specific support for Celo include:
+
+---
+
+## Web3 Libraries
+
+- [viem](/build/tools/libraries-sdks/viem)
+- [ethers](/build/tools/libraries-sdks/ethers)
+- [thirdweb](/build/tools/dev-environments/thirdweb)
+- [ContractKit (deprecated - only for internal use)](/build/tools/libraries-sdks/contractkit)
+- [web3.js (deprecated)](/build/tools/libraries-sdks/web3)
+
+## Wallet Libraries
+
+- [Reown](/build/tools/libraries-sdks/reown)
+- [Portal](/build/tools/libraries-sdks/portal)
+- [JAW](/build/tools/libraries-sdks/jaw)
diff --git a/tooling/libraries-sdks/cli/README.txt b/build/tools/libraries-sdks/cli/README.txt
similarity index 100%
rename from tooling/libraries-sdks/cli/README.txt
rename to build/tools/libraries-sdks/cli/README.txt
diff --git a/tooling/libraries-sdks/cli/account.mdx b/build/tools/libraries-sdks/cli/account.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/account.mdx
rename to build/tools/libraries-sdks/cli/account.mdx
diff --git a/tooling/libraries-sdks/cli/autocomplete.mdx b/build/tools/libraries-sdks/cli/autocomplete.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/autocomplete.mdx
rename to build/tools/libraries-sdks/cli/autocomplete.mdx
diff --git a/tooling/libraries-sdks/cli/commands.mdx b/build/tools/libraries-sdks/cli/commands.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/commands.mdx
rename to build/tools/libraries-sdks/cli/commands.mdx
diff --git a/tooling/libraries-sdks/cli/config.mdx b/build/tools/libraries-sdks/cli/config.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/config.mdx
rename to build/tools/libraries-sdks/cli/config.mdx
diff --git a/tooling/libraries-sdks/cli/election.mdx b/build/tools/libraries-sdks/cli/election.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/election.mdx
rename to build/tools/libraries-sdks/cli/election.mdx
diff --git a/tooling/libraries-sdks/cli/epochs.mdx b/build/tools/libraries-sdks/cli/epochs.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/epochs.mdx
rename to build/tools/libraries-sdks/cli/epochs.mdx
diff --git a/tooling/libraries-sdks/cli/governance.mdx b/build/tools/libraries-sdks/cli/governance.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/governance.mdx
rename to build/tools/libraries-sdks/cli/governance.mdx
diff --git a/tooling/libraries-sdks/cli/help.mdx b/build/tools/libraries-sdks/cli/help.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/help.mdx
rename to build/tools/libraries-sdks/cli/help.mdx
diff --git a/tooling/libraries-sdks/cli/identity.mdx b/build/tools/libraries-sdks/cli/identity.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/identity.mdx
rename to build/tools/libraries-sdks/cli/identity.mdx
diff --git a/tooling/libraries-sdks/cli/index.mdx b/build/tools/libraries-sdks/cli/index.mdx
similarity index 92%
rename from tooling/libraries-sdks/cli/index.mdx
rename to build/tools/libraries-sdks/cli/index.mdx
index 603e379270..d58cb9eea9 100644
--- a/tooling/libraries-sdks/cli/index.mdx
+++ b/build/tools/libraries-sdks/cli/index.mdx
@@ -66,8 +66,8 @@ Commands need to connect to a Celo node to execute most functionality.
 You have several options for node connectivity:
 
 - [Running your own full node](/operate/operators/run-node)
-- [Third-party node providers](/tooling/nodes/overview)
-- [Forno](/tooling/nodes/forno) (the easiest way)
+- [Third-party node providers](/build/tools/nodes/overview)
+- [Forno](/build/tools/nodes/forno) (the easiest way)
 
 To connect `celocli` to any node, use the following command:
 
@@ -103,7 +103,7 @@ Or you can use a Ledger hardware wallet (preferred, see below).
 
 ### Using a Ledger Wallet
 
-The Celo CLI supports using a [Ledger hardware wallet](/tooling/wallets/ledger/setup) to sign transactions. Just add the `--useLedger` flag to a command that requires a signature.
+The Celo CLI supports using a [Ledger hardware wallet](/build/tools/wallets/ledger/setup) to sign transactions. Just add the `--useLedger` flag to a command that requires a signature.
 
 You can specify the number of addresses to get for local signing with the `--ledgerAddresses` flag.
 
diff --git a/tooling/libraries-sdks/cli/lockedcelo.mdx b/build/tools/libraries-sdks/cli/lockedcelo.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/lockedcelo.mdx
rename to build/tools/libraries-sdks/cli/lockedcelo.mdx
diff --git a/tooling/libraries-sdks/cli/multisig.mdx b/build/tools/libraries-sdks/cli/multisig.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/multisig.mdx
rename to build/tools/libraries-sdks/cli/multisig.mdx
diff --git a/tooling/libraries-sdks/cli/network.mdx b/build/tools/libraries-sdks/cli/network.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/network.mdx
rename to build/tools/libraries-sdks/cli/network.mdx
diff --git a/tooling/libraries-sdks/cli/node.mdx b/build/tools/libraries-sdks/cli/node.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/node.mdx
rename to build/tools/libraries-sdks/cli/node.mdx
diff --git a/tooling/libraries-sdks/cli/oracle.mdx b/build/tools/libraries-sdks/cli/oracle.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/oracle.mdx
rename to build/tools/libraries-sdks/cli/oracle.mdx
diff --git a/tooling/libraries-sdks/cli/plugins.mdx b/build/tools/libraries-sdks/cli/plugins.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/plugins.mdx
rename to build/tools/libraries-sdks/cli/plugins.mdx
diff --git a/tooling/libraries-sdks/cli/releasecelo.mdx b/build/tools/libraries-sdks/cli/releasecelo.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/releasecelo.mdx
rename to build/tools/libraries-sdks/cli/releasecelo.mdx
diff --git a/tooling/libraries-sdks/cli/rewards.mdx b/build/tools/libraries-sdks/cli/rewards.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/rewards.mdx
rename to build/tools/libraries-sdks/cli/rewards.mdx
diff --git a/tooling/libraries-sdks/cli/transfer.mdx b/build/tools/libraries-sdks/cli/transfer.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/transfer.mdx
rename to build/tools/libraries-sdks/cli/transfer.mdx
diff --git a/tooling/libraries-sdks/cli/validator.mdx b/build/tools/libraries-sdks/cli/validator.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/validator.mdx
rename to build/tools/libraries-sdks/cli/validator.mdx
diff --git a/tooling/libraries-sdks/cli/validatorgroup.mdx b/build/tools/libraries-sdks/cli/validatorgroup.mdx
similarity index 100%
rename from tooling/libraries-sdks/cli/validatorgroup.mdx
rename to build/tools/libraries-sdks/cli/validatorgroup.mdx
diff --git a/tooling/libraries-sdks/composer-kit.mdx b/build/tools/libraries-sdks/composer-kit.mdx
similarity index 96%
rename from tooling/libraries-sdks/composer-kit.mdx
rename to build/tools/libraries-sdks/composer-kit.mdx
index a6f55a5014..dc8055343c 100644
--- a/tooling/libraries-sdks/composer-kit.mdx
+++ b/build/tools/libraries-sdks/composer-kit.mdx
@@ -216,6 +216,6 @@ For comprehensive examples and detailed API documentation for each component:
 
 ## Next Steps
 
-- Get started with [Celopedia](/build-on-celo/build-with-ai/celopedia) to build on Celo with your AI coding assistant
-- Explore [building on MiniPay](/build-on-celo/build-on-minipay/overview) for mobile-first experiences
+- Get started with [Celopedia](/build/agents/celopedia) to build on Celo with your AI coding assistant
+- Explore [building on MiniPay](/build/mini-apps/overview) for mobile-first experiences
 - Learn about [DeFi integration](/build/build-with-defi) for financial applications
diff --git a/tooling/libraries-sdks/contractkit/contracts-wrappers-registry.mdx b/build/tools/libraries-sdks/contractkit/contracts-wrappers-registry.mdx
similarity index 100%
rename from tooling/libraries-sdks/contractkit/contracts-wrappers-registry.mdx
rename to build/tools/libraries-sdks/contractkit/contracts-wrappers-registry.mdx
diff --git a/tooling/libraries-sdks/contractkit/data-encryption-key.mdx b/build/tools/libraries-sdks/contractkit/data-encryption-key.mdx
similarity index 100%
rename from tooling/libraries-sdks/contractkit/data-encryption-key.mdx
rename to build/tools/libraries-sdks/contractkit/data-encryption-key.mdx
diff --git a/tooling/libraries-sdks/contractkit/index.mdx b/build/tools/libraries-sdks/contractkit/index.mdx
similarity index 100%
rename from tooling/libraries-sdks/contractkit/index.mdx
rename to build/tools/libraries-sdks/contractkit/index.mdx
diff --git a/tooling/libraries-sdks/contractkit/migrating-to-contractkit-v1.mdx b/build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v1.mdx
similarity index 97%
rename from tooling/libraries-sdks/contractkit/migrating-to-contractkit-v1.mdx
rename to build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v1.mdx
index cdd4522403..e133f61807 100644
--- a/tooling/libraries-sdks/contractkit/migrating-to-contractkit-v1.mdx
+++ b/build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v1.mdx
@@ -42,7 +42,7 @@ ContractKit is a suite of packages.
 
 - `Explorer` depends on `contractkit` and `connect`. It provides some utility functions that make it easy to listen for new block and log information.
 - `Governance` depends on `contractkit` and `explorer`. It provides functions to read and interact with Celo Governance Proposals (CGPs).
-- `Identity` simplifies interacting with [ODIS](/build-on-celo/build-on-socialconnect), Celo’s lightweight identity layer based on phone numbers.
+- `Identity` simplifies interacting with [ODIS](/build/build-on-socialconnect), Celo’s lightweight identity layer based on phone numbers.
 - `Network-utils` provides utilities for getting genesis block and static node information.
 - `Transactions-uri` makes it easy to generate Celo transaction URIs and QR codes.
 
diff --git a/tooling/libraries-sdks/contractkit/migrating-to-contractkit-v2.mdx b/build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v2.mdx
similarity index 99%
rename from tooling/libraries-sdks/contractkit/migrating-to-contractkit-v2.mdx
rename to build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v2.mdx
index b366dcf4ec..b265d30bee 100644
--- a/tooling/libraries-sdks/contractkit/migrating-to-contractkit-v2.mdx
+++ b/build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v2.mdx
@@ -112,7 +112,7 @@ accountsInstance.authorizeValidatorSigner(signer, sig, validatorsInstance);
 
 `AttestationsWrapper.getConfig()` and`AttestationsWrapper.getHumanReadableConfig()`
 
-These functions now require an array of fee payable token addresses. You can get these from the CeloTokens class, the Registry, or the [Fee Currencies](/tooling/contracts/fee-currencies) list.
+These functions now require an array of fee payable token addresses. You can get these from the CeloTokens class, the Registry, or the [Fee Currencies](/build/tools/contracts/fee-currencies) list.
 
 ```typescript
 const celoTokens = kit.celoTokens;
diff --git a/tooling/libraries-sdks/contractkit/migrating-to-viem.mdx b/build/tools/libraries-sdks/contractkit/migrating-to-viem.mdx
similarity index 100%
rename from tooling/libraries-sdks/contractkit/migrating-to-viem.mdx
rename to build/tools/libraries-sdks/contractkit/migrating-to-viem.mdx
diff --git a/tooling/libraries-sdks/contractkit/notes-web3-with-contractkit.mdx b/build/tools/libraries-sdks/contractkit/notes-web3-with-contractkit.mdx
similarity index 98%
rename from tooling/libraries-sdks/contractkit/notes-web3-with-contractkit.mdx
rename to build/tools/libraries-sdks/contractkit/notes-web3-with-contractkit.mdx
index 492dfca15c..97fda62917 100644
--- a/tooling/libraries-sdks/contractkit/notes-web3-with-contractkit.mdx
+++ b/build/tools/libraries-sdks/contractkit/notes-web3-with-contractkit.mdx
@@ -12,7 +12,7 @@ How to use Web3 from ContractKit to read data from the Celo blockchain.
 As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
 Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).
 
-For the most up-to-date information, refer to our [Celo L2 documentation](/build-on-celo/index).
+For the most up-to-date information, refer to our [Celo L2 documentation](/build/index).
 </Warning>
 
 The ContractKit, for every interaction with the node, uses internally a Web3 instance.
diff --git a/tooling/libraries-sdks/contractkit/odis.mdx b/build/tools/libraries-sdks/contractkit/odis.mdx
similarity index 98%
rename from tooling/libraries-sdks/contractkit/odis.mdx
rename to build/tools/libraries-sdks/contractkit/odis.mdx
index fb8d862817..dec573e6a4 100644
--- a/tooling/libraries-sdks/contractkit/odis.mdx
+++ b/build/tools/libraries-sdks/contractkit/odis.mdx
@@ -22,7 +22,7 @@ ODIS requests are rate-limited based on transaction history and balance. Ensure
 The main ODIS method is `getObfuscatedIdentifier`, which queries and computes the on-chain identifier for an off-chain identifier such as a phone number.
 
 <Tip>
-See [this overview document](/build-on-celo/build-on-socialconnect) for more details on ODIS.
+See [this overview document](/build/build-on-socialconnect) for more details on ODIS.
 </Tip>
 
 ## Authentication
diff --git a/tooling/libraries-sdks/contractkit/setup.mdx b/build/tools/libraries-sdks/contractkit/setup.mdx
similarity index 94%
rename from tooling/libraries-sdks/contractkit/setup.mdx
rename to build/tools/libraries-sdks/contractkit/setup.mdx
index c995c5038e..5d5262030e 100644
--- a/tooling/libraries-sdks/contractkit/setup.mdx
+++ b/build/tools/libraries-sdks/contractkit/setup.mdx
@@ -58,7 +58,7 @@ const web3 = new Web3("https://forno.celo-sepolia.celo-testnet.org/");
 const kit = newKitFromWeb3(web3);
 ```
 
-Go to the [page about Forno](/tooling/nodes/forno) for details about different connection types and network endpoints.
+Go to the [page about Forno](/build/tools/nodes/forno) for details about different connection types and network endpoints.
 
 ## Initialize the Kit with your own node
 
diff --git a/tooling/libraries-sdks/contractkit/usage.mdx b/build/tools/libraries-sdks/contractkit/usage.mdx
similarity index 100%
rename from tooling/libraries-sdks/contractkit/usage.mdx
rename to build/tools/libraries-sdks/contractkit/usage.mdx
diff --git a/tooling/libraries-sdks/dynamic/index.mdx b/build/tools/libraries-sdks/dynamic/index.mdx
similarity index 100%
rename from tooling/libraries-sdks/dynamic/index.mdx
rename to build/tools/libraries-sdks/dynamic/index.mdx
diff --git a/tooling/libraries-sdks/ethers/index.mdx b/build/tools/libraries-sdks/ethers/index.mdx
similarity index 92%
rename from tooling/libraries-sdks/ethers/index.mdx
rename to build/tools/libraries-sdks/ethers/index.mdx
index adf8ebc4bd..85129b355a 100644
--- a/tooling/libraries-sdks/ethers/index.mdx
+++ b/build/tools/libraries-sdks/ethers/index.mdx
@@ -4,9 +4,9 @@ description: A minimal wrapper to make Ethers.JS compatible with the Celo networ
 ---
 
 <Warning>
-When using Ethers.js on Celo, we suggest using the Celo Ethers.js Wrapper to make Ethers.JS compatible with the Celo network. This means being able to handle [fee abstraction](/build-on-celo/fee-abstraction/overview) when opened in MiniPay/ Valora. 
+When using Ethers.js on Celo, we suggest using the Celo Ethers.js Wrapper to make Ethers.JS compatible with the Celo network. This means being able to handle [fee abstraction](/build/fee-abstraction/overview) when opened in MiniPay/ Valora. 
 
-[Fee Abstraction](/build-on-celo/fee-abstraction/overview) on Celo enables the use of stablecoins like cUSD, USDT and USDC as gas tokens. 
+[Fee Abstraction](/build/fee-abstraction/overview) on Celo enables the use of stablecoins like cUSD, USDT and USDC as gas tokens. 
 </Warning>
 
 ## Celo Ethers.JS Wrapper
diff --git a/tooling/libraries-sdks/jaw/index.mdx b/build/tools/libraries-sdks/jaw/index.mdx
similarity index 100%
rename from tooling/libraries-sdks/jaw/index.mdx
rename to build/tools/libraries-sdks/jaw/index.mdx
diff --git a/tooling/libraries-sdks/portal/index.mdx b/build/tools/libraries-sdks/portal/index.mdx
similarity index 100%
rename from tooling/libraries-sdks/portal/index.mdx
rename to build/tools/libraries-sdks/portal/index.mdx
diff --git a/tooling/libraries-sdks/reown/index.mdx b/build/tools/libraries-sdks/reown/index.mdx
similarity index 100%
rename from tooling/libraries-sdks/reown/index.mdx
rename to build/tools/libraries-sdks/reown/index.mdx
diff --git a/tooling/libraries-sdks/viem/index.mdx b/build/tools/libraries-sdks/viem/index.mdx
similarity index 100%
rename from tooling/libraries-sdks/viem/index.mdx
rename to build/tools/libraries-sdks/viem/index.mdx
diff --git a/tooling/libraries-sdks/web3/index.mdx b/build/tools/libraries-sdks/web3/index.mdx
similarity index 73%
rename from tooling/libraries-sdks/web3/index.mdx
rename to build/tools/libraries-sdks/web3/index.mdx
index b15f6556c3..ebd29fa10b 100644
--- a/tooling/libraries-sdks/web3/index.mdx
+++ b/build/tools/libraries-sdks/web3/index.mdx
@@ -8,16 +8,16 @@ sidebarTitle: "Web3.js (deprecated)"
 
 
 <Note>
-Web3.js was sunset in 2024. Use [viem](/tooling/libraries-sdks/viem) instead.
+Web3.js was sunset in 2024. Use [viem](/build/tools/libraries-sdks/viem) instead.
 </Note>
 
-Web3.js was established in 2014, making it the oldest web3 library. With extensive documentation, an active community and modular design, Web3.js is powerful and easy-to-use. It has _support for Celo features (specifically **[Fee Abstraction](/build-on-celo/fee-abstraction/overview)** via plugins since version 4.13.1_.
+Web3.js was established in 2014, making it the oldest web3 library. With extensive documentation, an active community and modular design, Web3.js is powerful and easy-to-use. It has _support for Celo features (specifically **[Fee Abstraction](/build/fee-abstraction/overview)** via plugins since version 4.13.1_.
 
 To learn more about building with Web3.js, check out their [docs](https://docs.web3js.org/) as they have excellent examples of how to use it in your project.
 
 ### Fee Abstraction with Web3.js
 
-[Fee Abstraction](/build-on-celo/fee-abstraction/overview) on Celo enables the use of stablecoins like cUSD, USDT and USDC as gas tokens. 
+[Fee Abstraction](/build/fee-abstraction/overview) on Celo enables the use of stablecoins like cUSD, USDT and USDC as gas tokens. 
 
 #### Requirements
 
@@ -25,7 +25,7 @@ To learn more about building with Web3.js, check out their [docs](https://docs.w
 
 #### Install the Celo Web3.js Plugin
 
-For Celo' specific features like [Fee Abstraction](/build-on-celo/fee-abstraction/overview) transactions you need to install `@celo/web3-plugin-transaction-types` as well as `web3@4.13.1` or higher. This also adds utils like `getCoreContractAddress` for fetching core contract address from onchain registry. This is useful to get the stablecoin addresses you are planning to use programmatically. Make sure they are listed in the [**FeeCurrencyDirectory.sol**](/contracts/core-contracts).
+For Celo' specific features like [Fee Abstraction](/build/fee-abstraction/overview) transactions you need to install `@celo/web3-plugin-transaction-types` as well as `web3@4.13.1` or higher. This also adds utils like `getCoreContractAddress` for fetching core contract address from onchain registry. This is useful to get the stablecoin addresses you are planning to use programmatically. Make sure they are listed in the [**FeeCurrencyDirectory.sol**](/contracts/core-contracts).
 
 {/* prettier-ignore-start */}
 
diff --git a/tooling/nodes/alchemy.mdx b/build/tools/nodes/alchemy.mdx
similarity index 100%
rename from tooling/nodes/alchemy.mdx
rename to build/tools/nodes/alchemy.mdx
diff --git a/tooling/nodes/forno.mdx b/build/tools/nodes/forno.mdx
similarity index 95%
rename from tooling/nodes/forno.mdx
rename to build/tools/nodes/forno.mdx
index e5ecb7adb7..2289f6c9f0 100644
--- a/tooling/nodes/forno.mdx
+++ b/build/tools/nodes/forno.mdx
@@ -11,7 +11,7 @@ Forno is a cLabs hosted node service for interacting with the Celo network. This
 <Tip>
 **Best-Effort Service**
 
-Forno is a free service with no terms of service or uptime guarantees, and is rate limited. For production applications or as your usage increases, consider [professional RPC and node providers](/tooling/nodes/overview#as-a-service) that can provide the desired level of support (SLA).
+Forno is a free service with no terms of service or uptime guarantees, and is rate limited. For production applications or as your usage increases, consider [professional RPC and node providers](/build/tools/nodes/overview#as-a-service) that can provide the desired level of support (SLA).
 </Tip>
 
 Forno has HTTP and websocket endpoints that you can use to query current Celo data or post transactions that you would like to broadcast to the network. The service runs full nodes in non-archive mode, so you can query the current state of the blockchain, but cannot access historic state.
diff --git a/tooling/nodes/overview.mdx b/build/tools/nodes/overview.mdx
similarity index 97%
rename from tooling/nodes/overview.mdx
rename to build/tools/nodes/overview.mdx
index d3d198feb8..a619398d7d 100644
--- a/tooling/nodes/overview.mdx
+++ b/build/tools/nodes/overview.mdx
@@ -26,7 +26,7 @@ They are discoverable through the following:
 
 ## Forno
 
-[Forno](/tooling/nodes/forno) is a cLabs hosted node service for interacting with the Celo network. This allows you to connect to the Celo Blockchain without having to run your own node.
+[Forno](/build/tools/nodes/forno) is a cLabs hosted node service for interacting with the Celo network. This allows you to connect to the Celo Blockchain without having to run your own node.
 
 Forno has HTTP and WebSocket endpoints that you can use to query current Celo data or post transactions that you would like to broadcast to the network. The service runs full nodes in non-archive mode, so you can query the current state of the blockchain, but cannot access the historic state.
 
diff --git a/tooling/oracles/band-protocol.mdx b/build/tools/oracles/band-protocol.mdx
similarity index 98%
rename from tooling/oracles/band-protocol.mdx
rename to build/tools/oracles/band-protocol.mdx
index a91248203e..2db2df5b42 100644
--- a/tooling/oracles/band-protocol.mdx
+++ b/build/tools/oracles/band-protocol.mdx
@@ -22,7 +22,7 @@ This tutorial will go over:
 2. Compile the contract with compiler version `0.6.11`.
 3. Switch to the Deploy tab of Remix.
    1. Select "Injected Web3" in the Environment dropdown in the top left to connect Metamask.
-   2. Make sure that Metamask is connected to the Celo Sepolia test network. You can read about adding Celo Sepolia to Metamask [here](/tooling/wallets/metamask/setup#adding-a-celo-network-to-metamask).
+   2. Make sure that Metamask is connected to the Celo Sepolia test network. You can read about adding Celo Sepolia to Metamask [here](/build/tools/wallets/metamask/setup#adding-a-celo-network-to-metamask).
 
 <Frame>
 <img src="/img/doc-images/band-protocol-how-to/remix-environment.png" alt="environment" width="400" />
diff --git a/tooling/oracles/chainlink-oracles.mdx b/build/tools/oracles/chainlink-oracles.mdx
similarity index 100%
rename from tooling/oracles/chainlink-oracles.mdx
rename to build/tools/oracles/chainlink-oracles.mdx
diff --git a/tooling/oracles/dia.mdx b/build/tools/oracles/dia.mdx
similarity index 100%
rename from tooling/oracles/dia.mdx
rename to build/tools/oracles/dia.mdx
diff --git a/tooling/oracles/index.mdx b/build/tools/oracles/index.mdx
similarity index 93%
rename from tooling/oracles/index.mdx
rename to build/tools/oracles/index.mdx
index ce0b6628a7..fe8716a2ee 100644
--- a/tooling/oracles/index.mdx
+++ b/build/tools/oracles/index.mdx
@@ -20,5 +20,5 @@ Here are lists of all on-chain Oracles:
 - [Witnet](/developer/oracles/wit-oracle)
   - [Randomness](/developer/oracles/wit-oracle/#how-to-use-witnetrandomness)
 - [Quex Oracles](/developer/oracles/quex-oracles)
-- [DIA Oracles](/tooling/oracles/dia)
-  - [Randomness](/tooling/oracles/dia)
\ No newline at end of file
+- [DIA Oracles](/build/tools/oracles/dia)
+  - [Randomness](/build/tools/oracles/dia)
\ No newline at end of file
diff --git a/tooling/oracles/quex-oracles.mdx b/build/tools/oracles/quex-oracles.mdx
similarity index 100%
rename from tooling/oracles/quex-oracles.mdx
rename to build/tools/oracles/quex-oracles.mdx
diff --git a/tooling/oracles/redstone.mdx b/build/tools/oracles/redstone.mdx
similarity index 100%
rename from tooling/oracles/redstone.mdx
rename to build/tools/oracles/redstone.mdx
diff --git a/tooling/oracles/run.mdx b/build/tools/oracles/run.mdx
similarity index 100%
rename from tooling/oracles/run.mdx
rename to build/tools/oracles/run.mdx
diff --git a/tooling/oracles/supra.mdx b/build/tools/oracles/supra.mdx
similarity index 100%
rename from tooling/oracles/supra.mdx
rename to build/tools/oracles/supra.mdx
diff --git a/tooling/oracles/wit-oracle.mdx b/build/tools/oracles/wit-oracle.mdx
similarity index 100%
rename from tooling/oracles/wit-oracle.mdx
rename to build/tools/oracles/wit-oracle.mdx
diff --git a/tooling/overview/index.mdx b/build/tools/overview/index.mdx
similarity index 72%
rename from tooling/overview/index.mdx
rename to build/tools/overview/index.mdx
index 0fe2b9c64b..5a6f2cc8a3 100644
--- a/tooling/overview/index.mdx
+++ b/build/tools/overview/index.mdx
@@ -11,12 +11,12 @@ Explore our comprehensive suite of tools, guides, and resources designed to help
 
 Celo Composer allows you to quickly build, deploy, and iterate on decentralized applications using Celo. It provides a number of frameworks, examples, and Celo specific functionality to help you get started with your next app.
 
-- [Get started with Celopedia](/build-on-celo/build-with-ai/celopedia)
+- [Get started with Celopedia](/build/agents/celopedia)
 - [Celo Composer GitHub](https://github.com/celo-org/celo-composer)
 
 ## Developer Tools
 
-- [Nodes](/tooling/nodes/overview)
+- [Nodes](/build/tools/nodes/overview)
 - [Explorers](/developer/explorers/overview)
 - [Indexers](/developer/indexers/overview)
 - [Bridges](/developer/bridges)
@@ -24,10 +24,10 @@ Celo Composer allows you to quickly build, deploy, and iterate on decentralized
 
 ## Developer Environments
 
-- [Using Foundry](/tooling/dev-environments/foundry)
-- [Using Hardhat](/tooling/dev-environments/hardhat)
-- [Using Remix](/tooling/dev-environments/remix)
-- [Using thirdweb](/tooling/dev-environments/thirdweb)
+- [Using Foundry](/build/tools/dev-environments/foundry)
+- [Using Hardhat](/build/tools/dev-environments/hardhat)
+- [Using Remix](/build/tools/dev-environments/remix)
+- [Using thirdweb](/build/tools/dev-environments/thirdweb)
 
 ## Code Courses
 
diff --git a/tooling/overview/migrate/from-ethereum.mdx b/build/tools/overview/migrate/from-ethereum.mdx
similarity index 100%
rename from tooling/overview/migrate/from-ethereum.mdx
rename to build/tools/overview/migrate/from-ethereum.mdx
diff --git a/tooling/testnets/celo-sepolia/index.mdx b/build/tools/testnets/celo-sepolia/index.mdx
similarity index 100%
rename from tooling/testnets/celo-sepolia/index.mdx
rename to build/tools/testnets/celo-sepolia/index.mdx
diff --git a/tooling/wallets/index.mdx b/build/tools/wallets/index.mdx
similarity index 76%
rename from tooling/wallets/index.mdx
rename to build/tools/wallets/index.mdx
index e02b1d4834..1f33be55fa 100644
--- a/tooling/wallets/index.mdx
+++ b/build/tools/wallets/index.mdx
@@ -3,10 +3,10 @@ title: Wallet integration
 description: Providers for adding wallets to an app on Celo, with links to their docs and to the Celo guides for Ledger and MetaMask
 ---
 
-This page lists providers for adding wallets to an app on Celo. If you hold CELO and want to choose a wallet to use, see [Wallets for users](/learn/wallets); to list your Mini App inside MiniPay, see [Build for MiniPay](/build-on-celo/build-on-minipay/overview).
+This page lists providers for adding wallets to an app on Celo. If you hold CELO and want to choose a wallet to use, see [Wallets for users](/learn/wallets); to list your Mini App inside MiniPay, see [Build for MiniPay](/build/mini-apps/overview).
 
 <Note>
-  **Fee abstraction depends on the wallet.** Paying gas in stablecoins requires the wallet to build a CIP-64 transaction. A wallet without that support drops the app's `feeCurrency` and charges gas in CELO. See [which wallets support it](/build-on-celo/fee-abstraction/overview#wallet-support-for-cip-64).
+  **Fee abstraction depends on the wallet.** Paying gas in stablecoins requires the wallet to build a CIP-64 transaction. A wallet without that support drops the app's `feeCurrency` and charges gas in CELO. See [which wallets support it](/build/fee-abstraction/overview#wallet-support-for-cip-64).
 </Note>
 
 ## Wallet providers
@@ -57,7 +57,7 @@ Self-custodial embedded wallet infrastructure.
 Reown, formerly WalletConnect Inc., maintains WalletConnect, which connects apps to the wallets users already have.
 
 - Homepage: [reown.com](https://reown.com/)
-- [Reown on Celo](/tooling/libraries-sdks/reown)
+- [Reown on Celo](/build/tools/libraries-sdks/reown)
 - [Source Code](https://github.com/WalletConnect)
 
 ---
@@ -67,7 +67,7 @@ Reown, formerly WalletConnect Inc., maintains WalletConnect, which connects apps
 Wallet connection and authentication platform with built-in Celo support, covering multiple wallets, network switching and multi-wallet linking.
 
 - Homepage: [dynamic.xyz](https://www.dynamic.xyz/)
-- [Dynamic on Celo](/tooling/libraries-sdks/dynamic)
+- [Dynamic on Celo](/build/tools/libraries-sdks/dynamic)
 
 ---
 
@@ -93,7 +93,7 @@ Wallet and authentication suite for crypto applications.
 
 ### [Safe Wallet](https://app.safe.global/welcome)
 
-Smart account and multisig wallet platform. To sign Safe transactions with a Ledger over WalletConnect, see the [EIP-712 signing workaround](/tooling/wallets/ledger/eip712-workaround).
+Smart account and multisig wallet platform. To sign Safe transactions with a Ledger over WalletConnect, see the [EIP-712 signing workaround](/build/tools/wallets/ledger/eip712-workaround).
 
 - Homepage: [app.safe.global](https://app.safe.global/welcome)
 - [Docs](https://docs.safe.global/home/what-is-safe)
@@ -115,7 +115,7 @@ Zerion's developer API for building apps and wallets.
 MPC wallet provider: embedded MPC wallets for users, and an SDK for the web3 functionality of an app.
 
 - Homepage: [portalhq.io](https://portalhq.io/)
-- [Portal on Celo](/tooling/libraries-sdks/portal)
+- [Portal on Celo](/build/tools/libraries-sdks/portal)
 - Platforms: [iOS](https://docs.portalhq.io/guides/ios), [Android](https://docs.portalhq.io/guides/android), [Browser](https://docs.portalhq.io/guides/web), [Flutter](https://docs.portalhq.io/resources/flutter), [API](https://docs.portalhq.io/guides/enclave-mpc-api), [React Native](https://docs.portalhq.io/guides/react-native)
 - [Documentation](https://docs.portalhq.io/)
 
@@ -126,7 +126,7 @@ MPC wallet provider: embedded MPC wallets for users, and an SDK for the web3 fun
 Smart account infrastructure with passkey-secured accounts, ENS identity, gas sponsorship, and programmable permissions for subscriptions and delegated agent execution, through a TypeScript SDK.
 
 - Homepage: [jaw.id](https://jaw.id/)
-- [JAW on Celo](/tooling/libraries-sdks/jaw)
+- [JAW on Celo](/build/tools/libraries-sdks/jaw)
 - [Docs](https://docs.jaw.id/)
 - [Source Code](https://github.com/JustaName-id/jaw-mono)
 - [Dashboard](https://dashboard.jaw.id/)
@@ -135,14 +135,14 @@ Smart account infrastructure with passkey-secured accounts, ENS identity, gas sp
 
 ## Ledger and MetaMask guides
 
-- [Set up a Ledger with Celo](/tooling/wallets/ledger/setup) — Ledger Nano S or X
-- [Connect a Ledger to Celo Terminal](/tooling/wallets/ledger/to-celo-terminal), the [Celo web wallet](/tooling/wallets/ledger/to-celo-web) or the [Celo CLI](/tooling/wallets/ledger/to-celo-cli)
-- [EIP-712 signing workaround for Ledger](/tooling/wallets/ledger/eip712-workaround) — for apps that sign typed data, such as Safe over WalletConnect
-- [Programmatic MetaMask setup](/tooling/wallets/metamask/setup) — add a Celo network to MetaMask from your app with `wallet_addEthereumChain`
-- [MetaMask and Celo](/tooling/wallets/metamask/use) — what to keep in mind when users bring MetaMask
+- [Set up a Ledger with Celo](/build/tools/wallets/ledger/setup) — Ledger Nano S or X
+- [Connect a Ledger to Celo Terminal](/build/tools/wallets/ledger/to-celo-terminal), the [Celo web wallet](/build/tools/wallets/ledger/to-celo-web) or the [Celo CLI](/build/tools/wallets/ledger/to-celo-cli)
+- [EIP-712 signing workaround for Ledger](/build/tools/wallets/ledger/eip712-workaround) — for apps that sign typed data, such as Safe over WalletConnect
+- [Programmatic MetaMask setup](/build/tools/wallets/metamask/setup) — add a Celo network to MetaMask from your app with `wallet_addEthereumChain`
+- [MetaMask and Celo](/build/tools/wallets/metamask/use) — what to keep in mind when users bring MetaMask
 
 ## Related
 
 - [Wallets for users](/learn/wallets) — the wallets a holder can install
-- [Fee abstraction](/build-on-celo/fee-abstraction/overview) — pay gas in stablecoins, and which wallets support it
-- [Build for MiniPay](/build-on-celo/build-on-minipay/overview) — list a Mini App inside MiniPay
+- [Fee abstraction](/build/fee-abstraction/overview) — pay gas in stablecoins, and which wallets support it
+- [Build for MiniPay](/build/mini-apps/overview) — list a Mini App inside MiniPay
diff --git a/tooling/wallets/ledger/eip712-workaround.mdx b/build/tools/wallets/ledger/eip712-workaround.mdx
similarity index 100%
rename from tooling/wallets/ledger/eip712-workaround.mdx
rename to build/tools/wallets/ledger/eip712-workaround.mdx
diff --git a/tooling/wallets/ledger/setup.mdx b/build/tools/wallets/ledger/setup.mdx
similarity index 91%
rename from tooling/wallets/ledger/setup.mdx
rename to build/tools/wallets/ledger/setup.mdx
index a8393ca3ef..c76c336a58 100644
--- a/tooling/wallets/ledger/setup.mdx
+++ b/build/tools/wallets/ledger/setup.mdx
@@ -69,14 +69,14 @@ The Celo app is now ready for use and you should see `Application is ready` on t
 
 #### Connect your Leger to Celo applications
 
-- [Celo Terminal App](/tooling/wallets/ledger/to-celo-terminal)
-- [Celo Web Wallet](/tooling/wallets/ledger/to-celo-web)
-- [Celo CLI](/tooling/wallets/ledger/to-celo-cli)
+- [Celo Terminal App](/build/tools/wallets/ledger/to-celo-terminal)
+- [Celo Web Wallet](/build/tools/wallets/ledger/to-celo-web)
+- [Celo CLI](/build/tools/wallets/ledger/to-celo-cli)
 
 ## Known Limitations
 
 <Warning>
 The Celo Ledger app currently does not support signing EIP-712 typed data, which is required for certain operations like signing Safe multisig transactions via WalletConnect.
 
-If you need to sign EIP-712 transactions, you'll need to use the **Eth Recovery app** as a workaround. See the [EIP-712 Signing Workaround guide](/tooling/wallets/ledger/eip712-workaround) for detailed instructions.
+If you need to sign EIP-712 transactions, you'll need to use the **Eth Recovery app** as a workaround. See the [EIP-712 Signing Workaround guide](/build/tools/wallets/ledger/eip712-workaround) for detailed instructions.
 </Warning>
\ No newline at end of file
diff --git a/tooling/wallets/ledger/to-celo-cli.mdx b/build/tools/wallets/ledger/to-celo-cli.mdx
similarity index 100%
rename from tooling/wallets/ledger/to-celo-cli.mdx
rename to build/tools/wallets/ledger/to-celo-cli.mdx
diff --git a/tooling/wallets/ledger/to-celo-terminal.mdx b/build/tools/wallets/ledger/to-celo-terminal.mdx
similarity index 92%
rename from tooling/wallets/ledger/to-celo-terminal.mdx
rename to build/tools/wallets/ledger/to-celo-terminal.mdx
index c223d5f12d..430b591777 100644
--- a/tooling/wallets/ledger/to-celo-terminal.mdx
+++ b/build/tools/wallets/ledger/to-celo-terminal.mdx
@@ -45,5 +45,5 @@ Congrats, you have successfully attached your Ledger account to Celo Terminal.
 <Warning>
 The Celo Ledger app currently does not support signing EIP-712 typed data, which is required for Safe multisig transactions and certain apps.
 
-If you need to sign EIP-712 transactions, see the [EIP-712 Signing Workaround guide](/tooling/wallets/ledger/eip712-workaround) for detailed instructions on using the Eth Recovery app.
+If you need to sign EIP-712 transactions, see the [EIP-712 Signing Workaround guide](/build/tools/wallets/ledger/eip712-workaround) for detailed instructions on using the Eth Recovery app.
 </Warning>
\ No newline at end of file
diff --git a/tooling/wallets/ledger/to-celo-web.mdx b/build/tools/wallets/ledger/to-celo-web.mdx
similarity index 100%
rename from tooling/wallets/ledger/to-celo-web.mdx
rename to build/tools/wallets/ledger/to-celo-web.mdx
diff --git a/tooling/wallets/metamask/add-celo-testnet-to-metamask.mdx b/build/tools/wallets/metamask/add-celo-testnet-to-metamask.mdx
similarity index 100%
rename from tooling/wallets/metamask/add-celo-testnet-to-metamask.mdx
rename to build/tools/wallets/metamask/add-celo-testnet-to-metamask.mdx
diff --git a/tooling/wallets/metamask/import.mdx b/build/tools/wallets/metamask/import.mdx
similarity index 97%
rename from tooling/wallets/metamask/import.mdx
rename to build/tools/wallets/metamask/import.mdx
index 872f614854..4f8d91bf60 100644
--- a/tooling/wallets/metamask/import.mdx
+++ b/build/tools/wallets/metamask/import.mdx
@@ -19,7 +19,7 @@ Before getting started, it’s important to have downloaded MetaMask, Valora, an
 
 - [Download MetaMask](https://metamask.io/download/) and create an account.
 - [Download Valora](https://valoraapp.com/) and create an account.
-- Configure [MetaMask to work with Celo](/tooling/wallets/metamask/use)
+- Configure [MetaMask to work with Celo](/build/tools/wallets/metamask/use)
 - Install the [celocli](/cli/)
 
 ## Set up your project
diff --git a/tooling/wallets/metamask/setup.mdx b/build/tools/wallets/metamask/setup.mdx
similarity index 95%
rename from tooling/wallets/metamask/setup.mdx
rename to build/tools/wallets/metamask/setup.mdx
index fd2f97ee0d..91793dc24e 100644
--- a/tooling/wallets/metamask/setup.mdx
+++ b/build/tools/wallets/metamask/setup.mdx
@@ -69,7 +69,7 @@ await window.ethereum.request({
 - Where it says `INSERT_SYMBOL_HERE`, please replace with the correct symbol for the asset you'd like to watch. For Mento Dollar, it's `USDm` and for Mento Euro, it's `EURm`.
 
 <Tip>
-See [Stablecoin Contracts](/tooling/contracts/stablecoin-contracts) for the token addresses you can add to MetaMask.
+See [Stablecoin Contracts](/build/tools/contracts/stablecoin-contracts) for the token addresses you can add to MetaMask.
 </Tip>
 
 <Warning>
diff --git a/tooling/wallets/metamask/use.mdx b/build/tools/wallets/metamask/use.mdx
similarity index 78%
rename from tooling/wallets/metamask/use.mdx
rename to build/tools/wallets/metamask/use.mdx
index e3f98db0fe..86bdea68da 100644
--- a/tooling/wallets/metamask/use.mdx
+++ b/build/tools/wallets/metamask/use.mdx
@@ -15,12 +15,12 @@ Since Celo network's [Donut Hardfork](https://github.com/celo-org/celo-proposals
 
 ### **For end users:**
 
-- [Configure a MetaMask Desktop or Web Wallet to Work with Celo](/tooling/wallets/metamask/setup)
-- [Setup a Ledger to Work with MetaMask to Work With Celo](/tooling/wallets/ledger/setup)
+- [Configure a MetaMask Desktop or Web Wallet to Work with Celo](/build/tools/wallets/metamask/setup)
+- [Setup a Ledger to Work with MetaMask to Work With Celo](/build/tools/wallets/ledger/setup)
 
 ### **For developers:**
 
-- [Set up MetaMask to work with your app](/tooling/wallets/metamask/setup)
+- [Set up MetaMask to work with your app](/build/tools/wallets/metamask/setup)
 
 ## **Things to Keep in Mind**
 
@@ -32,17 +32,17 @@ Celo and Ethereum use different derivation paths for generating seed phrases. Be
 
 - You can't import an existing Celo account into the MetaMask wallet using its seed phrase, as you'd get the Ethereum version of it. Instead, you have to import it using the associated private key.
 - If you want to import the Celo account you made on MetaMask to a different Celo wallet (e.g. [Valora](https://valoraapp.com/) you'd have to import it using the private key itself, NOT the seed phrase that MetaMask gives you.
-- See this guide if you would like to [Import a Valora Account to MetaMask with a Private Key](/tooling/wallets/metamask/import)
+- See this guide if you would like to [Import a Valora Account to MetaMask with a Private Key](/build/tools/wallets/metamask/import)
 - See these guides if you accidentally sent ETH to CELO addresses or CELO to ETH addresses.
 
 ## **Gas Fees Require CELO**
 
-While gas on Celo can usually be paid in [many different currencies](/build-on-celo/fee-abstraction/overview), when using MetaMask, gas fees will automatically be paid in CELO. This is because MetaMask will be using the [Ethereum-compatible Celo transaction format](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0035.md), which doesn't include the `feeCurrency` field.
+While gas on Celo can usually be paid in [many different currencies](/build/fee-abstraction/overview), when using MetaMask, gas fees will automatically be paid in CELO. This is because MetaMask will be using the [Ethereum-compatible Celo transaction format](https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip-0035.md), which doesn't include the `feeCurrency` field.
 
 ## **Incorrect Logo**
 
 In some cases, the MetaMask UI may display the Ethereum logo in places where it should display a CELO logo or no logo at all.
 
 <Note>
-MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose a Celo native wallet [here](/tooling/wallets/metamask/setup).
+MetaMask is primarily used for interacting with the Ethereum blockchain and does not natively support Celo compatibility. Alternatively, you may choose a Celo native wallet [here](/build/tools/wallets/metamask/setup).
 </Note>
\ No newline at end of file
diff --git a/contribute-to-celo/community-rpc-nodes/registering-as-rpc-node.mdx b/contribute-to-celo/community-rpc-nodes/registering-as-rpc-node.mdx
index ed0c58b3b6..c259d18f26 100644
--- a/contribute-to-celo/community-rpc-nodes/registering-as-rpc-node.mdx
+++ b/contribute-to-celo/community-rpc-nodes/registering-as-rpc-node.mdx
@@ -89,7 +89,7 @@ The Celo CLI needs an RPC address. You can use the Celo Community RPC gateway wi
 </Note>
 
 <Note>
-You can use the Celo CLI with a Ledger hardware wallet (see [CLI docs](/tooling/wallets/ledger/to-celo-cli)) or pass a private key directly with the `--privateKey` flag. Both options work with any transaction-signing command.
+You can use the Celo CLI with a Ledger hardware wallet (see [CLI docs](/build/tools/wallets/ledger/to-celo-cli)) or pass a private key directly with the `--privateKey` flag. Both options work with any transaction-signing command.
 </Note>
 
 ### Setting Up the Node Account
diff --git a/docs.json b/docs.json
index 4612bf5345..1fa58f1d93 100644
--- a/docs.json
+++ b/docs.json
@@ -168,246 +168,236 @@
         ]
       },
       {
-        "tab": "Build on Celo",
+        "tab": "Build",
         "groups": [
           {
-            "group": "Overview",
+            "group": "Quickstart",
             "pages": [
-              "build-on-celo/index",
-              "build-on-celo/quickstart",
-              "build-on-celo/launch-checklist",
-              "build-on-celo/attribution-tags",
-              "build-on-celo/scaling-your-app",
-              "build-on-celo/fund-your-project",
-              "build-on-celo/nightfall"
+              "build/index",
+              "build/quickstart",
+              "build/tools/overview/index",
+              "build/tools/overview/migrate/from-ethereum"
             ]
           },
           {
-            "group": "Build with AI",
+            "group": "Agents",
             "pages": [
-              "build-on-celo/build-with-ai/overview",
-              "build-on-celo/build-with-ai/use-docs-with-ai",
-              {
-                "group": "Agent Identity",
-                "pages": [
-                  "build-on-celo/build-with-ai/8004",
-                  "build-on-celo/build-with-ai/self-agent-id"
-                ]
-              },
-              {
-                "group": "Agent Infrastructure",
-                "pages": [
-                  "build-on-celo/build-with-ai/x402",
-                  "build-on-celo/build-with-ai/x402-get-discovered",
-                  "build-on-celo/build-with-ai/mpp",
-                  "build-on-celo/build-with-ai/celopedia",
-                  "build-on-celo/build-with-ai/vibe-coding"
-                ]
-              },
-              {
-                "group": "MCP Servers",
-                "pages": [
-                  "build-on-celo/build-with-ai/mcp/index",
-                  "build-on-celo/build-with-ai/mcp/celo-mcp",
-                  "build-on-celo/build-with-ai/mcp/celina"
-                ]
-              },
-              "build-on-celo/build-with-ai/usecases"
+              "build/agents/overview",
+              "build/agents/use-docs-with-ai",
+              "build/agents/8004",
+              "build/agents/self-agent-id",
+              "build/agents/x402",
+              "build/agents/x402-get-discovered",
+              "build/agents/mpp",
+              "build/agents/celopedia",
+              "build/agents/vibe-coding",
+              "build/agents/mcp/index",
+              "build/agents/mcp/celo-mcp",
+              "build/agents/mcp/celina",
+              "build/agents/usecases",
+              "build/agents/attribution-tags"
             ]
           },
           {
-            "group": "Use Cases",
+            "group": "Mini Apps",
             "pages": [
-              "build-on-celo/build-on-minipay/overview",
-              "build-on-celo/build-with-farcaster",
-              "build-on-celo/build-with-self",
-              "build-on-celo/build-with-local-stablecoin",
-              "build-on-celo/build-with-usat",
-              "build-on-celo/build-on-socialconnect",
-              "build-on-celo/build-with-defi"
+              "build/mini-apps/overview"
             ]
           },
           {
-            "group": "Fee Abstraction",
+            "group": "Network info",
             "pages": [
-              "build-on-celo/fee-abstraction/overview",
-              "build-on-celo/fee-abstraction/using-fee-abstraction",
-              "build-on-celo/fee-abstraction/add-fee-currency"
-            ]
-          }
-        ]
-      },
-      {
-        "tab": "Tooling",
-        "groups": [
-          {
-            "group": "Overview",
-            "pages": [
-              "tooling/overview/index",
-              "tooling/overview/migrate/from-ethereum",
-              "tooling/bridges/bridges",
-              "tooling/bridges/cross-chain-messaging",
-              "tooling/testnets/celo-sepolia/index"
+              "build/tools/testnets/celo-sepolia/index",
+              "build/tools/nodes/overview",
+              "build/tools/nodes/forno",
+              "build/tools/nodes/alchemy"
             ]
           },
           {
-            "group": "Nodes",
+            "group": "Guides",
             "pages": [
-              "tooling/nodes/overview",
-              "tooling/nodes/forno",
-              "tooling/nodes/alchemy"
-            ]
-          },
-          {
-            "group": "Contracts",
-            "pages": [
-              "tooling/contracts/l1-contracts",
-              "tooling/contracts/core-contracts",
-              "tooling/contracts/stablecoin-contracts",
-              "tooling/contracts/fee-currencies",
-              "tooling/contracts/uniswap-contracts"
+              "build/build-with-farcaster",
+              "build/build-with-self",
+              "build/build-with-local-stablecoin",
+              "build/build-with-usat",
+              "build/build-on-socialconnect",
+              "build/build-with-defi",
+              {
+                "group": "Fee Abstraction",
+                "pages": [
+                  "build/fee-abstraction/overview",
+                  "build/fee-abstraction/using-fee-abstraction",
+                  "build/fee-abstraction/add-fee-currency"
+                ]
+              },
+              "build/scaling-your-app",
+              "build/nightfall",
+              "build/fund-your-project"
             ]
           },
           {
-            "group": "Wallets",
+            "group": "Tools",
             "pages": [
-              "tooling/wallets/index",
               {
-                "group": "MetaMask",
+                "group": "Libraries & SDKs",
                 "pages": [
-                  "tooling/wallets/metamask/add-celo-testnet-to-metamask",
-                  "tooling/wallets/metamask/setup",
-                  "tooling/wallets/metamask/use",
-                  "tooling/wallets/metamask/import"
+                  "build/tools/libraries-sdks/celo-sdks",
+                  "build/tools/libraries-sdks/composer-kit",
+                  {
+                    "group": "CLI",
+                    "pages": [
+                      "build/tools/libraries-sdks/cli/index",
+                      "build/tools/libraries-sdks/cli/account",
+                      "build/tools/libraries-sdks/cli/autocomplete",
+                      "build/tools/libraries-sdks/cli/commands",
+                      "build/tools/libraries-sdks/cli/config",
+                      "build/tools/libraries-sdks/cli/election",
+                      "build/tools/libraries-sdks/cli/epochs",
+                      "build/tools/libraries-sdks/cli/governance",
+                      "build/tools/libraries-sdks/cli/help",
+                      "build/tools/libraries-sdks/cli/identity",
+                      "build/tools/libraries-sdks/cli/lockedcelo",
+                      "build/tools/libraries-sdks/cli/multisig",
+                      "build/tools/libraries-sdks/cli/network",
+                      "build/tools/libraries-sdks/cli/node",
+                      "build/tools/libraries-sdks/cli/oracle",
+                      "build/tools/libraries-sdks/cli/plugins",
+                      "build/tools/libraries-sdks/cli/releasecelo",
+                      "build/tools/libraries-sdks/cli/rewards",
+                      "build/tools/libraries-sdks/cli/transfer",
+                      "build/tools/libraries-sdks/cli/validator",
+                      "build/tools/libraries-sdks/cli/validatorgroup"
+                    ]
+                  },
+                  "build/tools/libraries-sdks/viem/index",
+                  "build/tools/libraries-sdks/ethers/index",
+                  "build/tools/libraries-sdks/reown/index",
+                  "build/tools/libraries-sdks/dynamic/index",
+                  "build/tools/libraries-sdks/portal/index",
+                  "build/tools/libraries-sdks/jaw/index",
+                  {
+                    "group": "ContractKit",
+                    "pages": [
+                      "build/tools/libraries-sdks/contractkit/index",
+                      "build/tools/libraries-sdks/contractkit/setup",
+                      "build/tools/libraries-sdks/contractkit/usage",
+                      "build/tools/libraries-sdks/contractkit/contracts-wrappers-registry",
+                      "build/tools/libraries-sdks/contractkit/odis",
+                      "build/tools/libraries-sdks/contractkit/data-encryption-key",
+                      "build/tools/libraries-sdks/contractkit/migrating-to-viem",
+                      "build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v2",
+                      "build/tools/libraries-sdks/contractkit/migrating-to-contractkit-v1",
+                      "build/tools/libraries-sdks/contractkit/notes-web3-with-contractkit"
+                    ]
+                  },
+                  "build/tools/libraries-sdks/web3/index"
                 ]
               },
               {
-                "group": "Ledger Wallet",
+                "group": "Dev environments",
                 "pages": [
-                  "tooling/wallets/ledger/setup",
-                  "tooling/wallets/ledger/to-celo-terminal",
-                  "tooling/wallets/ledger/to-celo-web",
-                  "tooling/wallets/ledger/to-celo-cli",
-                  "tooling/wallets/ledger/eip712-workaround"
+                  "build/tools/dev-environments/index",
+                  "build/tools/dev-environments/foundry",
+                  "build/tools/dev-environments/thirdweb",
+                  {
+                    "group": "Using MultiBaas",
+                    "pages": [
+                      "build/tools/dev-environments/multibaas/overview",
+                      "build/tools/dev-environments/multibaas/contracts",
+                      "build/tools/dev-environments/multibaas/webhooks"
+                    ]
+                  },
+                  "build/tools/dev-environments/remix",
+                  "build/tools/dev-environments/hardhat"
                 ]
-              }
-            ]
-          },
-          {
-            "group": "Explorers",
-            "pages": [
-              "tooling/explorers/overview",
-              "tooling/explorers/block-explorers",
-              "tooling/explorers/analytics"
-            ]
-          },
-          {
-            "group": "Indexers",
-            "pages": [
-              "tooling/indexers/overview",
-              "tooling/indexers/the-graph",
-              "tooling/indexers/subquery",
-              "tooling/indexers/envio",
-              "tooling/indexers/goldrush",
-              "tooling/indexers/indexing-co",
-              "tooling/indexers/codex"
-            ]
-          },
-          {
-            "group": "Oracles",
-            "pages": [
-              "tooling/oracles/run",
-              "tooling/oracles/index",
-              "tooling/oracles/band-protocol",
-              "tooling/oracles/chainlink-oracles",
-              "tooling/oracles/redstone",
-              "tooling/oracles/supra",
-              "tooling/oracles/quex-oracles",
-              "tooling/oracles/dia",
-              "tooling/oracles/wit-oracle"
-            ]
-          },
-          {
-            "group": "Dev Environments",
-            "pages": [
-              "tooling/dev-environments/index",
-              "tooling/dev-environments/foundry",
-              "tooling/dev-environments/thirdweb",
+              },
               {
-                "group": "Using MultiBaas",
+                "group": "Wallets",
                 "pages": [
-                  "tooling/dev-environments/multibaas/overview",
-                  "tooling/dev-environments/multibaas/contracts",
-                  "tooling/dev-environments/multibaas/webhooks"
+                  "build/tools/wallets/index",
+                  {
+                    "group": "MetaMask",
+                    "pages": [
+                      "build/tools/wallets/metamask/add-celo-testnet-to-metamask",
+                      "build/tools/wallets/metamask/setup",
+                      "build/tools/wallets/metamask/use",
+                      "build/tools/wallets/metamask/import"
+                    ]
+                  },
+                  {
+                    "group": "Ledger Wallet",
+                    "pages": [
+                      "build/tools/wallets/ledger/setup",
+                      "build/tools/wallets/ledger/to-celo-terminal",
+                      "build/tools/wallets/ledger/to-celo-web",
+                      "build/tools/wallets/ledger/to-celo-cli",
+                      "build/tools/wallets/ledger/eip712-workaround"
+                    ]
+                  }
+                ]
+              },
+              {
+                "group": "Indexers",
+                "pages": [
+                  "build/tools/indexers/overview",
+                  "build/tools/indexers/the-graph",
+                  "build/tools/indexers/subquery",
+                  "build/tools/indexers/envio",
+                  "build/tools/indexers/goldrush",
+                  "build/tools/indexers/indexing-co",
+                  "build/tools/indexers/codex"
                 ]
               },
-              "tooling/dev-environments/remix",
-              "tooling/dev-environments/hardhat"
-            ]
-          },
-          {
-            "group": "Libraries & SDKs",
-            "pages": [
-              "tooling/libraries-sdks/celo-sdks",
-              "tooling/libraries-sdks/composer-kit",
               {
-                "group": "CLI",
+                "group": "Oracles",
                 "pages": [
-                  "tooling/libraries-sdks/cli/index",
-                  "tooling/libraries-sdks/cli/account",
-                  "tooling/libraries-sdks/cli/autocomplete",
-                  "tooling/libraries-sdks/cli/commands",
-                  "tooling/libraries-sdks/cli/config",
-                  "tooling/libraries-sdks/cli/election",
-                  "tooling/libraries-sdks/cli/epochs",
-                  "tooling/libraries-sdks/cli/governance",
-                  "tooling/libraries-sdks/cli/help",
-                  "tooling/libraries-sdks/cli/identity",
-                  "tooling/libraries-sdks/cli/lockedcelo",
-                  "tooling/libraries-sdks/cli/multisig",
-                  "tooling/libraries-sdks/cli/network",
-                  "tooling/libraries-sdks/cli/node",
-                  "tooling/libraries-sdks/cli/oracle",
-                  "tooling/libraries-sdks/cli/plugins",
-                  "tooling/libraries-sdks/cli/releasecelo",
-                  "tooling/libraries-sdks/cli/rewards",
-                  "tooling/libraries-sdks/cli/transfer",
-                  "tooling/libraries-sdks/cli/validator",
-                  "tooling/libraries-sdks/cli/validatorgroup"
+                  "build/tools/oracles/run",
+                  "build/tools/oracles/index",
+                  "build/tools/oracles/band-protocol",
+                  "build/tools/oracles/chainlink-oracles",
+                  "build/tools/oracles/redstone",
+                  "build/tools/oracles/supra",
+                  "build/tools/oracles/quex-oracles",
+                  "build/tools/oracles/dia",
+                  "build/tools/oracles/wit-oracle"
                 ]
               },
-              "tooling/libraries-sdks/viem/index",
-              "tooling/libraries-sdks/ethers/index",
-              "tooling/libraries-sdks/reown/index",
-              "tooling/libraries-sdks/dynamic/index",
-              "tooling/libraries-sdks/portal/index",
-              "tooling/libraries-sdks/jaw/index",
               {
-                "group": "ContractKit",
+                "group": "Explorers",
                 "pages": [
-                  "tooling/libraries-sdks/contractkit/index",
-                  "tooling/libraries-sdks/contractkit/setup",
-                  "tooling/libraries-sdks/contractkit/usage",
-                  "tooling/libraries-sdks/contractkit/contracts-wrappers-registry",
-                  "tooling/libraries-sdks/contractkit/odis",
-                  "tooling/libraries-sdks/contractkit/data-encryption-key",
-                  "tooling/libraries-sdks/contractkit/migrating-to-viem",
-                  "tooling/libraries-sdks/contractkit/migrating-to-contractkit-v2",
-                  "tooling/libraries-sdks/contractkit/migrating-to-contractkit-v1",
-                  "tooling/libraries-sdks/contractkit/notes-web3-with-contractkit"
+                  "build/tools/explorers/overview",
+                  "build/tools/explorers/block-explorers",
+                  "build/tools/explorers/analytics"
                 ]
               },
-              "tooling/libraries-sdks/web3/index"
+              {
+                "group": "Contract verification",
+                "pages": [
+                  "build/tools/contract-verification/index",
+                  "build/tools/contract-verification/blockscout",
+                  "build/tools/contract-verification/celoscan",
+                  "build/tools/contract-verification/remix",
+                  "build/tools/contract-verification/hardhat"
+                ]
+              },
+              {
+                "group": "Bridges",
+                "pages": [
+                  "build/tools/bridges/bridges",
+                  "build/tools/bridges/cross-chain-messaging"
+                ]
+              }
             ]
           },
           {
-            "group": "Contract Verification",
+            "group": "Reference",
             "pages": [
-              "tooling/contract-verification/index",
-              "tooling/contract-verification/blockscout",
-              "tooling/contract-verification/celoscan",
-              "tooling/contract-verification/remix",
-              "tooling/contract-verification/hardhat"
+              "build/tools/contracts/l1-contracts",
+              "build/tools/contracts/core-contracts",
+              "build/tools/contracts/stablecoin-contracts",
+              "build/tools/contracts/fee-currencies",
+              "build/tools/contracts/uniswap-contracts",
+              "build/launch-checklist"
             ]
           }
         ]
@@ -605,6 +595,42 @@
     "dark": "/images/CeloDocs_LogoDark.svg"
   },
   "redirects": [
+    {
+      "source": "/build-on-celo/attribution-tags",
+      "destination": "/build/agents/attribution-tags"
+    },
+    {
+      "source": "/build-on-celo",
+      "destination": "/build"
+    },
+    {
+      "source": "/build-on-celo/build-with-ai/:slug*",
+      "destination": "/build/agents/:slug*"
+    },
+    {
+      "source": "/build-on-celo/build-on-minipay/:slug*",
+      "destination": "/build/mini-apps/overview"
+    },
+    {
+      "source": "/build/build-with-ai/:slug*",
+      "destination": "/build/agents/:slug*"
+    },
+    {
+      "source": "/build/build-on-minipay/:slug*",
+      "destination": "/build/mini-apps/overview"
+    },
+    {
+      "source": "/tooling",
+      "destination": "/build/tools/overview"
+    },
+    {
+      "source": "/tooling/:slug*",
+      "destination": "/build/tools/:slug*"
+    },
+    {
+      "source": "/build-on-celo/:slug*",
+      "destination": "/build/:slug*"
+    },
     {
       "source": "/home",
       "destination": "/learn"
@@ -623,11 +649,11 @@
     },
     {
       "source": "/quickstart",
-      "destination": "/build-on-celo/quickstart"
+      "destination": "/build/quickstart"
     },
     {
       "source": "/operate/integration/nightfall",
-      "destination": "/build-on-celo/nightfall"
+      "destination": "/build/nightfall"
     },
     {
       "source": "/home/protocol/transaction/:slug*",
@@ -635,7 +661,7 @@
     },
     {
       "source": "/infra-partners/integration/nightfall",
-      "destination": "/build-on-celo/nightfall"
+      "destination": "/build/nightfall"
     },
     {
       "source": "/learn/celo-token",
@@ -643,11 +669,11 @@
     },
     {
       "source": "/learn/developer-tools",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/protocol/transaction/fee-abstraction",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/protocol/transaction/fees",
@@ -655,39 +681,39 @@
     },
     {
       "source": "/tooling/overview/network/node/overview",
-      "destination": "/tooling/nodes/overview"
+      "destination": "/build/tools/nodes/overview"
     },
     {
       "source": "/build-on-celo/contract-development/deploy/deploy-with-foundry",
-      "destination": "/tooling/dev-environments/foundry"
+      "destination": "/build/tools/dev-environments/foundry"
     },
     {
       "source": "/contract-development/deploy/deploy-with-foundry",
-      "destination": "/tooling/dev-environments/foundry"
+      "destination": "/build/tools/dev-environments/foundry"
     },
     {
       "source": "/build-on-celo/mobile-wallets/minipay",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build-on-celo/minipay/overview",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/celo-sdk/introduction",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/contract/reference/core-contracts",
-      "destination": "/tooling/contracts/core-contracts"
+      "destination": "/build/tools/contracts/core-contracts"
     },
     {
       "source": "/tooling/contracts/l1-core-contracts",
-      "destination": "/tooling/contracts/l1-contracts"
+      "destination": "/build/tools/contracts/l1-contracts"
     },
     {
       "source": "/tooling/contracts/legacy/l1-contracts",
-      "destination": "/tooling/contracts/l1-contracts"
+      "destination": "/build/tools/contracts/l1-contracts"
     },
     {
       "source": "/tooling/nodes/contribute-to-celo/community-rpc-nodes/community-rpc-node.mdx",
@@ -711,11 +737,11 @@
     },
     {
       "source": "/command-line-interface/commands/governance",
-      "destination": "/tooling/libraries-sdks/cli/governance"
+      "destination": "/build/tools/libraries-sdks/cli/governance"
     },
     {
       "source": "/developer/deploy-hardhat",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/developer/deployments/testnet",
@@ -723,19 +749,19 @@
     },
     {
       "source": "/developer/build/mcp/mcp",
-      "destination": "/build-on-celo/build-with-ai/mcp/index"
+      "destination": "/build/agents/mcp/index"
     },
     {
       "source": "/get-started/grants",
-      "destination": "/build-on-celo/fund-your-project"
+      "destination": "/build/fund-your-project"
     },
     {
       "source": "/build-on",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/tutorials",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/getting-started/baklava-testnet/running-a-validator",
@@ -759,15 +785,15 @@
     },
     {
       "source": "/operations-manual/summary/ledger",
-      "destination": "/tooling/wallets/ledger/setup"
+      "destination": "/build/tools/wallets/ledger/setup"
     },
     {
       "source": "/validator-guide/summary/ledger",
-      "destination": "/tooling/wallets/ledger/setup"
+      "destination": "/build/tools/wallets/ledger/setup"
     },
     {
       "source": "/tooling/libraries-sdks/viem/celo-transaction-types",
-      "destination": "/tooling/libraries-sdks/viem/index"
+      "destination": "/build/tools/libraries-sdks/viem/index"
     },
     {
       "source": "/home/celo-technology",
@@ -775,7 +801,7 @@
     },
     {
       "source": "/home/developer-tools",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/home/overview",
@@ -787,127 +813,123 @@
     },
     {
       "source": "/build/build-with-thirdweb/overview",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/build/build-with-thirdweb/celo-nft-drop-tutorial",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/build/build-with-thirdweb/one-click quickstart",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/build/composer-kit",
-      "destination": "/tooling/libraries-sdks/composer-kit"
+      "destination": "/build/tools/libraries-sdks/composer-kit"
     },
     {
       "source": "/build/mcp",
-      "destination": "/build-on-celo/build-with-ai/mcp/index"
+      "destination": "/build/agents/mcp/index"
     },
     {
       "source": "/build/mcp/celo-mcp",
-      "destination": "/build-on-celo/build-with-ai/mcp/celo-mcp"
+      "destination": "/build/agents/mcp/celo-mcp"
     },
     {
       "source": "/build/mcp/composer-mcp",
-      "destination": "/build-on-celo/build-with-ai/mcp/index"
-    },
-    {
-      "source": "/build/build-on-socialconnect",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/agents/mcp/index"
     },
     {
       "source": "/developer/verify/foundry",
-      "destination": "/tooling/contract-verification/index"
+      "destination": "/build/tools/contract-verification/index"
     },
     {
       "source": "/wallet/coinbase-wallet",
-      "destination": "/tooling/wallets/metamask/setup"
+      "destination": "/build/tools/wallets/metamask/setup"
     },
     {
       "source": "/build/support",
-      "destination": "/build-on-celo/index"
+      "destination": "/build/index"
     },
     {
       "source": "/network/alfajores/disclaimer",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/network/baklava/disclaimer",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/network/celo-sepolia/disclaimer",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/developer/setup/overview",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer/setup/mac",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/developer/setup/windows",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/developer/setup/wallet",
-      "destination": "/tooling/wallets/metamask/add-celo-testnet-to-metamask"
+      "destination": "/build/tools/wallets/metamask/add-celo-testnet-to-metamask"
     },
     {
       "source": "/developer/setup/replit",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/developer/setup/development-chain",
-      "destination": "/tooling/dev-environments/foundry"
+      "destination": "/build/tools/dev-environments/foundry"
     },
     {
       "source": "/developer/migrate/from-ethereum",
-      "destination": "/tooling/overview/migrate/from-ethereum"
+      "destination": "/build/tools/overview/migrate/from-ethereum"
     },
     {
       "source": "/tooling/overview/setup/overview",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/tooling/overview/setup/mac",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/tooling/overview/setup/windows",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/tooling/overview/setup/wallet",
-      "destination": "/tooling/wallets/metamask/add-celo-testnet-to-metamask"
+      "destination": "/build/tools/wallets/metamask/add-celo-testnet-to-metamask"
     },
     {
       "source": "/tooling/overview/setup/replit",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/tooling/overview/setup/development-chain",
-      "destination": "/tooling/dev-environments/foundry"
+      "destination": "/build/tools/dev-environments/foundry"
     },
     {
       "source": "/build-on-celo/support",
-      "destination": "/build-on-celo/index"
+      "destination": "/build/index"
     },
     {
       "source": "/tooling/contract-verification/foundry",
-      "destination": "/tooling/contract-verification/index"
+      "destination": "/build/tools/contract-verification/index"
     },
     {
       "source": "/tooling/testnets/celo-sepolia/disclaimer",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/tooling/wallets/coinbase-wallet",
-      "destination": "/tooling/wallets/metamask/setup"
+      "destination": "/build/tools/wallets/metamask/setup"
     },
     {
       "source": "/tooling/overview/faucet",
@@ -919,11 +941,11 @@
     },
     {
       "source": "/tooling/explorers/blockscout",
-      "destination": "/tooling/explorers/block-explorers"
+      "destination": "/build/tools/explorers/block-explorers"
     },
     {
       "source": "/tooling/explorers/celoscan",
-      "destination": "/tooling/explorers/block-explorers"
+      "destination": "/build/tools/explorers/block-explorers"
     },
     {
       "source": "/contribute-to-celo/code-of-conduct",
@@ -947,35 +969,35 @@
     },
     {
       "source": "/blog/2022/01/08/valora-wc-v1",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/blog/2022/03/04/3 Simple Steps to Connect your MetaMask Wallet To Celo",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/blog/2022/03/04/Celo CLI: A Practical Guide to Energize your Celo Toolkit",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/blog/2022/03/04/Celo Composer - Easily Build Full-Stack Mobile dApps on Celo",
-      "destination": "/tooling/libraries-sdks/composer-kit"
+      "destination": "/build/tools/libraries-sdks/composer-kit"
     },
     {
       "source": "/blog/2022/03/06/6 Steps to Quickly Build Smart Contracts on Celo with Remix",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/blog/2022/03/07/Truffle and Celo | The Ultimate Guide to Deploy Celo dApps with Truffle",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/cel2/builders",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/cel2/eclair",
-      "destination": "/tooling/testnets/celo-sepolia"
+      "destination": "/build/tools/testnets/celo-sepolia"
     },
     {
       "source": "/cel2/l2-operator-guide",
@@ -983,7 +1005,7 @@
     },
     {
       "source": "/cel2/notices/day-1-partners",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/cel2/operators/rpc-provider",
@@ -991,11 +1013,11 @@
     },
     {
       "source": "/cel2/guides/fee-abstraction",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/tooling/overview/fee-abstraction",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/celo-codebase/protocol",
@@ -1003,35 +1025,35 @@
     },
     {
       "source": "/celo-codebase/protocol/bridging/bridging-native-assets",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/bridging/bridging-to-celo",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/bridging/bridging-tokens-with-etherscan",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/bridging/migrating-to-optics-v2",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/bridging/optics-bridge-faq",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/bridging/optics-gui",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/bridging/optics-gui-kr",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/bridging/optics-gui-zh_cn",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/consensus",
@@ -1055,15 +1077,15 @@
     },
     {
       "source": "/celo-codebase/protocol/identity",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/celo-codebase/protocol/identity/encrypted-cloud-backup",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/identity/index",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/celo-codebase/protocol/identity/metadata",
@@ -1071,7 +1093,7 @@
     },
     {
       "source": "/celo-codebase/protocol/identity/phone-number-privacy",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/celo-codebase/protocol/identity/privacy-research",
@@ -1091,7 +1113,7 @@
     },
     {
       "source": "/celo-codebase/protocol/identity#using-the-mapping-for-payment",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/celo-codebase/protocol/index",
@@ -1099,47 +1121,47 @@
     },
     {
       "source": "/celo-codebase/protocol/odis",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/odis/domains",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/odis/domains/index",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/odis/domains/sequential-delay-domain",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/odis/index",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/odis/use-cases/key-hardening",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/odis/use-cases/phone-number-privacy",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/celo-codebase/protocol/optics",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/oracles/band-protocol-how-to",
-      "destination": "/tooling/oracles/band-protocol"
+      "destination": "/build/tools/oracles/band-protocol"
     },
     {
       "source": "/celo-codebase/protocol/oracles/oracles-on-celo",
-      "destination": "/tooling/oracles"
+      "destination": "/build/tools/oracles"
     },
     {
       "source": "/celo-codebase/protocol/oracles/redstone-protocol-how-to",
-      "destination": "/tooling/oracles/redstone"
+      "destination": "/build/tools/oracles/redstone"
     },
     {
       "source": "/celo-codebase/protocol/plumo",
@@ -1231,15 +1253,15 @@
     },
     {
       "source": "/celo-codebase/protocol/stability",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/celo-codebase/protocol/stability/adding_stable_assets",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/celo-codebase/protocol/stability/doto",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/celo-codebase/protocol/stability/granda-mento",
@@ -1247,11 +1269,11 @@
     },
     {
       "source": "/celo-codebase/protocol/stability/index",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/celo-codebase/protocol/stability/oracles",
-      "destination": "/tooling/oracles/index"
+      "destination": "/build/tools/oracles/index"
     },
     {
       "source": "/celo-codebase/protocol/stability/stability-fees",
@@ -1259,11 +1281,11 @@
     },
     {
       "source": "/celo-codebase/protocol/stability#stability-of-celos-stablecoin-protocol",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/celo-codebase/protocol/transactions/erc20-transaction-fees",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/celo-codebase/protocol/transactions/escrow",
@@ -1319,11 +1341,11 @@
     },
     {
       "source": "/celo-gold-holder-guide/ledger",
-      "destination": "/tooling/wallets/ledger/setup"
+      "destination": "/build/tools/wallets/ledger/setup"
     },
     {
       "source": "/celo-gold-holder-guide/ledger#install-the-celo-cli",
-      "destination": "/tooling/wallets/ledger/to-celo-cli"
+      "destination": "/build/tools/wallets/ledger/to-celo-cli"
     },
     {
       "source": "/celo-gold-holder-guide/quick-start",
@@ -1343,19 +1365,19 @@
     },
     {
       "source": "/celo-holder-guide/celo-recovery",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/celo-holder-guide/connecting-ledger-celo-terminal-wallet",
-      "destination": "/tooling/wallets/ledger/to-celo-terminal"
+      "destination": "/build/tools/wallets/ledger/to-celo-terminal"
     },
     {
       "source": "/celo-holder-guide/connecting-ledger-celo-web-wallet",
-      "destination": "/tooling/wallets/ledger/to-celo-web"
+      "destination": "/build/tools/wallets/ledger/to-celo-web"
     },
     {
       "source": "/celo-holder-guide/connecting-ledger-celocli",
-      "destination": "/tooling/wallets/ledger/to-celo-cli"
+      "destination": "/build/tools/wallets/ledger/to-celo-cli"
     },
     {
       "source": "/celo-holder-guide/cusd",
@@ -1363,7 +1385,7 @@
     },
     {
       "source": "/celo-holder-guide/eth-recovery",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/celo-holder-guide/governance-cheat-sheet",
@@ -1371,7 +1393,7 @@
     },
     {
       "source": "/celo-holder-guide/ledger",
-      "destination": "/tooling/wallets/ledger/setup"
+      "destination": "/build/tools/wallets/ledger/setup"
     },
     {
       "source": "/celo-holder-guide/owners",
@@ -1399,11 +1421,11 @@
     },
     {
       "source": "/celo-owner-guide/celo-recovery",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/celo-owner-guide/eth-recovery",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/celo-owner-guide/governance-cheat-sheet",
@@ -1411,7 +1433,7 @@
     },
     {
       "source": "/celo-owner-guide/ledger",
-      "destination": "/tooling/wallets/ledger/setup"
+      "destination": "/build/tools/wallets/ledger/setup"
     },
     {
       "source": "/celo-owner-guide/quick-start",
@@ -1439,15 +1461,15 @@
     },
     {
       "source": "/celo-sdk",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/celo-sdk/celo-dapp-gallery",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/celo-sdk/contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/celo.org",
@@ -1455,211 +1477,211 @@
     },
     {
       "source": "/cli/autocomplete",
-      "destination": "/tooling/libraries-sdks/cli/autocomplete"
+      "destination": "/build/tools/libraries-sdks/cli/autocomplete"
     },
     {
       "source": "/cli/commands/account",
-      "destination": "/tooling/libraries-sdks/cli/account"
+      "destination": "/build/tools/libraries-sdks/cli/account"
     },
     {
       "source": "/cli/commands/commands",
-      "destination": "/tooling/libraries-sdks/cli/commands"
+      "destination": "/build/tools/libraries-sdks/cli/commands"
     },
     {
       "source": "/cli/commands/config",
-      "destination": "/tooling/libraries-sdks/cli/config"
+      "destination": "/build/tools/libraries-sdks/cli/config"
     },
     {
       "source": "/cli/commands/dkg",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/cli/commands/election",
-      "destination": "/tooling/libraries-sdks/cli/election"
+      "destination": "/build/tools/libraries-sdks/cli/election"
     },
     {
       "source": "/cli/commands/exchange",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/cli/commands/governance",
-      "destination": "/tooling/libraries-sdks/cli/governance"
+      "destination": "/build/tools/libraries-sdks/cli/governance"
     },
     {
       "source": "/cli/commands/help",
-      "destination": "/tooling/libraries-sdks/cli/help"
+      "destination": "/build/tools/libraries-sdks/cli/help"
     },
     {
       "source": "/cli/commands/identity",
-      "destination": "/tooling/libraries-sdks/cli/identity"
+      "destination": "/build/tools/libraries-sdks/cli/identity"
     },
     {
       "source": "/cli/commands/lockedgold",
-      "destination": "/tooling/libraries-sdks/cli/lockedcelo"
+      "destination": "/build/tools/libraries-sdks/cli/lockedcelo"
     },
     {
       "source": "/cli/commands/multisig",
-      "destination": "/tooling/libraries-sdks/cli/multisig"
+      "destination": "/build/tools/libraries-sdks/cli/multisig"
     },
     {
       "source": "/cli/commands/network",
-      "destination": "/tooling/libraries-sdks/cli/network"
+      "destination": "/build/tools/libraries-sdks/cli/network"
     },
     {
       "source": "/cli/commands/node",
-      "destination": "/tooling/libraries-sdks/cli/node"
+      "destination": "/build/tools/libraries-sdks/cli/node"
     },
     {
       "source": "/cli/commands/oracle",
-      "destination": "/tooling/libraries-sdks/cli/oracle"
+      "destination": "/build/tools/libraries-sdks/cli/oracle"
     },
     {
       "source": "/cli/commands/plugins",
-      "destination": "/tooling/libraries-sdks/cli/plugins"
+      "destination": "/build/tools/libraries-sdks/cli/plugins"
     },
     {
       "source": "/cli/commands/registry",
-      "destination": "/tooling/libraries-sdks/cli/network"
+      "destination": "/build/tools/libraries-sdks/cli/network"
     },
     {
       "source": "/cli/commands/releasegold",
-      "destination": "/tooling/libraries-sdks/cli/releasecelo"
+      "destination": "/build/tools/libraries-sdks/cli/releasecelo"
     },
     {
       "source": "/cli/commands/reserve",
-      "destination": "/tooling/libraries-sdks/cli/commands"
+      "destination": "/build/tools/libraries-sdks/cli/commands"
     },
     {
       "source": "/cli/commands/rewards",
-      "destination": "/tooling/libraries-sdks/cli/rewards"
+      "destination": "/build/tools/libraries-sdks/cli/rewards"
     },
     {
       "source": "/cli/commands/transfer",
-      "destination": "/tooling/libraries-sdks/cli/transfer"
+      "destination": "/build/tools/libraries-sdks/cli/transfer"
     },
     {
       "source": "/cli/commands/validator",
-      "destination": "/tooling/libraries-sdks/cli/validator"
+      "destination": "/build/tools/libraries-sdks/cli/validator"
     },
     {
       "source": "/cli/commands/validatorgroup",
-      "destination": "/tooling/libraries-sdks/cli/validatorgroup"
+      "destination": "/build/tools/libraries-sdks/cli/validatorgroup"
     },
     {
       "source": "/command-line-interface/account",
-      "destination": "/tooling/libraries-sdks/cli/account"
+      "destination": "/build/tools/libraries-sdks/cli/account"
     },
     {
       "source": "/command-line-interface/autocomplete",
-      "destination": "/tooling/libraries-sdks/cli/autocomplete"
+      "destination": "/build/tools/libraries-sdks/cli/autocomplete"
     },
     {
       "source": "/command-line-interface/commands",
-      "destination": "/tooling/libraries-sdks/cli/commands"
+      "destination": "/build/tools/libraries-sdks/cli/commands"
     },
     {
       "source": "/command-line-interface/commands/account#celocli-account-new",
-      "destination": "/tooling/libraries-sdks/cli/account"
+      "destination": "/build/tools/libraries-sdks/cli/account"
     },
     {
       "source": "/command-line-interface/commands/exchange",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/command-line-interface/commands/exchange%5B/TD%5D",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/command-line-interface/config",
-      "destination": "/tooling/libraries-sdks/cli/config"
+      "destination": "/build/tools/libraries-sdks/cli/config"
     },
     {
       "source": "/command-line-interface/dkg",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/command-line-interface/election",
-      "destination": "/tooling/libraries-sdks/cli/election"
+      "destination": "/build/tools/libraries-sdks/cli/election"
     },
     {
       "source": "/command-line-interface/exchange",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/command-line-interface/governance",
-      "destination": "/tooling/libraries-sdks/cli/governance"
+      "destination": "/build/tools/libraries-sdks/cli/governance"
     },
     {
       "source": "/command-line-interface/grandamento",
-      "destination": "/tooling/libraries-sdks/cli/commands"
+      "destination": "/build/tools/libraries-sdks/cli/commands"
     },
     {
       "source": "/command-line-interface/help",
-      "destination": "/tooling/libraries-sdks/cli/help"
+      "destination": "/build/tools/libraries-sdks/cli/help"
     },
     {
       "source": "/command-line-interface/identity",
-      "destination": "/tooling/libraries-sdks/cli/identity"
+      "destination": "/build/tools/libraries-sdks/cli/identity"
     },
     {
       "source": "/command-line-interface/introduction",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/command-line-interface/lockedgold",
-      "destination": "/tooling/libraries-sdks/cli/lockedcelo"
+      "destination": "/build/tools/libraries-sdks/cli/lockedcelo"
     },
     {
       "source": "/command-line-interface/multisig",
-      "destination": "/tooling/libraries-sdks/cli/multisig"
+      "destination": "/build/tools/libraries-sdks/cli/multisig"
     },
     {
       "source": "/command-line-interface/network",
-      "destination": "/tooling/libraries-sdks/cli/network"
+      "destination": "/build/tools/libraries-sdks/cli/network"
     },
     {
       "source": "/command-line-interface/node",
-      "destination": "/tooling/libraries-sdks/cli/node"
+      "destination": "/build/tools/libraries-sdks/cli/node"
     },
     {
       "source": "/command-line-interface/oracle",
-      "destination": "/tooling/libraries-sdks/cli/oracle"
+      "destination": "/build/tools/libraries-sdks/cli/oracle"
     },
     {
       "source": "/command-line-interface/plugins",
-      "destination": "/tooling/libraries-sdks/cli/plugins"
+      "destination": "/build/tools/libraries-sdks/cli/plugins"
     },
     {
       "source": "/command-line-interface/releasegold",
-      "destination": "/tooling/libraries-sdks/cli/releasecelo"
+      "destination": "/build/tools/libraries-sdks/cli/releasecelo"
     },
     {
       "source": "/command-line-interface/reserve",
-      "destination": "/tooling/libraries-sdks/cli/commands"
+      "destination": "/build/tools/libraries-sdks/cli/commands"
     },
     {
       "source": "/command-line-interface/rewards",
-      "destination": "/tooling/libraries-sdks/cli/rewards"
+      "destination": "/build/tools/libraries-sdks/cli/rewards"
     },
     {
       "source": "/command-line-interface/transfer",
-      "destination": "/tooling/libraries-sdks/cli/transfer"
+      "destination": "/build/tools/libraries-sdks/cli/transfer"
     },
     {
       "source": "/command-line-interface/validator",
-      "destination": "/tooling/libraries-sdks/cli/validator"
+      "destination": "/build/tools/libraries-sdks/cli/validator"
     },
     {
       "source": "/command-line-interface/validatorgroup",
-      "destination": "/tooling/libraries-sdks/cli/validatorgroup"
+      "destination": "/build/tools/libraries-sdks/cli/validatorgroup"
     },
     {
       "source": "/blog/2022/03/18/Hardhat and Celo | The Ultimate Guide to Deploy Celo dApps using Hardhat",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/blog/2022/05/10/A Boilerplate guide to Airdropping on Celo",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/blog/2022/05/10/Getting started with DAOs on Celo",
@@ -1675,31 +1697,31 @@
     },
     {
       "source": "/blog/2022/05/20/ContractKit - A Practical Guide to Interacting with the Celo Core Contracts",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/blog/2022/05/24/Celo Dappstarter: Extend and Customize your Full-Stack Mobile dApps",
-      "destination": "/tooling/libraries-sdks/composer-kit"
+      "destination": "/build/tools/libraries-sdks/composer-kit"
     },
     {
       "source": "/blog/2022/06/14/How to quickly build an NFT collection on Celo",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/blog/tags/celo.org",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/blog/tags/docs.celo.org",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/blog/tutorials/devrel@celo.org",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/blog/tutorials/docs.celo.org",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/community/release-process/attestation-service",
@@ -1723,59 +1745,59 @@
     },
     {
       "source": "/contract-addresses",
-      "destination": "/tooling/contracts/core-contracts"
+      "destination": "/build/tools/contracts/core-contracts"
     },
     {
       "source": "/developer-guide",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-guide/celo-dapp-gallery",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-guide/celo-for-eth-devs",
-      "destination": "/tooling/overview/migrate/from-ethereum"
+      "destination": "/build/tools/overview/migrate/from-ethereum"
     },
     {
       "source": "/developer-guide/contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-guide/contractkit/contracts-wrappers-registry",
-      "destination": "/tooling/libraries-sdks/contractkit/contracts-wrappers-registry"
+      "destination": "/build/tools/libraries-sdks/contractkit/contracts-wrappers-registry"
     },
     {
       "source": "/developer-guide/contractkit/migrating-to-contractkit-v1",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-guide/contractkit/migrating-to-contractkit-v2",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-guide/contractkit/notes-web3-with-contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit/usage"
+      "destination": "/build/tools/libraries-sdks/contractkit/usage"
     },
     {
       "source": "/developer-guide/contractkit/odis",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/developer-guide/contractkit/setup",
-      "destination": "/tooling/libraries-sdks/contractkit/setup"
+      "destination": "/build/tools/libraries-sdks/contractkit/setup"
     },
     {
       "source": "/developer-guide/contractkit/usage",
-      "destination": "/tooling/libraries-sdks/contractkit/setup"
+      "destination": "/build/tools/libraries-sdks/contractkit/setup"
     },
     {
       "source": "/developer-guide/development-chain",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-guide/forno",
-      "destination": "/tooling/nodes/forno"
+      "destination": "/build/tools/nodes/forno"
     },
     {
       "source": "/developer-guide/integrations/checklist",
@@ -1807,15 +1829,15 @@
     },
     {
       "source": "/developer-guide/overview",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-guide/overview/celo-dapp-gallery",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-guide/overview/celo-for-eth-devs",
-      "destination": "/tooling/overview/migrate/from-ethereum"
+      "destination": "/build/tools/overview/migrate/from-ethereum"
     },
     {
       "source": "/developer-guide/overview/integrations/custody",
@@ -1823,27 +1845,27 @@
     },
     {
       "source": "/developer-guide/overview/introduction",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-guide/overview/introduction/contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-guide/sdk-code-reference/summary-2/classes/_wrappers_reserve_.reservewrapper",
-      "destination": "/tooling/libraries-sdks/contractkit/contracts-wrappers-registry"
+      "destination": "/build/tools/libraries-sdks/contractkit/contracts-wrappers-registry"
     },
     {
       "source": "/developer-guide/start",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-guide/start/develop-on-windows",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-guide/start/development-chain",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-guide/start/wallet-connect",
@@ -1851,83 +1873,83 @@
     },
     {
       "source": "/developer-guide/start/web-dapp",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/celo-dapp-gallery",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/celo-for-eth-devs",
-      "destination": "/tooling/overview/migrate/from-ethereum"
+      "destination": "/build/tools/overview/migrate/from-ethereum"
     },
     {
       "source": "/developer-resources/contractkit/contracts-wrappers-registry",
-      "destination": "/tooling/libraries-sdks/contractkit/contracts-wrappers-registry"
+      "destination": "/build/tools/libraries-sdks/contractkit/contracts-wrappers-registry"
     },
     {
       "source": "/developer-resources/contractkit/data-encryption-key",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-resources/contractkit/index",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-resources/contractkit/migrating-to-contractkit-v1",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-resources/contractkit/migrating-to-contractkit-v2",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-resources/contractkit/notes-web3-with-contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit/usage"
+      "destination": "/build/tools/libraries-sdks/contractkit/usage"
     },
     {
       "source": "/developer-resources/contractkit/odis",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/developer-resources/contractkit/setup",
-      "destination": "/tooling/libraries-sdks/contractkit/setup"
+      "destination": "/build/tools/libraries-sdks/contractkit/setup"
     },
     {
       "source": "/developer-resources/contractkit/usage",
-      "destination": "/tooling/libraries-sdks/contractkit/setup"
+      "destination": "/build/tools/libraries-sdks/contractkit/setup"
     },
     {
       "source": "/developer-resources/deploy-dapp",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/deploy-hardhat",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/developer-resources/deploy-remix",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/developer-resources/deploy-replit",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/deploy-truffle",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/develop-on-windows",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/ethers-js-wrapper",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/forno/index",
-      "destination": "/tooling/nodes/forno"
+      "destination": "/build/tools/nodes/forno"
     },
     {
       "source": "/developer-resources/integrations/checklist",
@@ -1971,143 +1993,143 @@
     },
     {
       "source": "/developer-resources/overview",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/testnet-wallet",
-      "destination": "/tooling/wallets/metamask/add-celo-testnet-to-metamask"
+      "destination": "/build/tools/wallets/metamask/add-celo-testnet-to-metamask"
     },
     {
       "source": "/developer-resources/use-contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-resources/using-mac",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/walkthroughs/development-chain",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/walkthroughs/no-code-erc20",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/developer-resources/walkthroughs/no-code-erc721",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/developer-resources/walkthroughs/hello-celo",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer-resources/walkthroughs/web-dapp",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer-resources/walkthroughs/valora-wc-v1",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/build-on-minipay",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-on-minipay/code-library",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-on-minipay/deeplinks",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-on-minipay/overview",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-on-minipay/prerequisites/ngrok-setup",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-on-minipay/quickstart",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build-on-celo/build-on-minipay/quickstart",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build-on-celo/build-on-minipay/code-library",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build-on-celo/build-on-minipay/deeplinks",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build-on-celo/build-on-minipay/prerequisites/ngrok-setup",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build/build-on-minipay",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build/build-on-minipay/quickstart",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build/build-on-minipay/code-library",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build/build-on-minipay/deeplinks",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build/build-on-minipay/prerequisites/ngrok-setup",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/build/build-on-minipay/overview",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-with-ai/overview",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/developer/evm-tools",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer/fee-currency",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/developer/indexer",
-      "destination": "/tooling/indexers/overview"
+      "destination": "/build/tools/indexers/overview"
     },
     {
       "source": "/developer/indexer/overview",
-      "destination": "/tooling/indexers/overview"
+      "destination": "/build/tools/indexers/overview"
     },
     {
       "source": "/developer/indexer/subquery",
-      "destination": "/tooling/indexers/subquery"
+      "destination": "/build/tools/indexers/subquery"
     },
     {
       "source": "/developer/indexer/the-graph",
-      "destination": "/tooling/indexers/the-graph"
+      "destination": "/build/tools/indexers/the-graph"
     },
     {
       "source": "/developer/walletconnect",
-      "destination": "/tooling/wallets"
+      "destination": "/build/tools/wallets"
     },
     {
       "source": "/developer/deploy/thirdweb",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/docs.celo.org",
@@ -2115,7 +2137,7 @@
     },
     {
       "source": "/es/learn/evm-compatible-tooling",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/faqs",
@@ -2155,11 +2177,11 @@
     },
     {
       "source": "/getting-started",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/getting-started...",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/getting-started/alfajores-testnet",
@@ -2207,7 +2229,7 @@
     },
     {
       "source": "/getting-started/hosted-nodes",
-      "destination": "/tooling/nodes/overview"
+      "destination": "/build/tools/nodes/overview"
     },
     {
       "source": "/getting-started/mainnet",
@@ -2259,11 +2281,11 @@
     },
     {
       "source": "/getting-started/running-oracles",
-      "destination": "/tooling/oracles/run"
+      "destination": "/build/tools/oracles/run"
     },
     {
       "source": "/getting-started/using-the-cli",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/getting-started/using-the-mobile-wallet",
@@ -2283,35 +2305,35 @@
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/manual-setup",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/manual-setup#adding-a-celo-network-to-metamask",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/manual-setup#adding-tokens-eg-cusd-ceur",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/manual-setup#sending-assets-to-metamask",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/manual-setup#setup",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/using-a-ledger-with-metamask",
-      "destination": "/tooling/wallets/ledger/setup"
+      "destination": "/build/tools/wallets/ledger/setup"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo#importing-via-private-key",
-      "destination": "/tooling/wallets/metamask/import"
+      "destination": "/build/tools/wallets/metamask/import"
     },
     {
       "source": "/getting-started/wallets#celo-compatible-wallets",
@@ -2399,7 +2421,7 @@
     },
     {
       "source": "/network/node/run-hosted",
-      "destination": "/tooling/nodes/overview"
+      "destination": "/build/tools/nodes/overview"
     },
     {
       "source": "/network/node/run-mainnet",
@@ -2407,15 +2429,15 @@
     },
     {
       "source": "/protocol/bridge",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/protocol/bridges",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/protocol/bridging",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/protocol/consensus/index",
@@ -2439,7 +2461,7 @@
     },
     {
       "source": "/protocol/cross-chain-messaging",
-      "destination": "/tooling/bridges/cross-chain-messaging"
+      "destination": "/build/tools/bridges/cross-chain-messaging"
     },
     {
       "source": "/protocol/governance",
@@ -2447,7 +2469,7 @@
     },
     {
       "source": "/protocol/identity/index",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/protocol/index",
@@ -2455,27 +2477,27 @@
     },
     {
       "source": "/protocol/oracle/band-protocol",
-      "destination": "/tooling/oracles/band-protocol"
+      "destination": "/build/tools/oracles/band-protocol"
     },
     {
       "source": "/protocol/oracle/chainlink-oracles",
-      "destination": "/tooling/oracles/chainlink-oracles"
+      "destination": "/build/tools/oracles/chainlink-oracles"
     },
     {
       "source": "/protocol/oracle/index",
-      "destination": "/tooling/oracles"
+      "destination": "/build/tools/oracles"
     },
     {
       "source": "/protocol/oracle/redstone",
-      "destination": "/tooling/oracles/redstone"
+      "destination": "/build/tools/oracles/redstone"
     },
     {
       "source": "/protocol/oracle/run",
-      "destination": "/tooling/oracles/run"
+      "destination": "/build/tools/oracles/run"
     },
     {
       "source": "/protocol/oracle/supra",
-      "destination": "/tooling/oracles/supra"
+      "destination": "/build/tools/oracles/supra"
     },
     {
       "source": "/protocol/pos/epoch-rewards",
@@ -2531,15 +2553,15 @@
     },
     {
       "source": "/protocol/socialconnect",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/protocol/stability",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/protocol/transaction/erc20-transaction-fees",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/protocol/transaction/escrow",
@@ -2547,7 +2569,7 @@
     },
     {
       "source": "/protocol/transaction/gas-pricing",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/protocol/transaction/native-currency",
@@ -2567,43 +2589,43 @@
     },
     {
       "source": "/token-addresses",
-      "destination": "/tooling/contracts/stablecoin-contracts"
+      "destination": "/build/tools/contracts/stablecoin-contracts"
     },
     {
       "source": "/tooling/contracts/token-contracts",
-      "destination": "/tooling/contracts/fee-currencies"
+      "destination": "/build/tools/contracts/fee-currencies"
     },
     {
       "source": "/contracts/token-contracts",
-      "destination": "/tooling/contracts/fee-currencies"
+      "destination": "/build/tools/contracts/fee-currencies"
     },
     {
       "source": "/v/master/developer-guide/overview",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/v/master/developer-guide/overview/introduction",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/v/master/developer-guide/overview/introduction/contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/v/master/developer-guide/overview/introduction/forno",
-      "destination": "/tooling/nodes/forno"
+      "destination": "/build/tools/nodes/forno"
     },
     {
       "source": "/v/master/developer-guide/start",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/v/master/developer-guide/start/hello-mobile-dapp",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/v/master/developer-guide/start/hellocelo",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/v/master/getting-started/baklava-testnet",
@@ -2787,7 +2809,7 @@
     },
     {
       "source": "/indexer/envio",
-      "destination": "/tooling/indexers/envio"
+      "destination": "/build/tools/indexers/envio"
     },
     {
       "source": "/what-is-celo/joining-celo/contributors/overview",
@@ -2853,121 +2875,113 @@
       "source": "/what-is-celo/joining-celo/community-rpc-nodes/validator-rpc-faq",
       "destination": "/contribute-to-celo/community-rpc-nodes/validator-rpc-faq"
     },
-    {
-      "source": "/build",
-      "destination": "/build-on-celo"
-    },
-    {
-      "source": "/build/:slug*",
-      "destination": "/build-on-celo/:slug*"
-    },
     {
       "source": "/developer",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer/contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer/contractkit/:slug*",
-      "destination": "/tooling/libraries-sdks/contractkit/:slug*"
+      "destination": "/build/tools/libraries-sdks/contractkit/:slug*"
     },
     {
       "source": "/developer/deploy",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer/deploy/:slug*",
-      "destination": "/tooling/dev-environments/:slug*"
+      "destination": "/build/tools/dev-environments/:slug*"
     },
     {
       "source": "/developer/verify",
-      "destination": "/tooling/contract-verification"
+      "destination": "/build/tools/contract-verification"
     },
     {
       "source": "/developer/verify/:slug*",
-      "destination": "/tooling/contract-verification/:slug*"
+      "destination": "/build/tools/contract-verification/:slug*"
     },
     {
       "source": "/developer/explorers/:slug*",
-      "destination": "/tooling/explorers/:slug*"
+      "destination": "/build/tools/explorers/:slug*"
     },
     {
       "source": "/developer/oracles",
-      "destination": "/tooling/oracles"
+      "destination": "/build/tools/oracles"
     },
     {
       "source": "/developer/oracles/:slug*",
-      "destination": "/tooling/oracles/:slug*"
+      "destination": "/build/tools/oracles/:slug*"
     },
     {
       "source": "/developer/indexers/:slug*",
-      "destination": "/tooling/indexers/:slug*"
+      "destination": "/build/tools/indexers/:slug*"
     },
     {
       "source": "/developer/bridges/:slug*",
-      "destination": "/tooling/bridges/:slug*"
+      "destination": "/build/tools/bridges/:slug*"
     },
     {
       "source": "/developer/setup/:slug*",
-      "destination": "/tooling/overview/:slug*"
+      "destination": "/build/tools/overview/:slug*"
     },
     {
       "source": "/developer/migrate/:slug*",
-      "destination": "/tooling/overview/:slug*"
+      "destination": "/build/tools/overview/:slug*"
     },
     {
       "source": "/developer/sdks/:slug*",
-      "destination": "/tooling/libraries-sdks/:slug*"
+      "destination": "/build/tools/libraries-sdks/:slug*"
     },
     {
       "source": "/developer/fee-abstraction",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/developer/launch-checklist",
-      "destination": "/build-on-celo/launch-checklist"
+      "destination": "/build/launch-checklist"
     },
     {
       "source": "/developer/dynamic/:slug*",
-      "destination": "/tooling/libraries-sdks/dynamic/:slug*"
+      "destination": "/build/tools/libraries-sdks/dynamic/:slug*"
     },
     {
       "source": "/developer/ethers/:slug*",
-      "destination": "/tooling/libraries-sdks/ethers/:slug*"
+      "destination": "/build/tools/libraries-sdks/ethers/:slug*"
     },
     {
       "source": "/developer/particle-network/:slug*",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/tooling/libraries-sdks/particle-network/:slug*",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/developer/portal/:slug*",
-      "destination": "/tooling/libraries-sdks/portal/:slug*"
+      "destination": "/build/tools/libraries-sdks/portal/:slug*"
     },
     {
       "source": "/developer/rainbowkit-celo/:slug*",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/developer/reown/:slug*",
-      "destination": "/tooling/libraries-sdks/reown/:slug*"
+      "destination": "/build/tools/libraries-sdks/reown/:slug*"
     },
     {
       "source": "/developer/thirdweb-sdk/:slug*",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/developer/viem/:slug*",
-      "destination": "/tooling/libraries-sdks/viem/:slug*"
+      "destination": "/build/tools/libraries-sdks/viem/:slug*"
     },
     {
       "source": "/developer/web3/:slug*",
-      "destination": "/tooling/libraries-sdks/web3/:slug*"
+      "destination": "/build/tools/libraries-sdks/web3/:slug*"
     },
     {
       "source": "/what-is-celo",
@@ -3031,11 +3045,11 @@
     },
     {
       "source": "/cli",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/cli/:slug*",
-      "destination": "/tooling/libraries-sdks/cli/:slug*"
+      "destination": "/build/tools/libraries-sdks/cli/:slug*"
     },
     {
       "source": "/network",
@@ -3043,35 +3057,35 @@
     },
     {
       "source": "/network/alfajores",
-      "destination": "/tooling/testnets/celo-sepolia"
+      "destination": "/build/tools/testnets/celo-sepolia"
     },
     {
       "source": "/network/alfajores/:slug*",
-      "destination": "/tooling/testnets/celo-sepolia/:slug*"
+      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
     },
     {
       "source": "/network/baklava",
-      "destination": "/tooling/testnets/celo-sepolia"
+      "destination": "/build/tools/testnets/celo-sepolia"
     },
     {
       "source": "/network/baklava/:slug*",
-      "destination": "/tooling/testnets/celo-sepolia/:slug*"
+      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
     },
     {
       "source": "/network/celo-sepolia",
-      "destination": "/tooling/testnets/celo-sepolia"
+      "destination": "/build/tools/testnets/celo-sepolia"
     },
     {
       "source": "/network/celo-sepolia/:slug*",
-      "destination": "/tooling/testnets/celo-sepolia/:slug*"
+      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
     },
     {
       "source": "/network/eclair",
-      "destination": "/tooling/testnets/celo-sepolia"
+      "destination": "/build/tools/testnets/celo-sepolia"
     },
     {
       "source": "/network/eclair/:slug*",
-      "destination": "/tooling/testnets/celo-sepolia"
+      "destination": "/build/tools/testnets/celo-sepolia"
     },
     {
       "source": "/network/mainnet",
@@ -3083,7 +3097,7 @@
     },
     {
       "source": "/network/node/:slug*",
-      "destination": "/tooling/nodes/:slug*"
+      "destination": "/build/tools/nodes/:slug*"
     },
     {
       "source": "/wallet",
@@ -3091,7 +3105,7 @@
     },
     {
       "source": "/wallet/:slug*",
-      "destination": "/tooling/wallets/:slug*"
+      "destination": "/build/tools/wallets/:slug*"
     },
     {
       "source": "/integration",
@@ -3127,7 +3141,7 @@
     },
     {
       "source": "/contracts/:slug*",
-      "destination": "/tooling/contracts/:slug*"
+      "destination": "/build/tools/contracts/:slug*"
     },
     {
       "source": "/cel2/faq",
@@ -3255,7 +3269,7 @@
     },
     {
       "source": "/learn/add-gas-currency",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/learn/CELO-coin-summary",
@@ -3303,7 +3317,7 @@
     },
     {
       "source": "/learn/celo-stack",
-      "destination": "/build-on-celo/index"
+      "destination": "/build/index"
     },
     {
       "source": "/learn/celo-summary",
@@ -3315,7 +3329,7 @@
     },
     {
       "source": "/learn/developer-onboarding",
-      "destination": "/build-on-celo/index"
+      "destination": "/build/index"
     },
     {
       "source": "/learn/platform-native-stablecoins-summary",
@@ -3347,43 +3361,43 @@
     },
     {
       "source": "/developer/bridges",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/developer/dynamic",
-      "destination": "/tooling/libraries-sdks/dynamic"
+      "destination": "/build/tools/libraries-sdks/dynamic"
     },
     {
       "source": "/developer/ethers",
-      "destination": "/tooling/libraries-sdks/ethers"
+      "destination": "/build/tools/libraries-sdks/ethers"
     },
     {
       "source": "/developer/particle-network",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/developer/portal",
-      "destination": "/tooling/libraries-sdks/portal"
+      "destination": "/build/tools/libraries-sdks/portal"
     },
     {
       "source": "/developer/rainbowkit-celo",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/developer/reown",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/thirdweb-sdk",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/developer/viem",
-      "destination": "/tooling/libraries-sdks/viem"
+      "destination": "/build/tools/libraries-sdks/viem"
     },
     {
       "source": "/developer/web3",
-      "destination": "/tooling/libraries-sdks/web3"
+      "destination": "/build/tools/libraries-sdks/web3"
     },
     {
       "source": "/what-is-celo/using-celo",
@@ -3391,71 +3405,71 @@
     },
     {
       "source": "/tooling/dev-environments/thirdweb/overview",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/tooling/dev-environments/thirdweb/thirdweb",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/tooling/dev-environments/thirdweb/one-click-deploy",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/tooling/libraries-sdks/thirdweb-sdk",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/tooling/libraries-sdks/thirdweb-sdk/index",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/build-on-celo/build-with-thirdweb/overview",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/build-on-celo/build-with-thirdweb/celo-nft-drop-tutorial",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/build-on-celo/build-with-thirdweb/one-click quickstart",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/build-on-celo/build-with-ai/build-with-goat/token-swap-agent",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/build-with-goat/mint-nft-agent",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/build-with-goat/send-token-agent",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/examples/ai-memecoins",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/examples/building_with_goat",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/examples/build-with-thirdweb-ai",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/resources",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/agent-skills",
-      "destination": "/build-on-celo/build-with-ai/celopedia"
+      "destination": "/build/agents/celopedia"
     },
     {
       "source": "/build-on-celo/build-with-ai/celo-pedia",
-      "destination": "/build-on-celo/build-with-ai/celopedia"
+      "destination": "/build/agents/celopedia"
     },
     {
       "source": "/tooling/overview/network-overview",
@@ -3547,7 +3561,7 @@
     },
     {
       "source": "/legacy/protocol/transaction/erc20-transaction-fees",
-      "destination": "/build-on-celo/fee-abstraction/overview"
+      "destination": "/build/fee-abstraction/overview"
     },
     {
       "source": "/legacy/protocol/transaction/gas-pricing",
@@ -3567,11 +3581,11 @@
     },
     {
       "source": "/legacy/protocol/stability/index",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/legacy/protocol/stability/adding-stable-assets",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/legacy/protocol/stability/stability-fees",
@@ -3579,11 +3593,11 @@
     },
     {
       "source": "/legacy/protocol/stability/oracles",
-      "destination": "/tooling/oracles/index"
+      "destination": "/build/tools/oracles/index"
     },
     {
       "source": "/legacy/protocol/stability/doto",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/legacy/protocol/stability/granda-mento",
@@ -3591,31 +3605,31 @@
     },
     {
       "source": "/legacy/protocol/identity/index",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/legacy/protocol/identity/odis",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/legacy/protocol/identity/odis-domain",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/legacy/protocol/identity/odis-domain-sequential-delay-domain",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/legacy/protocol/identity/odis-use-case-phone-number-privacy",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/legacy/protocol/identity/odis-use-case-key-hardening",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/legacy/protocol/identity/encrypted-cloud-backup",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/legacy/protocol/identity/smart-contract-accounts",
@@ -3795,35 +3809,35 @@
     },
     {
       "source": "/developer-resources/contractkit",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-resources/dappkit/usage",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/dappkit/usage",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer-resources/forno",
-      "destination": "/tooling/nodes/forno"
+      "destination": "/build/tools/nodes/forno"
     },
     {
       "source": "/protocol/identity/odis",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/oracle/band-protocol",
-      "destination": "/tooling/oracles/band-protocol"
+      "destination": "/build/tools/oracles/band-protocol"
     },
     {
       "source": "/oracle/redstone",
-      "destination": "/tooling/oracles/redstone"
+      "destination": "/build/tools/oracles/redstone"
     },
     {
       "source": "/oracle/run",
-      "destination": "/tooling/oracles/run"
+      "destination": "/build/tools/oracles/run"
     },
     {
       "source": "/what-is-celo/using-celo/eigenda",
@@ -3831,27 +3845,27 @@
     },
     {
       "source": "/developer/dev-environments/hardhat",
-      "destination": "/tooling/dev-environments/hardhat"
+      "destination": "/build/tools/dev-environments/hardhat"
     },
     {
       "source": "/developer/dev-environments/foundry",
-      "destination": "/tooling/dev-environments/foundry"
+      "destination": "/build/tools/dev-environments/foundry"
     },
     {
       "source": "/developer/dev-environments/remix",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/developer/dev-environments/thirdweb",
-      "destination": "/tooling/dev-environments/thirdweb"
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
       "source": "/developer/indexer/envio",
-      "destination": "/tooling/indexers/envio"
+      "destination": "/build/tools/indexers/envio"
     },
     {
       "source": "/developer/build-with-ai/usecases",
-      "destination": "/build-on-celo/build-with-ai/usecases"
+      "destination": "/build/agents/usecases"
     },
     {
       "source": "/cel2/cel2-architecture",
@@ -3859,23 +3873,23 @@
     },
     {
       "source": "/cel2/fee-currencies",
-      "destination": "/tooling/contracts/fee-currencies"
+      "destination": "/build/tools/contracts/fee-currencies"
     },
     {
       "source": "/build-on-celo/build-with-ai/celina",
-      "destination": "/build-on-celo/build-with-ai/mcp/celina"
+      "destination": "/build/agents/mcp/celina"
     },
     {
       "source": "/network/cannoli/disclaimer",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/tooling/testnets/alfajores/disclaimer",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/tooling/testnets/baklava/disclaimer",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/tooling/testnets/mainnet/disclaimer",
@@ -3883,11 +3897,11 @@
     },
     {
       "source": "/tooling/testnets/alfajores",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/tooling/testnets/baklava",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/tooling/testnets/mainnet",
@@ -3895,35 +3909,35 @@
     },
     {
       "source": "/tooling/testnets/eclair",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/oracle",
-      "destination": "/tooling/oracles"
+      "destination": "/build/tools/oracles"
     },
     {
       "source": "/network/cannoli",
-      "destination": "/tooling/testnets/celo-sepolia/index"
+      "destination": "/build/tools/testnets/celo-sepolia/index"
     },
     {
       "source": "/protocol/identity/odis-domain",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/protocol/identity/odis-domain-sequential-delay-domain",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/protocol/identity/odis-use-case-key-hardening",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/protocol/identity/odis-use-case-phone-number-privacy",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/protocol/identity/encrypted-cloud-backup",
-      "destination": "/tooling/libraries-sdks/contractkit/odis"
+      "destination": "/build/tools/libraries-sdks/contractkit/odis"
     },
     {
       "source": "/protocol/identity/metadata",
@@ -3951,23 +3965,23 @@
     },
     {
       "source": "/protocol/optics",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/protocol/oracle/chainlink",
-      "destination": "/tooling/oracles/chainlink-oracles"
+      "destination": "/build/tools/oracles/chainlink-oracles"
     },
     {
       "source": "/protocol/oracles/band-protocol-how-to",
-      "destination": "/tooling/oracles/band-protocol"
+      "destination": "/build/tools/oracles/band-protocol"
     },
     {
       "source": "/protocol/oracles/oracles-on-celo",
-      "destination": "/tooling/oracles"
+      "destination": "/build/tools/oracles"
     },
     {
       "source": "/protocol/oracles/redstone-protocol-how-to",
-      "destination": "/tooling/oracles/redstone"
+      "destination": "/build/tools/oracles/redstone"
     },
     {
       "source": "/protocol/plumo",
@@ -3983,11 +3997,11 @@
     },
     {
       "source": "/protocol/stability/adding-stable-assets",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/protocol/stability/doto",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/protocol/stability/granda-mento",
@@ -3995,7 +4009,7 @@
     },
     {
       "source": "/protocol/stability/oracles",
-      "destination": "/tooling/oracles/run"
+      "destination": "/build/tools/oracles/run"
     },
     {
       "source": "/protocol/stability/stability-fees",
@@ -4019,43 +4033,43 @@
     },
     {
       "source": "/developer/build-on-minipay/enabling-testnet",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-on-minipay/prerequisites/android-studio-setup",
-      "destination": "/build-on-celo/build-on-minipay/overview"
+      "destination": "/build/mini-apps/overview"
     },
     {
       "source": "/developer/build-with-ai/examples",
-      "destination": "/build-on-celo/build-with-ai/usecases"
+      "destination": "/build/agents/usecases"
     },
     {
       "source": "/developer/build-with-ai/resources",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/developer/build-with-ai/tools",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/developer/celo-ethers-wrapper",
-      "destination": "/tooling/libraries-sdks/ethers"
+      "destination": "/build/tools/libraries-sdks/ethers"
     },
     {
       "source": "/developer/dappkit",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/dappkit/setup",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/dev-environments/overview",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer/examples/chainlink-ccip",
-      "destination": "/tooling/bridges/cross-chain-messaging"
+      "destination": "/build/tools/bridges/cross-chain-messaging"
     },
     {
       "source": "/developer/faucet",
@@ -4063,75 +4077,75 @@
     },
     {
       "source": "/developer/react-celo",
-      "destination": "/tooling/libraries-sdks/contractkit/migrating-to-viem"
+      "destination": "/build/tools/libraries-sdks/contractkit/migrating-to-viem"
     },
     {
       "source": "/developer/socialconnect",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/developer/tools",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer/walkthrough/hello-celo",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer/walkthrough/hello-contract-remote-node",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer/walkthrough/hello-contracts",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer/walkthrough/no-code-erc20",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/developer/walkthrough/no-code-erc721",
-      "destination": "/tooling/dev-environments/remix"
+      "destination": "/build/tools/dev-environments/remix"
     },
     {
       "source": "/developer/walkthrough/using-js-keystores",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/developer/walkthrough/web-dapp",
-      "destination": "/build-on-celo/quickstart"
+      "destination": "/build/quickstart"
     },
     {
       "source": "/developer/walkthroughs/hello-contract-remote-node",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer/walkthroughs/hellocelo",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer/walkthroughs/hellocontracts",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer/walkthroughs/valora-wc-v1",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/web3modal",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/web3modal/ethers",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer/web3modal/wagmi",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/cel2/add-cel2-testnet-to-metamask",
-      "destination": "/tooling/wallets/metamask/add-celo-testnet-to-metamask"
+      "destination": "/build/tools/wallets/metamask/add-celo-testnet-to-metamask"
     },
     {
       "source": "/cel2/bridging/bridging-celo-from-holesky-to-alfajores-using-viem",
@@ -4159,7 +4173,7 @@
     },
     {
       "source": "/cel2/contract-addresses",
-      "destination": "/tooling/contracts/l1-contracts"
+      "destination": "/build/tools/contracts/l1-contracts"
     },
     {
       "source": "/cel2/decision-tree",
@@ -4167,11 +4181,11 @@
     },
     {
       "source": "/cel2/deploy-contract",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/cel2/developers-builders",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/cel2/network-information",
@@ -4231,11 +4245,11 @@
     },
     {
       "source": "/community/fundraising",
-      "destination": "/build-on-celo/fund-your-project"
+      "destination": "/build/fund-your-project"
     },
     {
       "source": "/community/grant-playbook",
-      "destination": "/build-on-celo/fund-your-project"
+      "destination": "/build/fund-your-project"
     },
     {
       "source": "/community/guidelines",
@@ -4263,7 +4277,7 @@
     },
     {
       "source": "/celo-codebase/protocol/bridging/bridging-to-celo-zh_cn",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/celo-codebase/protocol/consensus/README",
@@ -4275,7 +4289,7 @@
     },
     {
       "source": "/celo-codebase/protocol/identity/README",
-      "destination": "/build-on-celo/build-on-socialconnect"
+      "destination": "/build/build-on-socialconnect"
     },
     {
       "source": "/celo-codebase/protocol/proof-of-stake/README",
@@ -4283,7 +4297,7 @@
     },
     {
       "source": "/celo-codebase/protocol/stability/README",
-      "destination": "/build-on-celo/build-with-local-stablecoin"
+      "destination": "/build/build-with-local-stablecoin"
     },
     {
       "source": "/celo-codebase/protocol/stability/tobin-tax",
@@ -4319,11 +4333,11 @@
     },
     {
       "source": "/general/ecosystem/guides/fundraising",
-      "destination": "/build-on-celo/fund-your-project"
+      "destination": "/build/fund-your-project"
     },
     {
       "source": "/general/ecosystem/guides/grant-playbook",
-      "destination": "/build-on-celo/fund-your-project"
+      "destination": "/build/fund-your-project"
     },
     {
       "source": "/general/ecosystem/guides/guidelines",
@@ -4331,7 +4345,7 @@
     },
     {
       "source": "/general/gallery",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/general/glossary",
@@ -4355,7 +4369,7 @@
     },
     {
       "source": "/general/web2-to-web3",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/general/whitepapers",
@@ -4363,19 +4377,19 @@
     },
     {
       "source": "/build-on-celo/build-with-ai/examples/build-with-nebula",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/mcp/composer-mcp",
-      "destination": "/build-on-celo/build-with-ai/mcp/index"
+      "destination": "/build/agents/mcp/index"
     },
     {
       "source": "/build-on-celo/build-with-ai/multi-agent-systems",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-ai/tools",
-      "destination": "/build-on-celo/build-with-ai/overview"
+      "destination": "/build/agents/overview"
     },
     {
       "source": "/build-on-celo/build-with-bridge",
@@ -4383,7 +4397,7 @@
     },
     {
       "source": "/build-on-celo/build-with-zk-identity",
-      "destination": "/build-on-celo/build-with-self"
+      "destination": "/build/build-with-self"
     },
     {
       "source": "/getting-started/faucet",
@@ -4407,39 +4421,39 @@
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/choosing-the-right-gas-price",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/metamask-setup",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/metamask-valora-import",
-      "destination": "/tooling/wallets/metamask/import"
+      "destination": "/build/tools/wallets/metamask/import"
     },
     {
       "source": "/getting-started/wallets/using-metamask-with-celo/programmatic-setup",
-      "destination": "/tooling/wallets/metamask/setup"
+      "destination": "/build/tools/wallets/metamask/setup"
     },
     {
       "source": "/tooling/libraries-sdks/cli/dkg",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/tooling/libraries-sdks/cli/exchange",
-      "destination": "/tooling/libraries-sdks/cli"
+      "destination": "/build/tools/libraries-sdks/cli"
     },
     {
       "source": "/tooling/libraries-sdks/cli/lockedgold",
-      "destination": "/tooling/libraries-sdks/cli/lockedcelo"
+      "destination": "/build/tools/libraries-sdks/cli/lockedcelo"
     },
     {
       "source": "/tooling/libraries-sdks/cli/utils",
-      "destination": "/tooling/libraries-sdks/cli/network"
+      "destination": "/build/tools/libraries-sdks/cli/network"
     },
     {
       "source": "/tooling/libraries-sdks/rainbowkit-celo",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/legacy/node/run-alfajores",
@@ -4463,11 +4477,11 @@
     },
     {
       "source": "/holder/recover/from-celo-address",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/holder/recover/from-eth-address",
-      "destination": "/tooling/wallets/metamask/use"
+      "destination": "/build/tools/wallets/metamask/use"
     },
     {
       "source": "/holder/vote/governance",
@@ -4511,7 +4525,7 @@
     },
     {
       "source": "/command-line-interface/registry",
-      "destination": "/tooling/libraries-sdks/cli/network"
+      "destination": "/build/tools/libraries-sdks/cli/network"
     },
     {
       "source": "/FAQs",
@@ -4535,7 +4549,7 @@
     },
     {
       "source": "/uniswap-addresses",
-      "destination": "/tooling/contracts/uniswap-contracts"
+      "destination": "/build/tools/contracts/uniswap-contracts"
     },
     {
       "source": "/welcome",
@@ -4547,15 +4561,15 @@
     },
     {
       "source": "/developer-guide/dappkit",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer-guide/dappkit/setup",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer-guide/dappkit/usage",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer-guide/integrations",
@@ -4563,19 +4577,19 @@
     },
     {
       "source": "/developer-guide/start/hello-contract-remote-node",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-guide/start/hello-mobile",
-      "destination": "/build-on-celo/quickstart"
+      "destination": "/build/quickstart"
     },
     {
       "source": "/developer-guide/start/hellocelo",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer-guide/start/hellocontracts",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-guide/start/randomness",
@@ -4583,39 +4597,39 @@
     },
     {
       "source": "/developer-guide/start/using-js-keystores",
-      "destination": "/tooling/libraries-sdks/celo-sdks"
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
       "source": "/developer-resources/contractkit/README",
-      "destination": "/tooling/libraries-sdks/contractkit"
+      "destination": "/build/tools/libraries-sdks/contractkit"
     },
     {
       "source": "/developer-resources/dappkit",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer-resources/dappkit/README",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer-resources/dappkit/setup",
-      "destination": "/tooling/libraries-sdks/reown"
+      "destination": "/build/tools/libraries-sdks/reown"
     },
     {
       "source": "/developer-resources/forno/README",
-      "destination": "/tooling/nodes/forno"
+      "destination": "/build/tools/nodes/forno"
     },
     {
       "source": "/developer-resources/introduction",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/reference",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/start",
-      "destination": "/tooling/overview"
+      "destination": "/build/tools/overview"
     },
     {
       "source": "/developer-resources/style-guide/typescript",
@@ -4623,55 +4637,55 @@
     },
     {
       "source": "/developer-resources/walkthroughs",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer-resources/walkthroughs/README",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer-resources/walkthroughs/hello-contract-remote-node",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/walkthroughs/hello-mobile-dapp",
-      "destination": "/build-on-celo/quickstart"
+      "destination": "/build/quickstart"
     },
     {
       "source": "/developer-resources/walkthroughs/hellocelo",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/developer-resources/walkthroughs/hellocontracts",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/walkthroughs/hellodapp",
-      "destination": "/build-on-celo/quickstart"
+      "destination": "/build/quickstart"
     },
     {
       "source": "/developer-resources/walkthroughs/hellodeploy",
-      "destination": "/tooling/dev-environments"
+      "destination": "/build/tools/dev-environments"
     },
     {
       "source": "/developer-resources/walkthroughs/wallet-test",
-      "destination": "/tooling/wallets"
+      "destination": "/build/tools/wallets"
     },
     {
       "source": "/blog",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     },
     {
       "source": "/protocol/bridge/:slug*",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/protocol/bridging/:slug*",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/bridge/:slug*",
-      "destination": "/tooling/bridges/bridges"
+      "destination": "/build/tools/bridges/bridges"
     },
     {
       "source": "/community/celo-sage/:slug*",
@@ -4679,11 +4693,11 @@
     },
     {
       "source": "/build-on-celo/build-with-ai/celina/:slug*",
-      "destination": "/build-on-celo/build-with-ai/mcp/celina"
+      "destination": "/build/agents/mcp/celina"
     },
     {
       "source": "/blog/:slug*",
-      "destination": "/build-on-celo"
+      "destination": "/build"
     }
   ],
   "footer": {
diff --git a/learn/bridged-tokens/bridging-celo-from-ethereum.mdx b/learn/bridged-tokens/bridging-celo-from-ethereum.mdx
index 38c6597815..e3782aaab1 100644
--- a/learn/bridged-tokens/bridging-celo-from-ethereum.mdx
+++ b/learn/bridged-tokens/bridging-celo-from-ethereum.mdx
@@ -30,7 +30,7 @@ The following example demonstrates how to configure a file with all the details
     const CELOL1 = "0x3c7011fd5e6aed460caa4985cf8d8caba435b092";
 
     // Ethereum Sepolia (11155111), portal for Celo Sepolia
-    // https://docs.celo.org/tooling/contracts/l1-contracts
+    // https://docs.celo.org/build/tools/contracts/l1-contracts
     const OptimismPortalProxy = "0x44ae3d41a335a7d05eb533029917aad35662dcc2";
 
     const account = privateKeyToAccount(
@@ -152,4 +152,4 @@ The following example demonstrates how to configure a file with all the details
 
 - [Withdrawing CELO to Ethereum](/learn/bridged-tokens/withdrawing-celo-to-ethereum) - the reverse direction, through the three-step withdrawal flow
 - [Bridges](/learn/bridged-tokens/bridges) - bridge UIs, including Superbridge for mainnet
-- [L1 contracts](/tooling/contracts/l1-contracts) - the portal and token addresses for mainnet and Celo Sepolia
+- [L1 contracts](/build/tools/contracts/l1-contracts) - the portal and token addresses for mainnet and Celo Sepolia
diff --git a/learn/bridged-tokens/withdrawing-celo-to-ethereum.mdx b/learn/bridged-tokens/withdrawing-celo-to-ethereum.mdx
index 9156d2d1b2..6763f681cb 100644
--- a/learn/bridged-tokens/withdrawing-celo-to-ethereum.mdx
+++ b/learn/bridged-tokens/withdrawing-celo-to-ethereum.mdx
@@ -151,4 +151,4 @@ The following example demonstrates how to configure a file with all the details
 
 - [Bridging CELO from Ethereum](/learn/bridged-tokens/bridging-celo-from-ethereum) - the deposit direction
 - [Bridges](/learn/bridged-tokens/bridges) - bridge UIs, including Superbridge for mainnet
-- [L1 contracts](/tooling/contracts/l1-contracts) - the portal and token addresses for mainnet and Celo Sepolia
+- [L1 contracts](/build/tools/contracts/l1-contracts) - the portal and token addresses for mainnet and Celo Sepolia
diff --git a/learn/celo.mdx b/learn/celo.mdx
index 75fd357423..fa9946773b 100644
--- a/learn/celo.mdx
+++ b/learn/celo.mdx
@@ -5,7 +5,7 @@ description: "Celo is a leading Ethereum L2. As the frontier chain for global im
 
 import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx';
 
-<Card title="Start Building" icon="rocket" href="/build-on-celo/build-with-ai/celopedia">
+<Card title="Start Building" icon="rocket" href="/build/agents/celopedia">
   Build your first app on Celo. No coding experience required.
 </Card>
 
@@ -14,13 +14,13 @@ import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx';
 ## AI Agent Infrastructure
 
 <CardGroup cols={2}>
-  <Card title="ERC-8004: Agent Trust" icon="shield-check" href="/build-on-celo/build-with-ai/8004">
+  <Card title="ERC-8004: Agent Trust" icon="shield-check" href="/build/agents/8004">
     Establish trust infrastructure for autonomous AI agents with identity, reputation, and validation registries.
   </Card>
-  <Card title="x402: Agent Payments" icon="money-bill-transfer" href="/build-on-celo/build-with-ai/x402">
+  <Card title="x402: Agent Payments" icon="money-bill-transfer" href="/build/agents/x402">
     Enable instant, permissionless micropayments for AI agents using stablecoins via HTTP 402.
   </Card>
-  <Card title="MPP: Machine Payments" icon="credit-card" href="/build-on-celo/build-with-ai/mpp">
+  <Card title="MPP: Machine Payments" icon="credit-card" href="/build/agents/mpp">
     Charge USDC per API request over HTTP — gasless for the buyer, settled on-chain via a hosted facilitator.
   </Card>
   <Card title="Celopedia: Celo Skill" icon="book-open" href="https://celopedia.celo.org/">
@@ -31,16 +31,16 @@ import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx';
 ## Real World Use Cases
 
 <CardGroup cols={2}>
-  <Card title="Mini Apps" icon="grid-2" href="/build-on-celo/build-on-minipay/overview">
+  <Card title="Mini Apps" icon="grid-2" href="/build/mini-apps/overview">
     Build apps that scale to millions of global mobile wallet users via MiniPay.
   </Card>
-  <Card title="Local Stablecoins" icon="coin-blank" href="/build-on-celo/build-with-local-stablecoin">
+  <Card title="Local Stablecoins" icon="coin-blank" href="/build/build-with-local-stablecoin">
     Create low-cost FX and payment apps via Mento’s 25+ local digital currencies.
   </Card>
-  <Card title="AI Agents" icon="robot" href="/build-on-celo/build-with-ai/overview">
+  <Card title="AI Agents" icon="robot" href="/build/agents/overview">
     Launch AI agents, use MCP servers, and build intelligent applications for the onchain economy with Celo's AI-focused tools and frameworks.
   </Card>
-  <Card title="ZK Identity" icon="passport" href="/build-on-celo/build-with-self">
+  <Card title="ZK Identity" icon="passport" href="/build/build-with-self">
     Prove users’ humanity and unique identity without compromising privacy via Self Protocol.
   </Card>
 </CardGroup>
@@ -48,10 +48,10 @@ import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx';
 ## Builder Support
 
 <CardGroup cols={2}>
-  <Card title="Build on Celo" icon="wrench" href="/build-on-celo">
+  <Card title="Build on Celo" icon="wrench" href="/build">
     Explore comprehensive guides, tutorials, and tools to build apps, DeFi protocols, mobile apps, and more on Celo's fast, low-cost blockchain.
   </Card>
-  <Card title="Fund your Project" icon="dollar-sign" href="/build-on-celo/fund-your-project">
+  <Card title="Fund your Project" icon="dollar-sign" href="/build/fund-your-project">
     Discover grant opportunities and funding sources available in the Celo ecosystem.
   </Card>
 </CardGroup>
@@ -88,10 +88,10 @@ Connect your browser wallet to Celo in one click. See all network details on the
 
   <Accordion title="Build with Celo">
     <CardGroup cols={2}>
-      <Card title="Quickstart" icon="bolt" href="/build-on-celo/build-with-ai/celopedia">
+      <Card title="Quickstart" icon="bolt" href="/build/agents/celopedia">
         Build & Deploy your apps in under 5 minutes
       </Card>
-      <Card title="Tutorials" icon="graduation-cap" href="/build-on-celo">
+      <Card title="Tutorials" icon="graduation-cap" href="/build">
         Explore Celo Tutorials
       </Card>
       <Card title="Integrate" icon="plug" href="/learn/network/overview">
@@ -106,23 +106,23 @@ Connect your browser wallet to Celo in one click. See all network details on the
       <Card title="Faucet" icon="droplet" href="https://faucet.celo.org">
         Get testnet tokens for development
       </Card>
-      <Card title="Explorer" icon="search" href="/tooling/explorers/overview">
+      <Card title="Explorer" icon="search" href="/build/tools/explorers/overview">
         Explore transactions on Celo
       </Card>
       <Card title="Bridge" icon="bridge" href="/learn/bridged-tokens/bridges">
         Bridge Assets across chains
       </Card>
-      <Card title="Deploy" icon="upload" href="/tooling/dev-environments">
+      <Card title="Deploy" icon="upload" href="/build/tools/dev-environments">
         Deploy your contract on Celo
       </Card>
     </CardGroup>
   </Accordion>
   <Accordion title="Grow Your Project">
     <CardGroup cols={2}>
-      <Card title="Get Funding" icon="dollar-sign" href="/build-on-celo/fund-your-project">
+      <Card title="Get Funding" icon="dollar-sign" href="/build/fund-your-project">
         Discover grant opportunities in the Celo ecosystem
       </Card>
-      <Card title="Distribution" icon="megaphone" href="/build-on-celo/launch-checklist">
+      <Card title="Distribution" icon="megaphone" href="/build/launch-checklist">
         Get more awareness about your project
       </Card>
     </CardGroup>
diff --git a/learn/manage/asset.mdx b/learn/manage/asset.mdx
index 5ea01318b6..59474453b4 100644
--- a/learn/manage/asset.mdx
+++ b/learn/manage/asset.mdx
@@ -28,7 +28,7 @@ In order to execute the tasks listed below, you will need to point the Celo CLI
 
 There are two ways to create an account:
 
-- (Recommended) use [accounts generated by Ledger](/tooling/wallets/ledger/setup), if you possess a [Ledger hardware wallet](https://shop.ledger.com/products/ledger-nano-s)
+- (Recommended) use [accounts generated by Ledger](/build/tools/wallets/ledger/setup), if you possess a [Ledger hardware wallet](https://shop.ledger.com/products/ledger-nano-s)
 - Use CLI to [generate an account](/cli/account#celocli-accountnew) -- this approach is less secure and hence not recommended
 
 After creating an account, record its address in environment variables:
diff --git a/learn/manage/self-custody.mdx b/learn/manage/self-custody.mdx
index 416203e9b8..2d58d972d0 100644
--- a/learn/manage/self-custody.mdx
+++ b/learn/manage/self-custody.mdx
@@ -23,7 +23,7 @@ This guide assumes:
 
 - You have been informed by cLabs that the `ReleaseGold` instance corresponding to your address has been deployed.
 
-- You have your private key held on a [Ledger Nano S or Ledger Nano X](/tooling/wallets/ledger/setup) device, and you have a second such device available for managing a voting key. If you only have a single Ledger available, see [below](#using-a-single-ledger).
+- You have your private key held on a [Ledger Nano S or Ledger Nano X](/build/tools/wallets/ledger/setup) device, and you have a second such device available for managing a voting key. If you only have a single Ledger available, see [below](#using-a-single-ledger).
 
 <Warning>
 **Warning**: Self-custodying keys have associated security and financial risks. Loss or theft of keys can result in irrecoverable loss of funds. This guide also requires technical knowledge. You should be comfortable with using a Command Line Interface (CLI) and understand the basics of how cryptographic network accounts work.
@@ -33,7 +33,7 @@ This guide assumes:
 
 If you have any questions or need assistance with these instructions, please contact cLabs or ask in the `#celo-holders` channel on [Celo's Discord server](https://chat.celo.org). Remember that Discord is a public channel: never disclose recovery phrases (also known as backup keys, or mnemonics), private keys, unsanitized log output, or personal information.
 
-Please refer to the [Ledger Troubleshooting](/tooling/wallets/ledger/to-celo-cli#troubleshooting) for issues using Ledgers with the Celo CLI.
+Please refer to the [Ledger Troubleshooting](/build/tools/wallets/ledger/to-celo-cli#troubleshooting) for issues using Ledgers with the Celo CLI.
 
 ## Outline
 
@@ -53,15 +53,15 @@ You will need:
 
 - Your **Vote Signer Ledger:** One Ledger Nano S or X configured with a new, unused key. This will become a "warm wallet" you can use whenever you want to participate in validator elections or governance proposals.
 
-As a first step, follow [these instructions](/tooling/wallets/ledger/setup) for both Ledgers to install the Ledger Celo app, obtain and verify the associated addresses, and (recommended) run a test transaction on the Celo Sepolia test network.
+As a first step, follow [these instructions](/build/tools/wallets/ledger/setup) for both Ledgers to install the Ledger Celo app, obtain and verify the associated addresses, and (recommended) run a test transaction on the Celo Sepolia test network.
 
-The remainder of this guide assumes you are using the first address available on each Ledger. You can add the flags described in [these instructions](/tooling/wallets/ledger/setup) to commands below to use different addresses.
+The remainder of this guide assumes you are using the first address available on each Ledger. You can add the flags described in [these instructions](/build/tools/wallets/ledger/setup) to commands below to use different addresses.
 
 ### Using a single Ledger
 
 If you only have a single Ledger, and are comfortable losing the security advantage of keeping the beneficiary key offline when voting, you can configure a second address on the same Ledger as your voting key.
 
-First, read [these instructions](/tooling/wallets/ledger/setup) carefully. Then, wherever you see instructions to connect your Vote Signer Ledger, for each command line containing `--useLedger` also add `--ledgerCustomAddresses "[1]"`. If in doubt, [ask for help](#support).
+First, read [these instructions](/build/tools/wallets/ledger/setup) carefully. Then, wherever you see instructions to connect your Vote Signer Ledger, for each command line containing `--useLedger` also add `--ledgerCustomAddresses "[1]"`. If in doubt, [ask for help](#support).
 
 ## Deployment
 
diff --git a/learn/network/overview.mdx b/learn/network/overview.mdx
index fbc6e360b1..f9f58ffa21 100644
--- a/learn/network/overview.mdx
+++ b/learn/network/overview.mdx
@@ -17,8 +17,8 @@ Overview of Celo Mainnet and the Celo Sepolia Testnet.
 | Description                | The production Celo network                                                                                                                                                                               |
 | Chain ID                   | 42220                                                                                                                                                                                                     |
 | Currency Symbol            | CELO                                                                                                                                                                                                      |
-| RPC Nodes                  | [List of RPC providers](/tooling/nodes/overview#as-a-service)                                                                                                                                            |
-| RPC Endpoint (best effort) | https://forno.celo.org <br/> Note: [Forno](/tooling/nodes/forno#celo-mainnet) is rate limited, as your usage increases consider options that can provide the desired level of support (SLA).                          |
+| RPC Nodes                  | [List of RPC providers](/build/tools/nodes/overview#as-a-service)                                                                                                                                            |
+| RPC Endpoint (best effort) | https://forno.celo.org <br/> Note: [Forno](/build/tools/nodes/forno#celo-mainnet) is rate limited, as your usage increases consider options that can provide the desired level of support (SLA).                          |
 | Block Explorers            | <ul><li>[https://explorer.celo.org](https://explorer.celo.org)</li><li>[https://celoscan.io](https://celoscan.io)</li></ul>                                                                               |
 | Bridge Link                | [List of bridges](/developer/bridges/bridges)                                                                                                                                                             |
 
@@ -32,7 +32,7 @@ Overview of Celo Mainnet and the Celo Sepolia Testnet.
 | Description                | The New Developer Testnet network (replacing Alfajores)                                                                                                  |
 | Chain ID                   | 11142220                                                                                                                                                 |
 | Currency Symbol            | CELO                                                                                                                                                     |
-| RPC Nodes                  | [List of RPC providers](/tooling/nodes/overview#as-a-service)                                                                                            |
+| RPC Nodes                  | [List of RPC providers](/build/tools/nodes/overview#as-a-service)                                                                                            |
 | RPC Endpoint (best effort) | [https://forno.celo-sepolia.celo-testnet.org](https://forno.celo-sepolia.celo-testnet.org)                                                               |
 | OP-Node RPC Endpoint (best effort) | [https://op.celo-sepolia.celo-testnet.org](https://op.celo-sepolia.celo-testnet.org)                                                               |
 | Block Explorer             | [https://celo-sepolia.blockscout.com](https://celo-sepolia.blockscout.com)                                                                             |
diff --git a/learn/protocol/index.mdx b/learn/protocol/index.mdx
index b7305d7c48..1fb197ca5d 100644
--- a/learn/protocol/index.mdx
+++ b/learn/protocol/index.mdx
@@ -21,11 +21,11 @@ The full specification of these mechanisms — transaction types, fee rules, fin
 Celo keeps two fee properties that shape everything built on it:
 
 - **Fees stay below a cent.** The protocol configures the OP Stack's L1 and operator fee components to zero and relies on EigenDA's low data costs, so a typical transaction costs less than $0.01 — the mechanics are specified in [Transaction fees](/operate/specification/transaction-fees).
-- **Gas can be paid in stablecoins.** [Fee abstraction](/build-on-celo/fee-abstraction/overview) is implemented at the node level — not through paymasters or relayers — so any externally owned account can pay gas in USDm, USDC, USDT, or another allowlisted currency using a [CIP-64 transaction](/operate/specification/transaction-types). A user or an AI agent can hold nothing but dollars and still transact.
+- **Gas can be paid in stablecoins.** [Fee abstraction](/build/fee-abstraction/overview) is implemented at the node level — not through paymasters or relayers — so any externally owned account can pay gas in USDm, USDC, USDT, or another allowlisted currency using a [CIP-64 transaction](/operate/specification/transaction-types). A user or an AI agent can hold nothing but dollars and still transact.
 
 ## Stablecoins
 
-Stable value is a protocol-era concern on Celo rather than an afterthought. [Mento](https://www.mento.org/), the stablecoin protocol that began as part of Celo's core contracts, issues USDm, EURm, and a family of [local-currency stablecoins](/build-on-celo/build-with-local-stablecoin), alongside third-party issues like USDC and USDT. Because of fee abstraction, these are not just assets on the chain — they are the currencies the chain itself accepts for gas.
+Stable value is a protocol-era concern on Celo rather than an afterthought. [Mento](https://www.mento.org/), the stablecoin protocol that began as part of Celo's core contracts, issues USDm, EURm, and a family of [local-currency stablecoins](/build/build-with-local-stablecoin), alongside third-party issues like USDC and USDT. Because of fee abstraction, these are not just assets on the chain — they are the currencies the chain itself accepts for gas.
 
 ## Staking, epochs, and rewards
 
@@ -37,16 +37,16 @@ Every meaningful parameter of the protocol — from fee currencies to contract u
 
 ## Identity
 
-Celo's original mission — payments that work on a phone — left it with an identity layer most chains lack. [SocialConnect](/build-on-celo/build-on-minipay/overview) maps phone numbers to addresses privately through ODIS, which is what lets MiniPay users send stablecoins to a contact instead of a hex string. [Self](/build-on-celo/build-with-self) brings zero-knowledge proofs of personhood, age, and nationality on-chain, and the [ERC-8004 trust registries](/build-on-celo/build-with-ai/8004) extend the same model to AI agents.
+Celo's original mission — payments that work on a phone — left it with an identity layer most chains lack. [SocialConnect](/build/mini-apps/overview) maps phone numbers to addresses privately through ODIS, which is what lets MiniPay users send stablecoins to a contact instead of a hex string. [Self](/build/build-with-self) brings zero-knowledge proofs of personhood, age, and nationality on-chain, and the [ERC-8004 trust registries](/build/agents/8004) extend the same model to AI agents.
 
 ## What the protocol is optimized for
 
-Put together — sub-cent fees, 1-second blocks, gas in stablecoins, phone-number identity, proof-of-human — the protocol is built for two audiences: **people using mobile-first apps** like MiniPay's 10M+ activated wallets, and **AI agents** that pay, get paid, and prove who stands behind them using [x402, ERC-8004, and the rest of the agent stack](/build-on-celo/build-with-ai/overview).
+Put together — sub-cent fees, 1-second blocks, gas in stablecoins, phone-number identity, proof-of-human — the protocol is built for two audiences: **people using mobile-first apps** like MiniPay's 10M+ activated wallets, and **AI agents** that pay, get paid, and prove who stands behind them using [x402, ERC-8004, and the rest of the agent stack](/build/agents/overview).
 
 ## Related
 
 - [Celo's L2 architecture](/learn/network/architecture) - The OP Stack layout in detail
 - [Specification](/operate/specification/index) - The normative protocol specification
-- [Fee abstraction](/build-on-celo/fee-abstraction/overview) - Pay gas in stablecoins
+- [Fee abstraction](/build/fee-abstraction/overview) - Pay gas in stablecoins
 - [Governance](/learn/protocol/governance/overview) - How the protocol changes
 - [Network overview](/learn/network/overview) - Chain IDs, RPCs, explorers
diff --git a/learn/protocol/metadata.mdx b/learn/protocol/metadata.mdx
index 2adc936d5f..fbabf933ab 100644
--- a/learn/protocol/metadata.mdx
+++ b/learn/protocol/metadata.mdx
@@ -36,7 +36,7 @@ The following types of claim are supported:
 
 ## Handling metadata
 
-You can interact with metadata files through the [CLI](/tooling/libraries-sdks/cli/account). Most commands require an RPC node to make view calls, and to modify metadata files, you'll need the relevant account to be unlocked to sign the files.
+You can interact with metadata files through the [CLI](/build/tools/libraries-sdks/cli/account). Most commands require an RPC node to make view calls, and to modify metadata files, you'll need the relevant account to be unlocked to sign the files.
 
 You can create an empty metadata file with:
 
@@ -66,4 +66,4 @@ celocli account:get-metadata $ACCOUNT_ADDRESS
 
 - [Registering a community RPC provider](/contribute-to-celo/community-rpc-nodes/registering-as-rpc-node) - the RPC URL claim in the registration flow
 - [Validator groups](/learn/protocol/staking/validator-groups) - why groups publish identity claims
-- [celocli account commands](/tooling/libraries-sdks/cli/account) - the full command reference
+- [celocli account commands](/build/tools/libraries-sdks/cli/account) - the full command reference
diff --git a/learn/protocol/transactions/overview.mdx b/learn/protocol/transactions/overview.mdx
index 09951447d9..ee82a65924 100644
--- a/learn/protocol/transactions/overview.mdx
+++ b/learn/protocol/transactions/overview.mdx
@@ -28,7 +28,7 @@ gas currencies incur approximately 50,000 additional gas units.
 Celo allows paying gas fees in currencies other than the native currency. The tokens that can be
 used to pay gas fees are controlled via governance and the list of tokens allowed is maintained in
 FeeCurrencyDirectory.sol. Fee abstraction on Celo works with EOAs. No paymaster required! Learn all
-about [fee abstraction](/build-on-celo/fee-abstraction/overview).
+about [fee abstraction](/build/fee-abstraction/overview).
 
 ## Transaction Fee Allocation Post-L2 Transition
 
diff --git a/learn/wallets.mdx b/learn/wallets.mdx
index 4b695c6a96..4a90df82fb 100644
--- a/learn/wallets.mdx
+++ b/learn/wallets.mdx
@@ -5,15 +5,15 @@ description: Choose a wallet to hold and send CELO and Celo stablecoins, connect
 
 import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx';
 
-This page helps people who hold CELO or Celo stablecoins choose a wallet. App developers adding wallets to an app should see [Wallet integration](/tooling/wallets).
+This page helps people who hold CELO or Celo stablecoins choose a wallet. App developers adding wallets to an app should see [Wallet integration](/build/tools/wallets).
 
 ## Choosing a wallet
 
 Celo works with a range of wallets, each offering features to meet different user needs.
 
-The [Celo native wallets](#celo-native-wallets) section provides an overview of wallets that are optimized for the Celo network. These wallets allow users to fully benefit from Celo’s native functionalities, such as [phone number mapping](/build-on-celo/build-on-socialconnect) and [fee abstraction](/build-on-celo/fee-abstraction/overview).
+The [Celo native wallets](#celo-native-wallets) section provides an overview of wallets that are optimized for the Celo network. These wallets allow users to fully benefit from Celo’s native functionalities, such as [phone number mapping](/build/build-on-socialconnect) and [fee abstraction](/build/fee-abstraction/overview).
 
-Some wallets charge gas in CELO even if you hold stablecoins; see [which wallets can pay gas in stablecoins](/build-on-celo/fee-abstraction/overview#wallet-support-for-cip-64).
+Some wallets charge gas in CELO even if you hold stablecoins; see [which wallets can pay gas in stablecoins](/build/fee-abstraction/overview#wallet-support-for-cip-64).
 
 The [Celo compatible wallets](#celo-compatible-wallets) section provides an overview of commonly used wallets that support the Celo network.
 
@@ -53,7 +53,7 @@ Celo Terminal is a wallet and app platform designed as a hub for managing and ru
 - Homepage: [celoterminal.com](https://celoterminal.com)
 - Platforms: MacOS, Linux, Windows
 - Maintainers: [WOTrust](https://x.com/wotrust1)
-- Hardware wallet support: Yes (Note: [EIP-712 signing requires workaround](/tooling/wallets/ledger/eip712-workaround))
+- Hardware wallet support: Yes (Note: [EIP-712 signing requires workaround](/build/tools/wallets/ledger/eip712-workaround))
 - [Source Code](https://github.com/zviadm/celoterminal)
 
 ---
@@ -64,17 +64,17 @@ Celo Terminal is a wallet and app platform designed as a hub for managing and ru
 
 ### [Ledger](https://www.ledger.com/)
 
-Ledger is a hardware wallet. Ledger Live supports CELO and Celo stablecoins, and its send flow can pay gas in a Celo fee currency of the user's choice. App transactions signed with a Ledger through MetaMask are not CIP-64, because MetaMask drops `feeCurrency`; see [wallet support for CIP-64](/build-on-celo/fee-abstraction/overview#wallet-support-for-cip-64) for the supported versions.
+Ledger is a hardware wallet. Ledger Live supports CELO and Celo stablecoins, and its send flow can pay gas in a Celo fee currency of the user's choice. App transactions signed with a Ledger through MetaMask are not CIP-64, because MetaMask drops `feeCurrency`; see [wallet support for CIP-64](/build/fee-abstraction/overview#wallet-support-for-cip-64) for the supported versions.
 
 - [Homepage](https://www.ledger.com/)
-- Guides: [set up a Ledger with Celo](/tooling/wallets/ledger/setup), connect it to [Celo Terminal](/tooling/wallets/ledger/to-celo-terminal), the [Celo web wallet](/tooling/wallets/ledger/to-celo-web) or the [Celo CLI](/tooling/wallets/ledger/to-celo-cli), and the [EIP-712 signing workaround](/tooling/wallets/ledger/eip712-workaround)
+- Guides: [set up a Ledger with Celo](/build/tools/wallets/ledger/setup), connect it to [Celo Terminal](/build/tools/wallets/ledger/to-celo-terminal), the [Celo web wallet](/build/tools/wallets/ledger/to-celo-web) or the [Celo CLI](/build/tools/wallets/ledger/to-celo-cli), and the [EIP-712 signing workaround](/build/tools/wallets/ledger/eip712-workaround)
 - Platforms: Ledger Live (desktop, mobile) with a Ledger device
 
 ---
 
 ## Celo compatible wallets
 
-Here’s an overview of popular wallets compatible with the Celo network. Not all of them support [fee abstraction](/build-on-celo/fee-abstraction/overview#wallet-support-for-cip-64), so gas may be charged in CELO.
+Here’s an overview of popular wallets compatible with the Celo network. Not all of them support [fee abstraction](/build/fee-abstraction/overview#wallet-support-for-cip-64), so gas may be charged in CELO.
 
 ### [Rabby](https://rabby.io/)
 
@@ -90,7 +90,7 @@ Your go-to wallet for Ethereum and EVM - Track portfolio across all EVM chains i
 MetaMask is a self-custody wallet with support for Celo.
 
 - [Homepage](https://metamask.io/)
-- Guides: add Celo [mainnet](/learn/network/overview) or [testnet](/tooling/wallets/metamask/add-celo-testnet-to-metamask) to MetaMask, and [use MetaMask with Celo](/tooling/wallets/metamask/use)
+- Guides: add Celo [mainnet](/learn/network/overview) or [testnet](/build/tools/wallets/metamask/add-celo-testnet-to-metamask) to MetaMask, and [use MetaMask with Celo](/build/tools/wallets/metamask/use)
 - Platforms: [Browser](https://chromewebstore.google.com/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn), [iOS](https://apps.apple.com/us/app/metamask-blockchain-wallet/id1438144202), [Android](https://play.google.com/store/apps/details?id=io.metamask)
 
 ---
@@ -192,7 +192,7 @@ Celo has no usernames or passwords. A wallet is controlled by its recovery phras
 
 ### A token does not appear in your wallet
 
-Check that the wallet is on the Celo network, then add the token by its contract address. Stablecoin addresses are listed in [stablecoin contracts](/tooling/contracts/stablecoin-contracts); use the Celo Mainnet column. Tokens sent on another network do not show up on Celo.
+Check that the wallet is on the Celo network, then add the token by its contract address. Stablecoin addresses are listed in [stablecoin contracts](/build/tools/contracts/stablecoin-contracts); use the Celo Mainnet column. Tokens sent on another network do not show up on Celo.
 
 ### Move funds in or out
 
@@ -204,5 +204,5 @@ Which providers work in your country depends on the provider. Check availability
 
 ## Related
 
-- [Wallet integration](/tooling/wallets) — for app developers adding wallets to an app
-- [Fee abstraction](/build-on-celo/fee-abstraction/overview) — how gas is paid in stablecoins, and which wallets support it
+- [Wallet integration](/build/tools/wallets) — for app developers adding wallets to an app
+- [Fee abstraction](/build/fee-abstraction/overview) — how gas is paid in stablecoins, and which wallets support it
diff --git a/operate/index.mdx b/operate/index.mdx
index 892a14a6cd..d5aa496382 100644
--- a/operate/index.mdx
+++ b/operate/index.mdx
@@ -83,5 +83,5 @@ Celo has replaced `op-geth` with `op-reth` as its execution client. See [End of
 ## Related
 
 - [Network information](/learn/network/overview) — chain IDs, RPC URLs, explorers, and the faucet for Celo mainnet and Celo Sepolia.
-- [Nodes and services](/tooling/nodes/overview) — hosted RPC providers and Forno, for readers who need an endpoint rather than their own node.
+- [Nodes and services](/build/tools/nodes/overview) — hosted RPC providers and Forno, for readers who need an endpoint rather than their own node.
 - [Operating a community RPC node](/contribute-to-celo/community-rpc-nodes/community-rpc-node) — run a registered node that serves a public endpoint and earns rewards.
diff --git a/operate/notices/archive/celo-sepolia-launch.mdx b/operate/notices/archive/celo-sepolia-launch.mdx
index 9ccafe0b48..46b9b6b9ac 100644
--- a/operate/notices/archive/celo-sepolia-launch.mdx
+++ b/operate/notices/archive/celo-sepolia-launch.mdx
@@ -55,7 +55,7 @@ Since Celo Sepolia starts with a clean slate, there is no historical data or con
 - Chain ID: 11142220
 - L1 Foundation: Ethereum Sepolia
 - EigenDA: v2 (Blazar)
-- Contracts: [see the L1 and L2 contracts in the specification](/tooling/contracts/core-contracts#celo-sepolia-testnet)
+- Contracts: [see the L1 and L2 contracts in the specification](/build/tools/contracts/core-contracts#celo-sepolia-testnet)
 - RPC endpoint: [Celo Sepolia Forno](https://forno.celo-sepolia.celo-testnet.org)
 - Block explorer: [Blockscout](https://celo-sepolia.blockscout.com)
 - Faucets:
diff --git a/operate/specification/deployments.mdx b/operate/specification/deployments.mdx
index 4e2f4c99b0..0b70fcc530 100644
--- a/operate/specification/deployments.mdx
+++ b/operate/specification/deployments.mdx
@@ -25,9 +25,9 @@ The Celo L2 network has the following chain properties:
 
 L1 and L2 contract addresses are listed in the documentation.
 
-- [L1 contracts](/tooling/contracts/l1-contracts#celo-mainnet)
-- [Core contracts](/tooling/contracts/core-contracts#celo-mainnet)
-- [Fee currencies](/tooling/contracts/fee-currencies#celo-mainnet)
+- [L1 contracts](/build/tools/contracts/l1-contracts#celo-mainnet)
+- [Core contracts](/build/tools/contracts/core-contracts#celo-mainnet)
+- [Fee currencies](/build/tools/contracts/fee-currencies#celo-mainnet)
 
 ## Celo Sepolia testnet
 
@@ -44,9 +44,9 @@ The Celo Sepolia testnet has the same chain properties as Celo Mainnet:
 
 L1 and L2 contract addresses are listed in the documentation.
 
-- [L1 contracts](/tooling/contracts/l1-contracts#celo-sepolia-testnet)
-- [Core contracts](/tooling/contracts/core-contracts#celo-sepolia-testnet)
-- [Fee currencies](/tooling/contracts/fee-currencies#celo-sepolia-testnet)
+- [L1 contracts](/build/tools/contracts/l1-contracts#celo-sepolia-testnet)
+- [Core contracts](/build/tools/contracts/core-contracts#celo-sepolia-testnet)
+- [Fee currencies](/build/tools/contracts/fee-currencies#celo-sepolia-testnet)
 
 ## OP stack config
 
diff --git a/operate/specification/fee-abstraction.mdx b/operate/specification/fee-abstraction.mdx
index 7e45fbe663..bf9f9ff2f4 100644
--- a/operate/specification/fee-abstraction.mdx
+++ b/operate/specification/fee-abstraction.mdx
@@ -4,7 +4,7 @@ sidebarTitle: "Fee Abstraction"
 description: How Celo lets users pay gas in ERC20 tokens instead of native CELO
 ---
 
-This page is the protocol specification of fee abstraction. To pay gas in a token from an app, see the [fee abstraction guide](/build-on-celo/fee-abstraction/overview). For token and adapter addresses, see [Fee currency contracts](/tooling/contracts/fee-currencies).
+This page is the protocol specification of fee abstraction. To pay gas in a token from an app, see the [fee abstraction guide](/build/fee-abstraction/overview). For token and adapter addresses, see [Fee currency contracts](/build/tools/contracts/fee-currencies).
 
 Fee Abstraction is a Celo feature that allows users to send transactions without spending any native CELO tokens. Instead, ERC20 tokens are used to pay for the transaction's gas cost.
 
diff --git a/scripts/README.md b/scripts/README.md
index 331b378aed..e4350b6ea4 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -10,17 +10,17 @@ This directory contains utility scripts for maintaining and updating the Celo do
 
 | Page | Source |
 | ---- | ------ |
-| `tooling/contracts/core-contracts.mdx` | `celocli network:contracts` |
-| `tooling/contracts/l1-contracts.mdx` | rollup config files + `cast` |
-| `tooling/contracts/fee-currencies.mdx` | `FeeCurrencyDirectory.getCurrencies()` via `cast` |
-| `tooling/contracts/stablecoin-contracts.mdx` | the fee-currency allowlist + `data/stablecoins.json` |
+| `build/tools/contracts/core-contracts.mdx` | `celocli network:contracts` |
+| `build/tools/contracts/l1-contracts.mdx` | rollup config files + `cast` |
+| `build/tools/contracts/fee-currencies.mdx` | `FeeCurrencyDirectory.getCurrencies()` via `cast` |
+| `build/tools/contracts/stablecoin-contracts.mdx` | the fee-currency allowlist + `data/stablecoins.json` |
 
 Do not edit those four files by hand — change the generator instead. The page bodies live in
 the `PAGE_HEADER_*` constants near the top of `update_contracts.py`.
 
 ## Data
 
-- `data/stablecoins.json` - Curated input for `tooling/contracts/stablecoin-contracts.mdx`.
+- `data/stablecoins.json` - Curated input for `build/tools/contracts/stablecoin-contracts.mdx`.
   Mento stablecoins plus USDC, USD₮ and USA₮ are read from the on-chain fee-currency
   allowlist; third-party issuers have no registry to read from, so they are maintained by
   hand here, along with issuer attribution and any display-symbol overrides.
diff --git a/scripts/data/stablecoins.json b/scripts/data/stablecoins.json
index 5e478e9def..d2b5297702 100644
--- a/scripts/data/stablecoins.json
+++ b/scripts/data/stablecoins.json
@@ -1,5 +1,5 @@
 {
-  "_note": "Curated input for tooling/contracts/stablecoin-contracts.mdx. Mento tokens plus USDC and USDT are read from the on-chain fee-currency allowlist by scripts/update_contracts.py; everything in this file has no registry to read from and must be maintained by hand.",
+  "_note": "Curated input for build/tools/contracts/stablecoin-contracts.mdx. Mento tokens plus USDC and USDT are read from the on-chain fee-currency allowlist by scripts/update_contracts.py; everything in this file has no registry to read from and must be maintained by hand.",
 
   "issuers": {
     "_note": "Issuer attribution for the allowlisted stablecoins. _default covers the Mento tokens.",
diff --git a/scripts/update_contracts.py b/scripts/update_contracts.py
index 5c4c71e82f..c49cd99d70 100644
--- a/scripts/update_contracts.py
+++ b/scripts/update_contracts.py
@@ -98,13 +98,13 @@
 [comment]: <> (DO NOT EDIT THIS FILE MANUALLY)
 [comment]: <> (Autogenerated by `scripts/update_contracts.py`)
 
-This page is the contract reference for fee currencies: the tokens currently on the governable on-chain allowlist, read from the `FeeCurrencyDirectory` core contract, with their `feeCurrency` and token addresses. To pay gas in one of them, see the [fee abstraction guide](/build-on-celo/fee-abstraction/overview). For how the protocol handles fee currencies, see the [fee abstraction specification](/operate/specification/fee-abstraction).
+This page is the contract reference for fee currencies: the tokens currently on the governable on-chain allowlist, read from the `FeeCurrencyDirectory` core contract, with their `feeCurrency` and token addresses. To pay gas in one of them, see the [fee abstraction guide](/build/fee-abstraction/overview). For how the protocol handles fee currencies, see the [fee abstraction specification](/operate/specification/fee-abstraction).
 
 <Note>
-This is not a list of every token on Celo. For stablecoin addresses, see [Stablecoin Contracts](/tooling/contracts/stablecoin-contracts). For an overview of Celo's stablecoin ecosystem, see [Build with Local Stablecoins](/build-on-celo/build-with-local-stablecoin).
+This is not a list of every token on Celo. For stablecoin addresses, see [Stablecoin Contracts](/build/tools/contracts/stablecoin-contracts). For an overview of Celo's stablecoin ecosystem, see [Build with Local Stablecoins](/build/build-with-local-stablecoin).
 </Note>
 
-Pass the **feeCurrency address** as the `feeCurrency` field on a transaction, and use the **token address** when transferring the token itself. The two differ for tokens that do not use 18 decimals — such as USDC, USD₮ and USA₮ — which are allowlisted through an adapter. See [Adapters for Non-18-Decimal Tokens](/build-on-celo/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens).
+Pass the **feeCurrency address** as the `feeCurrency` field on a transaction, and use the **token address** when transferring the token itself. The two differ for tokens that do not use 18 decimals — such as USDC, USD₮ and USA₮ — which are allowlisted through an adapter. See [Adapters for Non-18-Decimal Tokens](/build/fee-abstraction/using-fee-abstraction#adapters-for-non-18-decimal-tokens).
 
 ---
 """.strip()
@@ -119,7 +119,7 @@
 [comment]: <> (DO NOT EDIT THIS FILE MANUALLY)
 [comment]: <> (Autogenerated by `scripts/update_contracts.py`)
 
-Contract addresses for stablecoins on Celo Mainnet and the Celo Sepolia Testnet. For an overview of the ecosystem these assets belong to, see [Build with Local Stablecoins](/build-on-celo/build-with-local-stablecoin). To find out which of them can also pay gas fees, see [Fee Currencies](/tooling/contracts/fee-currencies).
+Contract addresses for stablecoins on Celo Mainnet and the Celo Sepolia Testnet. For an overview of the ecosystem these assets belong to, see [Build with Local Stablecoins](/build/build-with-local-stablecoin). To find out which of them can also pay gas fees, see [Fee Currencies](/build/tools/contracts/fee-currencies).
 
 <Note>
 These addresses are listed for convenience and do not imply any endorsement of the issuer or the asset. Verify an address against a block explorer before using it in production.
@@ -425,7 +425,7 @@ def main():
         )
 
     print("Fetching core contract data from celocli...")
-    with Path("tooling/contracts/core-contracts.mdx").open("w") as f:
+    with Path("build/tools/contracts/core-contracts.mdx").open("w") as f:
         f.write(PAGE_HEADER_CORE_CONTRACTS)
 
         for network, data in NETWORKS.items():
@@ -451,7 +451,7 @@ def main():
         print(f"> Reading fee currencies for {network}...")
         fee_currencies[network] = get_fee_currencies(network, symbol_overrides)
 
-    with Path("tooling/contracts/fee-currencies.mdx").open("w") as f:
+    with Path("build/tools/contracts/fee-currencies.mdx").open("w") as f:
         f.write(PAGE_HEADER_FEE_CURRENCIES)
 
         for network, data in NETWORKS.items():
@@ -459,13 +459,13 @@ def main():
             f.write(fee_currencies_to_markdown(fee_currencies[network], network))
 
     print("Building stablecoin contract page...")
-    with Path("tooling/contracts/stablecoin-contracts.mdx").open("w") as f:
+    with Path("build/tools/contracts/stablecoin-contracts.mdx").open("w") as f:
         f.write(PAGE_HEADER_STABLECOIN_CONTRACTS)
         f.write("\n\n")
         f.write(stablecoins_to_markdown(fee_currencies, stablecoin_data))
 
     print("Fetching L1 contract data...")
-    with Path("tooling/contracts/l1-contracts.mdx").open("w") as f:
+    with Path("build/tools/contracts/l1-contracts.mdx").open("w") as f:
         f.write(PAGE_HEADER_L1_CONTRACTS)
 
         for network, data in NETWORKS.items():
diff --git a/tooling/libraries-sdks/celo-sdks.mdx b/tooling/libraries-sdks/celo-sdks.mdx
deleted file mode 100644
index 4ecfe6b9df..0000000000
--- a/tooling/libraries-sdks/celo-sdks.mdx
+++ /dev/null
@@ -1,24 +0,0 @@
----
-title: Celo Libraries & SDKs
-description: List of Celo libraries & SDKs
-sidebarTitle: "Overview"
----
-
-
-Because Celo is compatible with Ethereum any ethereum package can be used with Celo. Packages with specific support for Celo include:
-
----
-
-## Web3 Libraries
-
-- [viem](/tooling/libraries-sdks/viem)
-- [ethers](/tooling/libraries-sdks/ethers)
-- [thirdweb](/tooling/dev-environments/thirdweb)
-- [ContractKit (deprecated - only for internal use)](/tooling/libraries-sdks/contractkit)
-- [web3.js (deprecated)](/tooling/libraries-sdks/web3)
-
-## Wallet Libraries
-
-- [Reown](/tooling/libraries-sdks/reown)
-- [Portal](/tooling/libraries-sdks/portal)
-- [JAW](/tooling/libraries-sdks/jaw)

From 59ef059d659bd3907afeb2768955d8705c8842a8 Mon Sep 17 00:00:00 2001
From: GigaHierz <lenahierzi@hotmail.de>
Date: Tue, 6 Oct 2026 11:22:22 +0100
Subject: [PATCH 2/2] docs: restore the old /build redirects and order wildcard
 redirects by specificity

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 build/agents/vibe-coding.mdx |   2 +-
 build/fund-your-project.mdx  |   2 +-
 docs.json                    | 430 ++++++++++++++++++++---------------
 3 files changed, 251 insertions(+), 183 deletions(-)

diff --git a/build/agents/vibe-coding.mdx b/build/agents/vibe-coding.mdx
index 981b2482ed..fbb4c70b9d 100644
--- a/build/agents/vibe-coding.mdx
+++ b/build/agents/vibe-coding.mdx
@@ -106,4 +106,4 @@ Tools that help you gather and process information effectively, mainly MCPs. Add
 
 ## Additional Resources
 
-- [MCP Server Guide](/build/build-with-ai/mcp/index) - Learn more about MCP integration
+- [MCP Server Guide](/build/agents/mcp/index) - Learn more about MCP integration
diff --git a/build/fund-your-project.mdx b/build/fund-your-project.mdx
index 254cb7734a..9e527ba50e 100644
--- a/build/fund-your-project.mdx
+++ b/build/fund-your-project.mdx
@@ -23,7 +23,7 @@ There are various grant opportunities for builders in the Celo ecosystem, with f
 
 1.  **[Verda Ventures](https://verda.ventures/)**: Building for MiniPay & raising funding? Reach out to [team@verda.ventures](mailto:team@verda.ventures) with a deck and product demo.
 
-If you want to add another ecosystem-led funding program, [edit this page](https://github.com/celo-org/docs/edit/main/build-on-celo/fund-your-project.mdx) to include it.
+If you want to add another ecosystem-led funding program, [edit this page](https://github.com/celo-org/docs/edit/main/build/fund-your-project.mdx) to include it.
 
 ## Get Funding Updates
 
diff --git a/docs.json b/docs.json
index 1fa58f1d93..1b82ca0c13 100644
--- a/docs.json
+++ b/docs.json
@@ -596,49 +596,269 @@
   },
   "redirects": [
     {
-      "source": "/build-on-celo/attribution-tags",
-      "destination": "/build/agents/attribution-tags"
+      "source": "/tooling/libraries-sdks/particle-network/:slug*",
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
     },
     {
-      "source": "/build-on-celo",
-      "destination": "/build"
+      "source": "/what-is-celo/using-celo/bridged_tokens/:slug*",
+      "destination": "/learn/bridged-tokens/:slug*"
     },
     {
-      "source": "/build-on-celo/build-with-ai/:slug*",
-      "destination": "/build/agents/:slug*"
+      "source": "/build/build-with-ai/build-with-goat/:slug*",
+      "destination": "/build/agents/overview"
+    },
+    {
+      "source": "/build-on-celo/build-with-ai/celina/:slug*",
+      "destination": "/build/agents/mcp/celina"
+    },
+    {
+      "source": "/what-is-celo/using-celo/protocol/:slug*",
+      "destination": "/learn/protocol/:slug*"
     },
     {
       "source": "/build-on-celo/build-on-minipay/:slug*",
       "destination": "/build/mini-apps/overview"
     },
     {
-      "source": "/build/build-with-ai/:slug*",
+      "source": "/what-is-celo/using-celo/manage/:slug*",
+      "destination": "/learn/manage/:slug*"
+    },
+    {
+      "source": "/build/build-with-ai/examples/:slug*",
+      "destination": "/build/agents/overview"
+    },
+    {
+      "source": "/build-on-celo/build-with-ai/:slug*",
       "destination": "/build/agents/:slug*"
     },
+    {
+      "source": "/developer/particle-network/:slug*",
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
+    },
+    {
+      "source": "/what-is-celo/about-celo-l1/:slug*",
+      "destination": "/learn/celo-l1"
+    },
+    {
+      "source": "/home/protocol/transaction/:slug*",
+      "destination": "/learn/protocol/transactions/:slug*"
+    },
+    {
+      "source": "/developer/rainbowkit-celo/:slug*",
+      "destination": "/build/tools/libraries-sdks/celo-sdks"
+    },
+    {
+      "source": "/what-is-celo/joining-celo/:slug*",
+      "destination": "/contribute-to-celo/:slug*"
+    },
     {
       "source": "/build/build-on-minipay/:slug*",
       "destination": "/build/mini-apps/overview"
     },
     {
-      "source": "/tooling",
-      "destination": "/build/tools/overview"
+      "source": "/developer/thirdweb-sdk/:slug*",
+      "destination": "/build/tools/dev-environments/thirdweb"
     },
     {
-      "source": "/tooling/:slug*",
-      "destination": "/build/tools/:slug*"
+      "source": "/developer/contractkit/:slug*",
+      "destination": "/build/tools/libraries-sdks/contractkit/:slug*"
+    },
+    {
+      "source": "/network/celo-sepolia/:slug*",
+      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
+    },
+    {
+      "source": "/build/build-with-ai/:slug*",
+      "destination": "/build/agents/:slug*"
+    },
+    {
+      "source": "/developer/explorers/:slug*",
+      "destination": "/build/tools/explorers/:slug*"
+    },
+    {
+      "source": "/community/celo-sage/:slug*",
+      "destination": "/contribute-to-celo/contributors/documentation-contributors"
+    },
+    {
+      "source": "/developer/indexers/:slug*",
+      "destination": "/build/tools/indexers/:slug*"
+    },
+    {
+      "source": "/developer/oracles/:slug*",
+      "destination": "/build/tools/oracles/:slug*"
+    },
+    {
+      "source": "/developer/bridges/:slug*",
+      "destination": "/build/tools/bridges/:slug*"
+    },
+    {
+      "source": "/developer/migrate/:slug*",
+      "destination": "/build/tools/overview/:slug*"
+    },
+    {
+      "source": "/developer/dynamic/:slug*",
+      "destination": "/build/tools/libraries-sdks/dynamic/:slug*"
+    },
+    {
+      "source": "/network/alfajores/:slug*",
+      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
+    },
+    {
+      "source": "/protocol/bridging/:slug*",
+      "destination": "/build/tools/bridges/bridges"
+    },
+    {
+      "source": "/developer/deploy/:slug*",
+      "destination": "/build/tools/dev-environments/:slug*"
+    },
+    {
+      "source": "/developer/verify/:slug*",
+      "destination": "/build/tools/contract-verification/:slug*"
+    },
+    {
+      "source": "/developer/ethers/:slug*",
+      "destination": "/build/tools/libraries-sdks/ethers/:slug*"
+    },
+    {
+      "source": "/developer/portal/:slug*",
+      "destination": "/build/tools/libraries-sdks/portal/:slug*"
+    },
+    {
+      "source": "/developer/setup/:slug*",
+      "destination": "/build/tools/overview/:slug*"
+    },
+    {
+      "source": "/developer/reown/:slug*",
+      "destination": "/build/tools/libraries-sdks/reown/:slug*"
+    },
+    {
+      "source": "/network/baklava/:slug*",
+      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
+    },
+    {
+      "source": "/network/mainnet/:slug*",
+      "destination": "/learn/network/overview"
+    },
+    {
+      "source": "/protocol/bridge/:slug*",
+      "destination": "/build/tools/bridges/bridges"
+    },
+    {
+      "source": "/developer/sdks/:slug*",
+      "destination": "/build/tools/libraries-sdks/:slug*"
+    },
+    {
+      "source": "/developer/viem/:slug*",
+      "destination": "/build/tools/libraries-sdks/viem/:slug*"
+    },
+    {
+      "source": "/developer/web3/:slug*",
+      "destination": "/build/tools/libraries-sdks/web3/:slug*"
+    },
+    {
+      "source": "/network/eclair/:slug*",
+      "destination": "/build/tools/testnets/celo-sepolia"
+    },
+    {
+      "source": "/infra-partners/:slug*",
+      "destination": "/operate/:slug*"
     },
     {
       "source": "/build-on-celo/:slug*",
       "destination": "/build/:slug*"
     },
     {
-      "source": "/home",
-      "destination": "/learn"
+      "source": "/network/node/:slug*",
+      "destination": "/build/tools/nodes/:slug*"
+    },
+    {
+      "source": "/integration/:slug*",
+      "destination": "/operate/operators/overview"
+    },
+    {
+      "source": "/about-celo/:slug*",
+      "destination": "/learn/:slug*"
+    },
+    {
+      "source": "/contracts/:slug*",
+      "destination": "/build/tools/contracts/:slug*"
+    },
+    {
+      "source": "/tooling/:slug*",
+      "destination": "/build/tools/:slug*"
+    },
+    {
+      "source": "/wallet/:slug*",
+      "destination": "/build/tools/wallets/:slug*"
+    },
+    {
+      "source": "/bridge/:slug*",
+      "destination": "/build/tools/bridges/bridges"
+    },
+    {
+      "source": "/specs/:slug*",
+      "destination": "/operate/specification/:slug*"
     },
     {
       "source": "/home/:slug*",
       "destination": "/learn/:slug*"
     },
+    {
+      "source": "/blog/:slug*",
+      "destination": "/build"
+    },
+    {
+      "source": "/cli/:slug*",
+      "destination": "/build/tools/libraries-sdks/cli/:slug*"
+    },
+    {
+      "source": "/build/build-with-ai/multi-agent-systems",
+      "destination": "/build/agents/overview"
+    },
+    {
+      "source": "/build/build-with-ai/resources",
+      "destination": "/build/agents/overview"
+    },
+    {
+      "source": "/build/build-with-ai/tools",
+      "destination": "/build/agents/overview"
+    },
+    {
+      "source": "/build/build-with-ai/mcp/composer-mcp",
+      "destination": "/build/agents/mcp/index"
+    },
+    {
+      "source": "/build/build-with-zk-identity",
+      "destination": "/build/build-with-self"
+    },
+    {
+      "source": "/build/cel2-architecture",
+      "destination": "/learn/network/architecture"
+    },
+    {
+      "source": "/build/network-overview",
+      "destination": "/learn/network/overview"
+    },
+    {
+      "source": "/build/attribution-tags",
+      "destination": "/build/agents/attribution-tags"
+    },
+    {
+      "source": "/build-on-celo/attribution-tags",
+      "destination": "/build/agents/attribution-tags"
+    },
+    {
+      "source": "/build-on-celo",
+      "destination": "/build"
+    },
+    {
+      "source": "/tooling",
+      "destination": "/build/tools/overview"
+    },
+    {
+      "source": "/home",
+      "destination": "/learn"
+    },
     {
       "source": "/build-on-celo/network-overview",
       "destination": "/learn/network/overview"
@@ -655,10 +875,6 @@
       "source": "/operate/integration/nightfall",
       "destination": "/build/nightfall"
     },
-    {
-      "source": "/home/protocol/transaction/:slug*",
-      "destination": "/learn/protocol/transactions/:slug*"
-    },
     {
       "source": "/infra-partners/integration/nightfall",
       "destination": "/build/nightfall"
@@ -2883,58 +3099,18 @@
       "source": "/developer/contractkit",
       "destination": "/build/tools/libraries-sdks/contractkit"
     },
-    {
-      "source": "/developer/contractkit/:slug*",
-      "destination": "/build/tools/libraries-sdks/contractkit/:slug*"
-    },
     {
       "source": "/developer/deploy",
       "destination": "/build/tools/dev-environments"
     },
-    {
-      "source": "/developer/deploy/:slug*",
-      "destination": "/build/tools/dev-environments/:slug*"
-    },
     {
       "source": "/developer/verify",
       "destination": "/build/tools/contract-verification"
     },
-    {
-      "source": "/developer/verify/:slug*",
-      "destination": "/build/tools/contract-verification/:slug*"
-    },
-    {
-      "source": "/developer/explorers/:slug*",
-      "destination": "/build/tools/explorers/:slug*"
-    },
     {
       "source": "/developer/oracles",
       "destination": "/build/tools/oracles"
     },
-    {
-      "source": "/developer/oracles/:slug*",
-      "destination": "/build/tools/oracles/:slug*"
-    },
-    {
-      "source": "/developer/indexers/:slug*",
-      "destination": "/build/tools/indexers/:slug*"
-    },
-    {
-      "source": "/developer/bridges/:slug*",
-      "destination": "/build/tools/bridges/:slug*"
-    },
-    {
-      "source": "/developer/setup/:slug*",
-      "destination": "/build/tools/overview/:slug*"
-    },
-    {
-      "source": "/developer/migrate/:slug*",
-      "destination": "/build/tools/overview/:slug*"
-    },
-    {
-      "source": "/developer/sdks/:slug*",
-      "destination": "/build/tools/libraries-sdks/:slug*"
-    },
     {
       "source": "/developer/fee-abstraction",
       "destination": "/build/fee-abstraction/overview"
@@ -2943,46 +3119,6 @@
       "source": "/developer/launch-checklist",
       "destination": "/build/launch-checklist"
     },
-    {
-      "source": "/developer/dynamic/:slug*",
-      "destination": "/build/tools/libraries-sdks/dynamic/:slug*"
-    },
-    {
-      "source": "/developer/ethers/:slug*",
-      "destination": "/build/tools/libraries-sdks/ethers/:slug*"
-    },
-    {
-      "source": "/developer/particle-network/:slug*",
-      "destination": "/build/tools/libraries-sdks/celo-sdks"
-    },
-    {
-      "source": "/tooling/libraries-sdks/particle-network/:slug*",
-      "destination": "/build/tools/libraries-sdks/celo-sdks"
-    },
-    {
-      "source": "/developer/portal/:slug*",
-      "destination": "/build/tools/libraries-sdks/portal/:slug*"
-    },
-    {
-      "source": "/developer/rainbowkit-celo/:slug*",
-      "destination": "/build/tools/libraries-sdks/celo-sdks"
-    },
-    {
-      "source": "/developer/reown/:slug*",
-      "destination": "/build/tools/libraries-sdks/reown/:slug*"
-    },
-    {
-      "source": "/developer/thirdweb-sdk/:slug*",
-      "destination": "/build/tools/dev-environments/thirdweb"
-    },
-    {
-      "source": "/developer/viem/:slug*",
-      "destination": "/build/tools/libraries-sdks/viem/:slug*"
-    },
-    {
-      "source": "/developer/web3/:slug*",
-      "destination": "/build/tools/libraries-sdks/web3/:slug*"
-    },
     {
       "source": "/what-is-celo",
       "destination": "/learn"
@@ -2991,18 +3127,6 @@
       "source": "/what-is-celo/using-celo/protocol",
       "destination": "/learn/protocol"
     },
-    {
-      "source": "/what-is-celo/using-celo/protocol/:slug*",
-      "destination": "/learn/protocol/:slug*"
-    },
-    {
-      "source": "/what-is-celo/using-celo/manage/:slug*",
-      "destination": "/learn/manage/:slug*"
-    },
-    {
-      "source": "/what-is-celo/using-celo/bridged_tokens/:slug*",
-      "destination": "/learn/bridged-tokens/:slug*"
-    },
     {
       "source": "/what-is-celo/using-celo/bridges",
       "destination": "/learn/bridged-tokens/bridges"
@@ -3035,22 +3159,10 @@
       "source": "/what-is-celo/joining-celo",
       "destination": "/contribute-to-celo"
     },
-    {
-      "source": "/what-is-celo/joining-celo/:slug*",
-      "destination": "/contribute-to-celo/:slug*"
-    },
-    {
-      "source": "/what-is-celo/about-celo-l1/:slug*",
-      "destination": "/learn/celo-l1"
-    },
     {
       "source": "/cli",
       "destination": "/build/tools/libraries-sdks/cli"
     },
-    {
-      "source": "/cli/:slug*",
-      "destination": "/build/tools/libraries-sdks/cli/:slug*"
-    },
     {
       "source": "/network",
       "destination": "/learn/network/overview"
@@ -3059,62 +3171,30 @@
       "source": "/network/alfajores",
       "destination": "/build/tools/testnets/celo-sepolia"
     },
-    {
-      "source": "/network/alfajores/:slug*",
-      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
-    },
     {
       "source": "/network/baklava",
       "destination": "/build/tools/testnets/celo-sepolia"
     },
-    {
-      "source": "/network/baklava/:slug*",
-      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
-    },
     {
       "source": "/network/celo-sepolia",
       "destination": "/build/tools/testnets/celo-sepolia"
     },
-    {
-      "source": "/network/celo-sepolia/:slug*",
-      "destination": "/build/tools/testnets/celo-sepolia/:slug*"
-    },
     {
       "source": "/network/eclair",
       "destination": "/build/tools/testnets/celo-sepolia"
     },
-    {
-      "source": "/network/eclair/:slug*",
-      "destination": "/build/tools/testnets/celo-sepolia"
-    },
     {
       "source": "/network/mainnet",
       "destination": "/learn/network/overview"
     },
-    {
-      "source": "/network/mainnet/:slug*",
-      "destination": "/learn/network/overview"
-    },
-    {
-      "source": "/network/node/:slug*",
-      "destination": "/build/tools/nodes/:slug*"
-    },
     {
       "source": "/wallet",
       "destination": "/learn/wallets"
     },
-    {
-      "source": "/wallet/:slug*",
-      "destination": "/build/tools/wallets/:slug*"
-    },
     {
       "source": "/integration",
       "destination": "/operate/operators/overview"
     },
-    {
-      "source": "/integration/:slug*",
-      "destination": "/operate/operators/overview"
-    },
     {
       "source": "/infra-partners/integration",
       "destination": "/operate/operators/overview"
@@ -3139,10 +3219,6 @@
       "source": "/infra-partners/integration/listings",
       "destination": "/operate/operators/overview"
     },
-    {
-      "source": "/contracts/:slug*",
-      "destination": "/build/tools/contracts/:slug*"
-    },
     {
       "source": "/cel2/faq",
       "destination": "/operate/operators/faq"
@@ -3739,18 +3815,10 @@
       "source": "/infra-partners",
       "destination": "/operate/notices/overview"
     },
-    {
-      "source": "/infra-partners/:slug*",
-      "destination": "/operate/:slug*"
-    },
     {
       "source": "/specs",
       "destination": "/operate/specification"
     },
-    {
-      "source": "/specs/:slug*",
-      "destination": "/operate/specification/:slug*"
-    },
     {
       "source": "/about-celo",
       "destination": "/learn"
@@ -3763,10 +3831,6 @@
       "source": "/about-celo/protocol/consensus",
       "destination": "/learn/protocol/security-council"
     },
-    {
-      "source": "/about-celo/:slug*",
-      "destination": "/learn/:slug*"
-    },
     {
       "source": "/general/history",
       "destination": "/learn/history"
@@ -4676,28 +4740,32 @@
       "destination": "/build"
     },
     {
-      "source": "/protocol/bridge/:slug*",
-      "destination": "/build/tools/bridges/bridges"
+      "source": "/build/build-with-ai/agent-skills",
+      "destination": "/build/agents/celopedia"
     },
     {
-      "source": "/protocol/bridging/:slug*",
-      "destination": "/build/tools/bridges/bridges"
+      "source": "/build/build-with-ai/celina",
+      "destination": "/build/agents/mcp/celina"
     },
     {
-      "source": "/bridge/:slug*",
-      "destination": "/build/tools/bridges/bridges"
+      "source": "/build/build-with-ai/celo-pedia",
+      "destination": "/build/agents/celopedia"
     },
     {
-      "source": "/community/celo-sage/:slug*",
-      "destination": "/contribute-to-celo/contributors/documentation-contributors"
+      "source": "/build/build-with-bridge",
+      "destination": "/learn/ramps"
     },
     {
-      "source": "/build-on-celo/build-with-ai/celina/:slug*",
-      "destination": "/build/agents/mcp/celina"
+      "source": "/build/contract-development/deploy/deploy-with-foundry",
+      "destination": "/build/tools/dev-environments/foundry"
     },
     {
-      "source": "/blog/:slug*",
-      "destination": "/build"
+      "source": "/build/minipay/overview",
+      "destination": "/build/mini-apps/overview"
+    },
+    {
+      "source": "/build/mobile-wallets/minipay",
+      "destination": "/build/mini-apps/overview"
     }
   ],
   "footer": {