diff --git a/lychee.toml b/lychee.toml
index b5131db61..60e8be5a2 100644
--- a/lychee.toml
+++ b/lychee.toml
@@ -36,7 +36,8 @@ exclude = [
'https://archive.org',
'https://web.archive.org',
'https://mainnet.base.org',
- 'https://sepolia.base.org'
+ 'https://sepolia.base.org',
+ 'https://optimism.easscan.org'
]
# Accept these status codes
diff --git a/notes/breadcrumbs.md b/notes/breadcrumbs.md
new file mode 100644
index 000000000..e30512e7f
--- /dev/null
+++ b/notes/breadcrumbs.md
@@ -0,0 +1,36 @@
+# Documentation Breadcrumbs Script
+
+Quick guide on using our breadcrumbs automation script for the OP Stack documentation.
+
+## What the Script Does
+
+* Creates `.mdx` files for each folder (breadcrumb pages)
+* Populates Card components linking to contained files
+* Preserves existing descriptions that already
+* Maintains consistent navigation structure
+
+## Using the Script
+
+Breadcrumbs for the docs can be generated by running:
+
+```bash
+pnpm create-breadcrumbs
+```
+
+### What to Watch For
+
+1. **Before Running**
+ * Commit your current changes
+ * Ensure you're in the docs root directory
+ * Target folders should exist: `builders`, `chain`, `stack`, `connect`
+
+2. **After Running**
+ * Review generated `.mdx` files in each folder
+ * Check updated descriptions
+ * Verify Card components and links
+
+## Common Issues
+
+* ***Script fails**: Ensure you're in the root directory
+* **No files generated**: Check folder structure matches expected paths
+* **Unexpected content**: Review git diff before committing
\ No newline at end of file
diff --git a/package.json b/package.json
index 7d4036e50..856bae818 100644
--- a/package.json
+++ b/package.json
@@ -8,6 +8,7 @@
"spellcheck:lint": "cspell lint \"**/*.mdx\"",
"spellcheck:fix": "cspell --words-only --unique \"**/*.mdx\" | sort --ignore-case | uniq > words.txt",
"linkcheck": "lychee --config ./lychee.toml --quiet \"./pages\"",
+ "create-breadcrumbs":"npx ts-node --skip-project utils/create-breadcrumbs.ts",
"index:docs": "npx ts-node --skip-project utils/algolia-indexer.ts",
"dev": "next dev",
"build": "next build",
diff --git a/pages/builders.mdx b/pages/builders.mdx
new file mode 100644
index 000000000..ab69e59b6
--- /dev/null
+++ b/pages/builders.mdx
@@ -0,0 +1,20 @@
+---
+title: Builders
+lang: en-US
+description: Learn about deploying contracts, cross-chain messaging, and tutorials to help you build applications on OP Mainnet.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Builders
+
+Welcome to the Builders section. Here you'll find resources and guides for developers, operators, and other stakeholders involved in building on OP Stack. Explore the categories below to find the information you need.
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/app-developers.mdx b/pages/builders/app-developers.mdx
new file mode 100644
index 000000000..4bf0f90ce
--- /dev/null
+++ b/pages/builders/app-developers.mdx
@@ -0,0 +1,28 @@
+---
+title: App Developers
+lang: en-US
+description: Essential resources for app developers building on the OP Stack, including guides for deploying contracts, handling transactions, and cross-chain messaging.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# App Developers
+
+Welcome to the App Developers section, where you'll find essential resources for deploying contracts, handling transactions, cross-chain messaging, and more.
+Access quick-start guides, tutorials, and tools to help you build applications on the OP Stack efficiently
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/app-developers/bridging.mdx b/pages/builders/app-developers/bridging.mdx
new file mode 100644
index 000000000..893cb6db6
--- /dev/null
+++ b/pages/builders/app-developers/bridging.mdx
@@ -0,0 +1,21 @@
+---
+title: Bridging
+lang: en-US
+description: Learn about bridging basics, custom bridges, data transmission between L1 and L2, and using the standard bridge in OP Stack.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Bridging
+
+This section provides information on bridging basics, custom bridges, sending data between l1 and l2 and using the standard bridge. You'll find guide, overview to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/app-developers/contracts.mdx b/pages/builders/app-developers/contracts.mdx
new file mode 100644
index 000000000..6c01b91e2
--- /dev/null
+++ b/pages/builders/app-developers/contracts.mdx
@@ -0,0 +1,21 @@
+---
+title: Contracts
+lang: en-US
+description: >-
+ Information on Solidity compatibility, contract optimization, and system
+ contracts for OP Stack.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Contracts
+
+This section provides information on Solidity compatibility, contract optimization on OP Stack, and using OP Stack system contracts. You'll find guides and tutorials to help you understand and work with these topics.
+
+
+
+
+
+
+
+
diff --git a/pages/builders/app-developers/tools.mdx b/pages/builders/app-developers/tools.mdx
new file mode 100644
index 000000000..7aeb81f23
--- /dev/null
+++ b/pages/builders/app-developers/tools.mdx
@@ -0,0 +1,17 @@
+---
+title: Tools
+lang: en-US
+description: Information on open-source code repositories for OP Stack builders and SuperSim.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Tools
+
+This section provides information on open-source code repositories for OP Stack builders and SuperSim. Users will find references to help understand and work with these topics.
+
+
+
+
+
+
diff --git a/pages/builders/app-developers/tools/supersim.mdx b/pages/builders/app-developers/tools/supersim.mdx
index dc60c54ac..57a0d8e40 100644
--- a/pages/builders/app-developers/tools/supersim.mdx
+++ b/pages/builders/app-developers/tools/supersim.mdx
@@ -1,4 +1,9 @@
---
+title: Supersim
+lang: en-US
+description: >-
+ Learn about supersim in the Optimism ecosystem. This guide provides detailed
+ information and resources about supersim.
---
import Supersim from '@/pages/stack/interop/supersim.mdx'
diff --git a/pages/builders/app-developers/transactions.mdx b/pages/builders/app-developers/transactions.mdx
new file mode 100644
index 000000000..e845de2d1
--- /dev/null
+++ b/pages/builders/app-developers/transactions.mdx
@@ -0,0 +1,25 @@
+---
+title: Transactions
+lang: en-US
+description: >-
+ Guide to understanding and working with transactions on OP Stack, including
+ fee estimation, gas parameters, and troubleshooting.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Transactions
+
+This section provides information on transactions in OP Mainnet, including fee estimation, gas parameters, transaction statuses, and troubleshooting. You'll find guides to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/app-developers/transactions/fees.mdx b/pages/builders/app-developers/transactions/fees.mdx
index 09af8f1c0..cc3b2e6f3 100644
--- a/pages/builders/app-developers/transactions/fees.mdx
+++ b/pages/builders/app-developers/transactions/fees.mdx
@@ -1,4 +1,9 @@
---
+title: TransactionFees
+lang: en-US
+description: >-
+ Learn about fees in the Optimism ecosystem. This guide provides detailed
+ information and resources about fees.
---
import TransactionFees from '@/pages/stack/transactions/fees.mdx'
diff --git a/pages/builders/app-developers/tutorials.mdx b/pages/builders/app-developers/tutorials.mdx
new file mode 100644
index 000000000..807686a51
--- /dev/null
+++ b/pages/builders/app-developers/tutorials.mdx
@@ -0,0 +1,33 @@
+---
+title: Tutorials
+lang: en-US
+description: A collection of tutorials for app developers building on OP Stack, covering topics such as bridging tokens, deploying contracts, and estimating transaction costs.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Tutorials
+
+This section provides information on bridging erc 20 tokens to op mainnet with the optimism sdk, bridging eth to op mainnet with the optimism sdk, communicating between op mainnet and ethereum in solidity, deploying your first contract on op mainnet, estimating transaction costs on op mainnet, tracing deposits and withdrawals, viewing deposits and withdrawals by address, triggering op mainnet transactions from ethereum, bridging your custom erc 20 token using the standard bridge and bridging your standard erc 20 token using the standard bridge. You'll find tutorial to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/cex-wallet-developers.mdx b/pages/builders/cex-wallet-developers.mdx
new file mode 100644
index 000000000..0ac230932
--- /dev/null
+++ b/pages/builders/cex-wallet-developers.mdx
@@ -0,0 +1,19 @@
+---
+title: CEX Wallet Developers
+description: >-
+ This section provides information on supporting OP Stack in your exchange and
+ supporting OP Stack in your wallet. You'll find guide to help you...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# CEX Wallet Developers
+
+This section provides information on supporting op mainnet in your exchange and supporting op mainnet in your wallet. You'll find guide to help you understand and work with these topics.
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators.mdx b/pages/builders/chain-operators.mdx
new file mode 100644
index 000000000..872c69d26
--- /dev/null
+++ b/pages/builders/chain-operators.mdx
@@ -0,0 +1,31 @@
+---
+title: Chain Operators
+lang: en-US
+description: Information on chain architecture, configuration, deployment, and management for OP Stack chain operators.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Chain operators
+
+This section provides information on chain architecture, configuration, deployment, features, hacks, management, and how to start a self-hosted chain. You'll also find tools, APIs, overviews, guides, and introductions to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators/configuration.mdx b/pages/builders/chain-operators/configuration.mdx
new file mode 100644
index 000000000..f8ea320f4
--- /dev/null
+++ b/pages/builders/chain-operators/configuration.mdx
@@ -0,0 +1,21 @@
+---
+title: Configuration
+lang: en-US
+description: Overview of configuration options for batchers, chain operators, proposers, and rollup deployments.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Configuration
+
+This section provides information on batcher configuration, chain operator configurations, proposer configuration, and rollup deployment configuration. Users will find API references and overviews to help understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators/deploy.mdx b/pages/builders/chain-operators/deploy.mdx
new file mode 100644
index 000000000..87e4184f6
--- /dev/null
+++ b/pages/builders/chain-operators/deploy.mdx
@@ -0,0 +1,19 @@
+---
+title: Deploy
+lang: en-US
+description: Information on OP Stack genesis creation, deployment overview, and smart contract deployment.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Deploy
+
+This section provides information on OP Stack genesis creation, deployment overview, and smart contract deployment. You'll find guides and overviews to help you understand and work with these topics.
+
+
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators/features.mdx b/pages/builders/chain-operators/features.mdx
new file mode 100644
index 000000000..e2a22d516
--- /dev/null
+++ b/pages/builders/chain-operators/features.mdx
@@ -0,0 +1,25 @@
+---
+title: Features
+lang: en-US
+description: >-
+ Learn about features in the Optimism ecosystem. This guide provides detailed
+ information and resources about features.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Features
+
+This section provides information on various features for chain operators. You'll find guides and overviews to help you understand and work with topics such as running an alternative data availability mode chain, implementing the bridged USDC standard on the OP Stack, running a custom gas token chain, OP Stack preinstalls, and span batches.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators/hacks.mdx b/pages/builders/chain-operators/hacks.mdx
new file mode 100644
index 000000000..5a30e8912
--- /dev/null
+++ b/pages/builders/chain-operators/hacks.mdx
@@ -0,0 +1,27 @@
+---
+title: Hacks
+lang: en-US
+description: >-
+ Learn about hacks in the Optimism ecosystem. This guide provides detailed
+ information and resources about hacks.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Hacks
+
+This section provides information on various types of hacks related to OP Stack, including data availability, derivation, execution, and settlement. You'll find an overview and introduction to help you understand and work with these topics, as well as featured hacks for practical examples.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators/management.mdx b/pages/builders/chain-operators/management.mdx
new file mode 100644
index 000000000..df32978e5
--- /dev/null
+++ b/pages/builders/chain-operators/management.mdx
@@ -0,0 +1,27 @@
+---
+title: Management
+lang: en-US
+description: >-
+ Learn about management in the Optimism ecosystem. This guide provides detailed
+ information and resources about management.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Management
+
+This section provides information on chain operator best practices, using blobs, managing keys, rollup operations, using snap sync for chain operators, and troubleshooting chain operations. You'll find guides and tutorials to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators/tools.mdx b/pages/builders/chain-operators/tools.mdx
new file mode 100644
index 000000000..1b8103c61
--- /dev/null
+++ b/pages/builders/chain-operators/tools.mdx
@@ -0,0 +1,25 @@
+---
+title: Tools
+lang: en-US
+description: >-
+ Learn about tools in the Optimism ecosystem. This guide provides detailed
+ information and resources about tools.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Tools
+
+This section provides information on chain monitoring options, deploying a block explorer, configuring a challenger for your chain, conductor, and deployer. You'll find guides, overviews, and tools to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/chain-operators/tutorials.mdx b/pages/builders/chain-operators/tutorials.mdx
new file mode 100644
index 000000000..6f99a4661
--- /dev/null
+++ b/pages/builders/chain-operators/tutorials.mdx
@@ -0,0 +1,27 @@
+---
+title: Tutorials
+lang: en-US
+description: >-
+ Learn about tutorials in the Optimism ecosystem. This guide provides detailed
+ information and resources about tutorials.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Tutorials
+
+This section provides information on adding attributes to the derivation function, adding a precompile, creating your own l2 rollup testnet, integrating a new da layer with alt da, modifying predeployed contracts and using the optimism sdk. You'll find overview, tutorial, guide to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/node-operators.mdx b/pages/builders/node-operators.mdx
new file mode 100644
index 000000000..bd2ffdeba
--- /dev/null
+++ b/pages/builders/node-operators.mdx
@@ -0,0 +1,29 @@
+---
+title: Node Operators
+description: This section provides information on node architecture, configuration, json rpc api, management, network upgrades, node software releases, how to run...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Node Operators
+
+This section provides information on node architecture, configuration, json rpc api, management, network upgrades, node software releases, how to run a node in the superchain and tutorials. You'll find api, guide, overview to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/node-operators/configuration.mdx b/pages/builders/node-operators/configuration.mdx
new file mode 100644
index 000000000..da2c8f8a8
--- /dev/null
+++ b/pages/builders/node-operators/configuration.mdx
@@ -0,0 +1,21 @@
+---
+title: Configuration
+lang: en-US
+description: >-
+ Learn about configuration in the Optimism ecosystem. This guide provides
+ detailed information and resources about configuration.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Configuration
+
+This section provides information on node base configuration, consensus layer configuration options (OP Node), and execution layer configuration options (OP Geth). You'll find information to help you understand and work with these topics.
+
+
+
+
+
+
+
+
diff --git a/pages/builders/node-operators/management.mdx b/pages/builders/node-operators/management.mdx
new file mode 100644
index 000000000..428a4593d
--- /dev/null
+++ b/pages/builders/node-operators/management.mdx
@@ -0,0 +1,25 @@
+---
+title: Management
+lang: en-US
+description: >-
+ Learn about management in the Optimism ecosystem. This guide provides detailed
+ information and resources about management.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Management
+
+This section provides information on using blobs, node metrics and monitoring, snap sync for node operators, node snapshots, and troubleshooting. Users will find APIs, references, and guides to help understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/node-operators/tutorials.mdx b/pages/builders/node-operators/tutorials.mdx
new file mode 100644
index 000000000..de908fd0f
--- /dev/null
+++ b/pages/builders/node-operators/tutorials.mdx
@@ -0,0 +1,23 @@
+---
+title: Tutorials
+lang: en-US
+description: >-
+ Learn about tutorials in the Optimism ecosystem. This guide provides detailed
+ information and resources about tutorials.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Tutorials
+
+This section provides information on various node operations. It covers running an OP Mainnet node from source, running a node with Docker, building a node from source, and running an OP Sepolia node from source. You'll find tutorials and guides to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/notices.mdx b/pages/builders/notices.mdx
new file mode 100644
index 000000000..81a3ecb0a
--- /dev/null
+++ b/pages/builders/notices.mdx
@@ -0,0 +1,19 @@
+---
+title: Notices
+description: This section provides information on preparing for fault proofs breaking changes, preparing for granite breaking changes and deprecation of the...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Notices
+
+This section provides information on preparing for fault proofs breaking changes, preparing for granite breaking changes and deprecation of the optimism sdk. You'll find overview, tutorial to help you understand and work with these topics.
+
+
+
+
+
+
+
+
diff --git a/pages/builders/tools.mdx b/pages/builders/tools.mdx
new file mode 100644
index 000000000..4541d4cd8
--- /dev/null
+++ b/pages/builders/tools.mdx
@@ -0,0 +1,25 @@
+---
+title: Tools
+description: This section provides information on build, connect, fjord fee parameter calculator, monitor, op tools and developer tools. You'll find guide, tool,...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Tools
+
+This section provides information on build, connect, fjord fee parameter calculator, monitor, op tools and developer tools. You'll find guide, tool, overview to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/tools/build.mdx b/pages/builders/tools/build.mdx
new file mode 100644
index 000000000..0d039842e
--- /dev/null
+++ b/pages/builders/tools/build.mdx
@@ -0,0 +1,25 @@
+---
+title: Build
+lang: en-US
+description: >-
+ Learn about build in the Optimism ecosystem. This guide provides detailed
+ information and resources about build.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Build
+
+This section provides information on account abstraction, block explorers, testnet faucets, op mainnet nft tools and oracles. You'll find guide, reference, tool, api to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/builders/tools/connect.mdx b/pages/builders/tools/connect.mdx
new file mode 100644
index 000000000..50154b1f4
--- /dev/null
+++ b/pages/builders/tools/connect.mdx
@@ -0,0 +1,19 @@
+---
+title: Connect
+lang: en-US
+description: >-
+ Learn about connect in the Optimism ecosystem. This guide provides detailed
+ information and resources about connect.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Connect
+
+This section provides information on networks and rpc & node providers. You'll find reference to help you understand and work with these topics.
+
+
+
+
+
+
diff --git a/pages/builders/tools/connect/networks.mdx b/pages/builders/tools/connect/networks.mdx
index f7a9e91cb..7440c93ec 100644
--- a/pages/builders/tools/connect/networks.mdx
+++ b/pages/builders/tools/connect/networks.mdx
@@ -1,4 +1,9 @@
---
+title: OPNetworks
+lang: en-US
+description: >-
+ Learn about networks in the Optimism ecosystem. This guide provides detailed
+ information and resources about networks.
---
import OPNetworks from '@/pages/chain/networks.mdx'
diff --git a/pages/builders/tools/monitor.mdx b/pages/builders/tools/monitor.mdx
new file mode 100644
index 000000000..848483480
--- /dev/null
+++ b/pages/builders/tools/monitor.mdx
@@ -0,0 +1,19 @@
+---
+title: Monitor
+lang: en-US
+description: >-
+ Learn about monitor in the Optimism ecosystem. This guide provides detailed
+ information and resources about monitor.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Monitor
+
+This section provides information on analytics tools and accessing pre regenesis history. You'll find guide, tool to help you understand and work with these topics.
+
+
+
+
+
+
diff --git a/pages/builders/tools/op-tools.mdx b/pages/builders/tools/op-tools.mdx
new file mode 100644
index 000000000..4335cef41
--- /dev/null
+++ b/pages/builders/tools/op-tools.mdx
@@ -0,0 +1,15 @@
+---
+title: Op Tools
+lang: en-US
+description: >-
+ Learn about op tools in the Optimism ecosystem. This guide provides detailed
+ information and resources about op tools.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Op Tools
+
+This section provides information on .
+
+
diff --git a/pages/chain/identity.mdx b/pages/chain/identity.mdx
new file mode 100644
index 000000000..2f9a23ac9
--- /dev/null
+++ b/pages/chain/identity.mdx
@@ -0,0 +1,29 @@
+---
+title: Identity
+description: This section provides information on about attestations, attestation apps, contracts (eas), individual identity, organizations, identity overview,...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Identity
+
+This section provides information on about attestations, attestation apps, contracts (eas), individual identity, organizations, identity overview, projects and schemas. You'll find guide, reference, overview to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/chain/security.mdx b/pages/chain/security.mdx
new file mode 100644
index 000000000..b1a09682c
--- /dev/null
+++ b/pages/chain/security.mdx
@@ -0,0 +1,21 @@
+---
+title: Security
+description: >-
+ This section provides information on OP Stack security model, privileged roles
+ in OP Stack and security policy and bug bounty program.
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Security
+
+This section provides information on op mainnet security model, privileged roles in op mainnet and security policy and bug bounty program.
+
+
+
+
+
+
+
+
diff --git a/pages/chain/testing.mdx b/pages/chain/testing.mdx
new file mode 100644
index 000000000..923766e11
--- /dev/null
+++ b/pages/chain/testing.mdx
@@ -0,0 +1,19 @@
+---
+title: Testing
+description: >-
+ This section provides information on running a local development environment
+ and testing apps for OP Stack. You'll find tutorial, guide to help you...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Testing
+
+This section provides information on running a local development environment and testing apps for op mainnet. You'll find tutorial, guide to help you understand and work with these topics.
+
+
+
+
+
+
diff --git a/pages/connect/contribute.mdx b/pages/connect/contribute.mdx
new file mode 100644
index 000000000..8ef9eb298
--- /dev/null
+++ b/pages/connect/contribute.mdx
@@ -0,0 +1,19 @@
+---
+title: Contribute
+description: This section provides information on ways to contribute to optimism docs, contribute to the op stack and optimism docs style guide. You'll find...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Contribute
+
+This section provides information on ways to contribute to optimism docs, contribute to the op stack and optimism docs style guide. You'll find tutorial, overview, guide to help you understand and work with these topics.
+
+
+
+
+
+
+
+
diff --git a/pages/connect/resources.mdx b/pages/connect/resources.mdx
new file mode 100644
index 000000000..80b083fe7
--- /dev/null
+++ b/pages/connect/resources.mdx
@@ -0,0 +1,15 @@
+---
+title: Resources
+description: This section provides information on . You'll find concept to help you understand and work with these topics.
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Resources
+
+This section provides information on . You'll find concept to help you understand and work with these topics.
+
+
+
+
diff --git a/pages/stack/operators.mdx b/pages/stack/operators.mdx
new file mode 100644
index 000000000..01c05b33c
--- /dev/null
+++ b/pages/stack/operators.mdx
@@ -0,0 +1,15 @@
+---
+title: Operators
+description: This section provides information on . You'll find guide to help you understand and work with these topics.
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Operators
+
+This section provides information on . You'll find guide to help you understand and work with these topics.
+
+
+
+
diff --git a/pages/stack/operators/features.mdx b/pages/stack/operators/features.mdx
new file mode 100644
index 000000000..3e49e3376
--- /dev/null
+++ b/pages/stack/operators/features.mdx
@@ -0,0 +1,19 @@
+---
+title: Features
+lang: en-US
+description: >-
+ Learn about features in the Optimism ecosystem. This guide provides detailed
+ information and resources about features.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Features
+
+This section provides information on op txproxy and proxyd. You'll find guide to help you understand and work with these topics.
+
+
+
+
+
+
diff --git a/pages/stack/protocol.mdx b/pages/stack/protocol.mdx
new file mode 100644
index 000000000..05bb23994
--- /dev/null
+++ b/pages/stack/protocol.mdx
@@ -0,0 +1,25 @@
+---
+title: Protocol
+description: This section provides information on derivation pipeline, fault proofs, features, interop, sequencer outages and rollup. You'll find overview, guide...
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Protocol
+
+This section provides information on derivation pipeline, fault proofs, features, interop, sequencer outages and rollup. You'll find overview, guide to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/stack/protocol/fault-proofs.mdx b/pages/stack/protocol/fault-proofs.mdx
new file mode 100644
index 000000000..7875d85aa
--- /dev/null
+++ b/pages/stack/protocol/fault-proofs.mdx
@@ -0,0 +1,27 @@
+---
+title: Fault Proofs
+lang: en-US
+description: >-
+ Learn about fault proofs in the Optimism ecosystem. This guide provides
+ detailed information and resources about fault proofs.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Fault Proofs
+
+This section provides information on fault proof vm: cannon, op challenger explainer, fault proofs explainer, fp system components, fault proofs mainnet security and fault proof vm: mips.sol. You'll find reference, guide, overview, api, introduction to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/stack/protocol/features.mdx b/pages/stack/protocol/features.mdx
new file mode 100644
index 000000000..466ac4e35
--- /dev/null
+++ b/pages/stack/protocol/features.mdx
@@ -0,0 +1,21 @@
+---
+title: Features
+lang: en-US
+description: >-
+ Learn about features in the Optimism ecosystem. This guide provides detailed
+ information and resources about features.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Features
+
+This section provides information on Alt DA Mode Explainer, Custom Gas Token Explainer, and SendRawTransactionConditional Explainer. You'll find a guide to help you understand and work with these topics.
+
+
+
+
+
+
+
+
diff --git a/pages/stack/protocol/interop.mdx b/pages/stack/protocol/interop.mdx
new file mode 100644
index 000000000..499809656
--- /dev/null
+++ b/pages/stack/protocol/interop.mdx
@@ -0,0 +1,21 @@
+---
+title: Interop
+lang: en-US
+description: >-
+ Learn about interop in the Optimism ecosystem. This guide provides detailed
+ information and resources about interop.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Interop
+
+This section provides information on the anatomy of a cross-chain message, an interoperability explainer, and the Supersim multichain development environment. You'll find an overview, guide, and tools to help you understand and work with these topics.
+
+
+
+
+
+
+
+
diff --git a/pages/stack/protocol/rollup.mdx b/pages/stack/protocol/rollup.mdx
new file mode 100644
index 000000000..4eadc3973
--- /dev/null
+++ b/pages/stack/protocol/rollup.mdx
@@ -0,0 +1,25 @@
+---
+title: Rollup
+lang: en-US
+description: >-
+ Learn about rollup in the Optimism ecosystem. This guide provides detailed
+ information and resources about rollup.
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Rollup
+
+This section provides information on deposit flow, forced transaction, rollup protocol overview, transaction flow and withdrawal flow. You'll find guide, overview to help you understand and work with these topics.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pages/stack/security.mdx b/pages/stack/security.mdx
new file mode 100644
index 000000000..11e8a0d7c
--- /dev/null
+++ b/pages/stack/security.mdx
@@ -0,0 +1,17 @@
+---
+title: Security
+description: This section provides information on op stack security faqs and pausing the bridge.
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Security
+
+This section provides information on op stack security faqs and pausing the bridge.
+
+
+
+
+
+
diff --git a/pages/stack/transactions.mdx b/pages/stack/transactions.mdx
new file mode 100644
index 000000000..929eea7c7
--- /dev/null
+++ b/pages/stack/transactions.mdx
@@ -0,0 +1,15 @@
+---
+title: Transactions
+description: This section provides information on . You'll find reference to help you understand and work with these topics.
+lang: en-US
+---
+
+import { Card, Cards } from 'nextra/components'
+
+# Transactions
+
+This section provides information on . You'll find reference to help you understand and work with these topics.
+
+
+
+
diff --git a/utils/create-breadcrumbs.ts b/utils/create-breadcrumbs.ts
new file mode 100644
index 000000000..7bfab9804
--- /dev/null
+++ b/utils/create-breadcrumbs.ts
@@ -0,0 +1,89 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import matter from 'gray-matter';
+
+const targetFolders: string[] = ['builders', 'chain', 'stack', 'connect'];
+const rootDir: string = path.join(__dirname, '..', 'pages');
+
+interface FileInfo {
+ title: string;
+ url: string;
+}
+
+function updateOPTerminology(description: string): string {
+
+ if (description.includes('OP Stack')) {
+ return description;
+ }
+
+ // Replace variations of "OP Mainnet" with "OP Stack"
+ return description
+ .replace(/\bOP Mainnet\b/gi, 'OP Stack')
+ .replace(/\bOptimism Mainnet\b/gi, 'OP Stack')
+ .replace(/\bOptimism mainnet\b/gi, 'OP Stack');
+}
+
+const updateBreadcrumbFile = async (filePath: string): Promise => {
+ try {
+ const content = await fs.readFile(filePath, 'utf-8');
+ const { data: frontMatter, content: fileContent } = matter(content);
+
+ if (frontMatter.description &&
+ frontMatter.description.match(/\bOP Mainnet\b|\bOptimism Mainnet\b/gi) &&
+ !frontMatter.description.includes('OP Stack')) {
+
+ frontMatter.description = updateOPTerminology(frontMatter.description);
+
+
+ const updatedContent = matter.stringify(fileContent, frontMatter);
+ await fs.writeFile(filePath, updatedContent);
+ console.log(`Updated description in breadcrumb file: ${filePath}`);
+ }
+ } catch (error) {
+ console.error(`Error processing file ${filePath}:`, error);
+ }
+};
+
+const processFolder = async (folderPath: string): Promise => {
+ try {
+ const files = await fs.readdir(folderPath);
+
+ for (const file of files) {
+ const filePath = path.join(folderPath, file);
+ const stats = await fs.stat(filePath);
+
+ if (stats.isDirectory()) {
+
+ const breadcrumbFile = path.join(folderPath, `${file}.mdx`);
+ try {
+ await fs.access(breadcrumbFile);
+ await updateBreadcrumbFile(breadcrumbFile);
+ } catch (error) {
+
+ }
+
+
+ await processFolder(filePath);
+ }
+ }
+ } catch (error) {
+ console.error(`Error processing folder ${folderPath}:`, error);
+ }
+};
+
+const main = async (): Promise => {
+ console.log('Starting breadcrumb description update process...');
+ console.log('Root directory:', rootDir);
+
+ for (const folder of targetFolders) {
+ const folderPath = path.join(rootDir, folder);
+ await processFolder(folderPath);
+ }
+
+ console.log('Finished updating breadcrumb descriptions.');
+};
+
+main().catch(error => {
+ console.error('Error in main process:', error);
+ process.exit(1);
+});
\ No newline at end of file
diff --git a/words.txt b/words.txt
index b86d09017..c4cf76483 100644
--- a/words.txt
+++ b/words.txt
@@ -285,6 +285,7 @@ productionize
productionized
Protip
Proxied
+Proxyd
proxyd
pseudorandomly
QRNG
@@ -318,6 +319,7 @@ safedb
Schnorr
secp
SELFDESTRUCT
+Sendrawtransactionconditional
seqnr
SEQUENCERHTTP
sequencerhttp
@@ -366,8 +368,10 @@ trustlessly
trustrpc
txfeecap
txmgr
+txns
TXPOOL
txpool
+Txproxy
txproxy
uncountered
Unprotect