Docs: restructure Subgraphs, Substreams, Indexing & Resources

website/next.config.js

@@ -53,6 +53,10 @@ const withNextra = nextra({
       '---1': {
         type: 'separator',
       },
+      'ai-overview': 'AI Tooling',
+      '---1b': {
+        type: 'separator',
+      },
       subgraphs: {
         type: 'children',
         title: t('global.navigation.subgraphs'),
@@ -67,20 +71,16 @@ const withNextra = nextra({
       '---3': {
         type: 'separator',
       },
-      'ai-overview': '',
-      '---4': {
-        type: 'separator',
-      },
       indexing: {
         type: 'children',
-        title: t('global.navigation.indexing'),
+        title: 'Indexer Tooling',
       },
       '---5': {
         type: 'separator',
       },
       'graph-horizon': {
         type: 'children',
-        title: t('global.navigation.graph-horizon'),
+        title: 'Data Services',
       },
       '---6': {
         type: 'separator',
@@ -89,10 +89,6 @@ const withNextra = nextra({
         type: 'children',
         title: t('global.navigation.resources'),
       },
-      archived: {
-        type: 'children',
-        title: t('global.navigation.archived'),
-      },
     }
 
     return [

website/route-lockfile.txt

@@ -3,39 +3,30 @@
 /en/404/
 /en/about/
 /en/ai-overview/
-/en/archived/arbitrum/arbitrum-faq/
-/en/archived/arbitrum/l2-transfer-tools-faq/
-/en/archived/arbitrum/l2-transfer-tools-guide/
-/en/archived/sunrise/
 /en/contracts/
 /en/graph-horizon/migration-guide/
 /en/graph-horizon/overview/
 /en/graph-horizon/what-changes/
 /en/indexing/chain-integration-overview/
+/en/indexing/firehose/
+/en/indexing/graph-node/
+/en/indexing/graphcast/
 /en/indexing/new-chain-integration/
 /en/indexing/overview/
 /en/indexing/supported-network-requirements/
 /en/indexing/tap/
-/en/indexing/tooling/firehose/
-/en/indexing/tooling/graph-node/
-/en/indexing/tooling/graphcast/
 /en/resources/benefits/
 /en/resources/glossary/
-/en/resources/migration-guides/assemblyscript-migration-guide/
-/en/resources/migration-guides/graphql-validations-migration-guide/
-/en/resources/migration-guides/migrate-from-alchemy/
 /en/resources/roles/curating/
 /en/resources/roles/delegating/delegating/
 /en/resources/roles/delegating/undelegating/
-/en/resources/subgraph-studio-faq/
 /en/resources/tokenomics/
 /en/subgraphs/best-practices/avoid-eth-calls/
 /en/subgraphs/best-practices/derivedfrom/
 /en/subgraphs/best-practices/grafting-hotfix/
 /en/subgraphs/best-practices/immutable-entities-bytes-as-ids/
 /en/subgraphs/best-practices/pruning/
 /en/subgraphs/best-practices/timeseries/
-/en/subgraphs/billing/
 /en/subgraphs/developing/creating/advanced/
 /en/subgraphs/developing/creating/assemblyscript-mappings/
 /en/subgraphs/developing/creating/graph-node-dev/
@@ -47,57 +38,59 @@
 /en/subgraphs/developing/creating/ql-schema/
 /en/subgraphs/developing/creating/starting-your-subgraph/
 /en/subgraphs/developing/creating/subgraph-manifest/
-/en/subgraphs/developing/creating/unit-testing-framework/
-/en/subgraphs/developing/deploying/multiple-networks/
-/en/subgraphs/developing/deploying/using-subgraph-studio/
+/en/subgraphs/developing/deploying-publishing/multiple-networks/
+/en/subgraphs/developing/deploying-publishing/publishing-a-subgraph/
+/en/subgraphs/developing/deploying-publishing/using-subgraph-studio/
 /en/subgraphs/developing/developer-faq/
 /en/subgraphs/developing/introduction/
 /en/subgraphs/developing/managing/deleting-a-subgraph/
 /en/subgraphs/developing/managing/transferring-a-subgraph/
-/en/subgraphs/developing/publishing/publishing-a-subgraph/
-/en/subgraphs/developing/subgraphs/
-/en/subgraphs/explorer/
-/en/subgraphs/fair-use-policy/
-/en/subgraphs/guides/agent0/
-/en/subgraphs/guides/contract-analyzer/
+/en/subgraphs/existing-subgraphs/agent0/
+/en/subgraphs/existing-subgraphs/explorer/
+/en/subgraphs/existing-subgraphs/polymarket/
+/en/subgraphs/existing-subgraphs/standard-subgraphs/
 /en/subgraphs/guides/enums/
 /en/subgraphs/guides/grafting/
 /en/subgraphs/guides/near/
-/en/subgraphs/guides/polymarket/
 /en/subgraphs/guides/secure-api-keys-nextjs/
 /en/subgraphs/guides/subgraph-composition/
 /en/subgraphs/guides/subgraph-debug-forking/
-/en/subgraphs/guides/subgraph-linter/
-/en/subgraphs/guides/subgraph-uncrashable/
 /en/subgraphs/guides/transfer-to-the-graph/
-/en/subgraphs/guides/x402-payments/
+/en/subgraphs/overview/
+/en/subgraphs/providers/subgraph-studio/fair-use-policy/
+/en/subgraphs/providers/subgraph-studio/introduction/
+/en/subgraphs/providers/subgraph-studio/managing-api-keys/
+/en/subgraphs/providers/subgraph-studio/studio-faq/
+/en/subgraphs/providers/subgraph-studio/upgrade-indexer/
 /en/subgraphs/querying/best-practices/
-/en/subgraphs/querying/distributed-systems/
 /en/subgraphs/querying/from-an-application/
 /en/subgraphs/querying/graph-client/README/
 /en/subgraphs/querying/graph-client/architecture/
 /en/subgraphs/querying/graph-client/live/
 /en/subgraphs/querying/graphql-api/
 /en/subgraphs/querying/introduction/
-/en/subgraphs/querying/managing-api-keys/
 /en/subgraphs/querying/python/
 /en/subgraphs/querying/subgraph-id-vs-deployment-id/
 /en/subgraphs/quick-start/
-/en/subgraphs/skills/
-/en/subgraphs/subgraph-mcp/claude/
-/en/subgraphs/subgraph-mcp/cline/
-/en/subgraphs/subgraph-mcp/cursor/
-/en/subgraphs/subgraph-mcp/introduction/
-/en/subgraphs/upgrade-indexer/
+/en/subgraphs/tooling/contract-analyzer/
+/en/subgraphs/tooling/skills/
+/en/subgraphs/tooling/subgraph-linter/
+/en/subgraphs/tooling/subgraph-mcp/claude/
+/en/subgraphs/tooling/subgraph-mcp/cline/
+/en/subgraphs/tooling/subgraph-mcp/cursor/
+/en/subgraphs/tooling/subgraph-mcp/introduction/
+/en/subgraphs/tooling/subgraph-uncrashable/
+/en/subgraphs/tooling/unit-testing-framework/
+/en/subgraphs/tooling/x402-payments/
 /en/substreams/developing/dev-container/
 /en/substreams/developing/sinks/
 /en/substreams/developing/solana/account-changes/
 /en/substreams/developing/solana/transactions/
-/en/substreams/introduction/
+/en/substreams/overview/
 /en/substreams/publishing/
 /en/substreams/quick-start/
-/en/substreams/skills/
-/en/substreams/substreams-mcp/search/
+/en/substreams/tooling/skills/
+/en/substreams/tooling/substreams-mcp/search/
 /en/supported-networks/
 /en/supported-networks/arbitrum-nova/
 /en/supported-networks/arbitrum-one/

website/src/HomePage.tsx

@@ -128,9 +128,7 @@ export default function HomePage({ supportedNetworks }: { supportedNetworks: Sup
                 title={t('index.products.graphNode.title')}
                 description={t('index.products.graphNode.description')}
                 cta={
-                  <ExperimentalLink href="/indexing/tooling/graph-node/">
-                    {t('index.products.graphNode.cta')}
-                  </ExperimentalLink>
+                  <ExperimentalLink href="/indexing/graph-node/">{t('index.products.graphNode.cta')}</ExperimentalLink>
                 }
                 icon={
                   <div className="flex size-8 items-center justify-center rounded-4 bg-space-1400 text-white">
@@ -141,11 +139,7 @@ export default function HomePage({ supportedNetworks }: { supportedNetworks: Sup
               <Card
                 title={t('index.products.firehose.title')}
                 description={t('index.products.firehose.description')}
-                cta={
-                  <ExperimentalLink href="/indexing/tooling/firehose/">
-                    {t('index.products.firehose.cta')}
-                  </ExperimentalLink>
-                }
+                cta={<ExperimentalLink href="/indexing/firehose/">{t('index.products.firehose.cta')}</ExperimentalLink>}
                 icon={
                   <div className="flex size-8 items-center justify-center rounded-4 bg-space-1400 text-white">
                     <Firehose size={4} />
@@ -210,14 +204,14 @@ export default function HomePage({ supportedNetworks }: { supportedNetworks: Sup
           <div className="graph-docs-not-markdown mt-8 grid gap-4">
             <div className="grid grid-cols-1 gap-4 lg:grid-cols-3">
               <Card
-                href="/subgraphs/explorer/"
+                href="/subgraphs/existing-subgraphs/explorer/"
                 title={t('index.guides.explorer.title')}
                 description={t('index.guides.explorer.description')}
                 icon={<GraphExplorer alt="" />}
                 slotAboveTitle={<TimeIcon variant="reading" minutes={10} />}
               />
               <Card
-                href="/subgraphs/developing/publishing/publishing-a-subgraph/"
+                href="/subgraphs/developing/deploying-publishing/publishing-a-subgraph/"
                 title={t('index.guides.publishASubgraph.title')}
                 description={t('index.guides.publishASubgraph.description')}
                 icon={<Subgraph alt="" />}
@@ -245,7 +239,7 @@ export default function HomePage({ supportedNetworks }: { supportedNetworks: Sup
                 slotAboveTitle={<TimeIcon variant="reading" minutes={4} />}
               />
               <Card
-                href="/subgraphs/querying/managing-api-keys/"
+                href="/subgraphs/providers/subgraph-studio/managing-api-keys/"
                 title={t('index.guides.apiKeyManagement.title')}
                 description={t('index.guides.apiKeyManagement.description')}
                 slotAboveTitle={<TimeIcon variant="reading" minutes={2} />}

website/src/pages/en/about.mdx

@@ -34,7 +34,7 @@ The result: raw, hard-to-access on-chain data becomes fast, structured, and read
 
 ## The Graph's Core Products
 
-### 1. [Subgraphs](/subgraphs/developing/subgraphs/)
+### 1. [Subgraphs](/subgraphs/overview/)
 
 **Overview:** Custom APIs that extract data from a blockchain, process it, and serve it via GraphQL. The original and most widely used data service on The Graph.
 
@@ -43,14 +43,14 @@ The result: raw, hard-to-access on-chain data becomes fast, structured, and read
 - [Explore existing Subgraphs](https://thegraph.com/explorer)
 - [Build a Subgraph](/subgraphs/quick-start)
 
-### 2. [Substreams](/substreams/introduction/)
+### 2. [Substreams](/substreams/overview/)
 
 **Overview:** A parallel blockchain indexing technology for high-performance, real-time data streams. Built for use cases that need faster sync and larger throughput than traditional Subgraphs.
 
 **Use Case:** Best when you need low-latency data at scale: live liquidity and price feeds, trading and liquidation events, analytics pipelines, and large-scale backfills across chains.
 
 - [Browse existing Substreams](https://substreams.dev/)
-- [Build with Substreams](/substreams/introduction/)
+- [Build with Substreams](/substreams/overview/)
 
 ### 3. [Amp](https://ampup.sh/docs)
 

website/src/pages/en/ai-overview.mdx

@@ -5,7 +5,7 @@ description: Build with speed and scale faster with The Graph’s MCPs and skill
 
 ## Using AI on The Graph
 
-Instead of relying on static datasets or centralized APIs, you can now use our AI-native tooling via the [Subgraph MCP](/subgraphs/subgraph-mcp/introduction/), [Substreams MCP](/substreams/substreams-mcp/search/), and agent skills for both Subgraphs and Substreams.
+Instead of relying on static datasets or centralized APIs, you can now use our AI-native tooling via the [Subgraph MCP](/subgraphs/tooling/subgraph-mcp/introduction/), [Substreams MCP](/substreams/tooling/substreams-mcp/search/), and agent skills for both Subgraphs and Substreams.
 
 ### Why Use Onchain Data with AI?
 
@@ -23,7 +23,7 @@ Agent Skills extend AI coding assistants like Claude Code and Cursor with deep,
 
 ### Subgraph MCP
 
-The [Subgraph MCP](/subgraphs/subgraph-mcp/introduction/) server connects models to Subgraphs on The Graph Network. It allows language models to explore Subgraph schemas, execute GraphQL queries, find relevant Subgraphs by keyword or contract, and surface usage metrics using natural language.
+The [Subgraph MCP](/subgraphs/tooling/subgraph-mcp/introduction/) server connects models to Subgraphs on The Graph Network. It allows language models to explore Subgraph schemas, execute GraphQL queries, find relevant Subgraphs by keyword or contract, and surface usage metrics using natural language.
 
 #### Benefits of Using Subgraph MCP
 
@@ -34,7 +34,7 @@ The [Subgraph MCP](/subgraphs/subgraph-mcp/introduction/) server connects models
 
 ### Substreams MCP
 
-The [Substreams MCP](/substreams/substreams-mcp/search/) server lets AI agents search, inspect, and analyze Substreams packages — from registry discovery to sink deployment. It supports dual transport for local clients and SSE/HTTP for remote agents.
+The [Substreams MCP](/substreams/tooling/substreams-mcp/search/) server lets AI agents search, inspect, and analyze Substreams packages — from registry discovery to sink deployment. It supports dual transport for local clients and SSE/HTTP for remote agents.
 
 #### Tools
 
@@ -53,7 +53,7 @@ The [Substreams MCP](/substreams/substreams-mcp/search/) server lets AI agents s
 
 ### Agent Skills for Subgraphs
 
-[Subgraph Skills](/subgraphs/skills/) is a collection of AI agent skills that provide expert knowledge for developing, testing, and deploying Subgraphs. Skills are available as Claude Code plugins or OpenClaw skills.
+[Subgraph Skills](/subgraphs/tooling/skills/) is a collection of AI agent skills that provide expert knowledge for developing, testing, and deploying Subgraphs. Skills are available as Claude Code plugins or OpenClaw skills.
 
 #### Available Skills
 
@@ -65,7 +65,7 @@ The [Substreams MCP](/substreams/substreams-mcp/search/) server lets AI agents s
 
 ### Agent Skills for Substreams
 
-[Substreams Skills](/substreams/skills/) enhance AI coding assistants with specialized Substreams expertise. Install once and your assistant automatically applies Substreams best practices when working on relevant projects.
+[Substreams Skills](/substreams/tooling/skills/) enhance AI coding assistants with specialized Substreams expertise. Install once and your assistant automatically applies Substreams best practices when working on relevant projects.
 
 #### Available Skills