docs: examples cleanup + integrate restructure (Unigraph SQL, Subgraph as legacy)

docs/ensnode.io/astro.config.mjs

@@ -35,15 +35,26 @@ export default defineConfig({
   redirects: {
     "/docs": "/docs/integrate",
     "/ensnode": "/docs/integrate",
+    "/examples": "/docs/integrate/omnigraph/examples",
     "/ensnode/deploying/railway": "/docs/services/ensrainbow/deploying/railway",
-    "/ensnode/concepts/what-is-the-ens-subgraph":
-      "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph",
-    "/docs/reference/what-is-the-ens-subgraph":
-      "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph",
-    "/docs/reference/querying-best-practices":
-      "/docs/reference/subgraph-legacy/querying-best-practices",
-    "/docs/reference/subgraph-compatibility-tooling":
-      "/docs/reference/subgraph-legacy/subgraph-compatibility-tooling",
+    "/docs/integrate/subgraph/what-is-the-ens-subgraph": "/docs/integrate/subgraph",
+    "/docs/integrate/subgraph/subgraph-api": "/docs/integrate/subgraph/schema-reference",
+    "/docs/integrate/subgraph/with-ensjs": "/docs/integrate/subgraph/examples/with-ensjs",
+    "/docs/integrate/subgraph/with-viem": "/docs/integrate/subgraph/examples/with-viem",
+    "/docs/integrate/subgraph/subgraph-compatibility-tooling": "/docs/integrate/subgraph",
+    "/ensnode/concepts/what-is-the-ens-subgraph": "/docs/integrate/subgraph",
+    "/docs/reference/what-is-the-ens-subgraph": "/docs/integrate/subgraph",
+    "/docs/reference/querying-best-practices": "/docs/integrate/subgraph/querying-best-practices",
+    "/docs/reference/subgraph-compatibility-tooling": "/docs/integrate/subgraph",
+    "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph": "/docs/integrate/subgraph",
+    "/docs/reference/subgraph-legacy/subgraph-api": "/docs/integrate/subgraph/schema-reference",
+    "/docs/reference/subgraph-legacy/querying-best-practices":
+      "/docs/integrate/subgraph/querying-best-practices",
+    "/docs/reference/subgraph-legacy/subgraph-compatibility-tooling": "/docs/integrate/subgraph",
+    "/docs/reference/subgraph-legacy/with-ensjs": "/docs/integrate/subgraph/examples/with-ensjs",
+    "/docs/reference/subgraph-legacy/with-viem": "/docs/integrate/subgraph/examples/with-viem",
+    "/docs/reference/subgraph-legacy/subgraph-dependents":
+      "/docs/integrate/subgraph/subgraph-dependents",
     "/ensadmin": "/docs/services/ensadmin",
     "/ensapi": "/docs/services/ensapi",
     "/ensdb": "/docs/services/ensdb",

docs/ensnode.io/config/integrations/llms-txt.ts

@@ -16,5 +16,6 @@ export const starlightLlmsTxtPlugin = starlightLlmsTxt({
     "docs/integrate/integration-options/enssdk/example",
     "docs/integrate/integration-options/enskit/example",
     "docs/integrate/omnigraph/schema-reference",
+    "docs/integrate/subgraph/schema-reference",
   ],
 });

docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts

@@ -15,12 +15,56 @@ export const integrateSidebarTopic = {
       label: "ENSv2 Readiness",
       link: "/docs/integrate/ensv2-readiness",
     },
+    {
+      label: "ENS Subgraph",
+      collapsed: true,
+      badge: {
+        text: "LEGACY",
+        variant: "danger",
+      },
+      items: [
+        {
+          label: "Overview",
+          link: "/docs/integrate/subgraph",
+        },
+        {
+          label: "Examples",
+          collapsed: true,
+          items: [
+            {
+              label: "Overview",
+              link: "/docs/integrate/subgraph/examples",
+            },
+            {
+              label: "With ENSjs",
+              link: "/docs/integrate/subgraph/examples/with-ensjs",
+            },
+            {
+              label: "With Viem",
+              link: "/docs/integrate/subgraph/examples/with-viem",
+            },
+          ],
+        },
+        {
+          label: "Schema Reference",
+          link: "/docs/integrate/subgraph/schema-reference",
+        },
+        {
+          label: "Querying Best Practices",
+          link: "/docs/integrate/subgraph/querying-best-practices",
+        },
+        {
+          label: "Subgraph Dependents",
+          link: "/docs/integrate/subgraph/subgraph-dependents",
+        },
+      ],
+    },
     {
       label: "ENS Omnigraph API",
       collapsed: false,
       badge: {
         text: "NEW",
-        variant: "tip",
+        variant: "success",
       },
       items: [
         {
@@ -91,6 +135,46 @@ export const integrateSidebarTopic = {
         },
       ],
     },
+    {
+      label: "ENS Unigraph SQL",
+      collapsed: false,
+      badge: {
+        text: "NEW",
+        variant: "success",
+      },
+      items: [
+        {
+          label: "Overview",
+          link: "/docs/integrate/unigraph",
+        },
+        {
+          label: "Examples",
+          collapsed: true,
+          items: [
+            {
+              label: "Overview",
+              link: "/docs/integrate/unigraph/examples",
+            },
+            {
+              label: "Domain by Name",
+              link: "/docs/integrate/unigraph/examples/domain-by-name",
+            },
+            {
+              label: "Account Domains",
+              link: "/docs/integrate/unigraph/examples/account-domains",
+            },
+            {
+              label: "Indexing Status",
+              link: "/docs/integrate/unigraph/examples/indexing-status",
+            },
+          ],
+        },
+        {
+          label: "Schema Reference",
+          link: "/docs/integrate/unigraph/schema-reference",
+        },
+      ],
+    },
     {
       label: "Integration Options",
       collapsed: false,
@@ -100,30 +184,30 @@ export const integrateSidebarTopic = {
           link: "/docs/integrate/integration-options",
         },
         {
-          label: "enskit (React)",
+          label: "enssdk (TypeScript)",
           collapsed: false,
           items: [
             {
               label: "Overview",
-              link: "/docs/integrate/integration-options/enskit",
+              link: "/docs/integrate/integration-options/enssdk",
             },
             {
               label: "Interactive example ⚡",
-              link: "/docs/integrate/integration-options/enskit/example",
+              link: "/docs/integrate/integration-options/enssdk/example",
             },
           ],
         },
         {
-          label: "enssdk (TypeScript)",
+          label: "enskit (React)",
           collapsed: false,
           items: [
             {
               label: "Overview",
-              link: "/docs/integrate/integration-options/enssdk",
+              link: "/docs/integrate/integration-options/enskit",
             },
             {
               label: "Interactive example ⚡",
-              link: "/docs/integrate/integration-options/enssdk/example",
+              link: "/docs/integrate/integration-options/enskit/example",
             },
           ],
         },

docs/ensnode.io/config/integrations/starlight/sidebar-topics/reference.ts

@@ -11,40 +11,6 @@ export const referenceSidebarTopic = {
       label: "Terminology",
       link: "/docs/reference/terminology",
     },
-    {
-      label: "Subgraph API (Legacy)",
-      collapsed: true,
-      items: [
-        {
-          label: "What is the ENS Subgraph?",
-          link: "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph",
-        },
-        {
-          label: "Subgraph API",
-          link: "/docs/reference/subgraph-legacy/subgraph-api",
-        },
-        {
-          label: "Querying Best Practices",
-          link: "/docs/reference/subgraph-legacy/querying-best-practices",
-        },
-        {
-          label: "Subgraph Compatibility Tooling",
-          link: "/docs/reference/subgraph-legacy/subgraph-compatibility-tooling",
-        },
-        {
-          label: "With ENSjs",
-          link: "/docs/reference/subgraph-legacy/with-ensjs",
-        },
-        {
-          label: "With Viem",
-          link: "/docs/reference/subgraph-legacy/with-viem",
-        },
-        {
-          label: "Subgraph Dependents",
-          link: "/docs/reference/subgraph-legacy/subgraph-dependents",
-        },
-      ],
-    },
     {
       label: "Contributing",
       collapsed: false,

docs/ensnode.io/src/components/organisms/GraphQLSchemaDocExplorer.tsx

@@ -0,0 +1,38 @@
+import "@graphiql/react/style.css";
+import "@graphiql/plugin-doc-explorer/style.css";
+
+import { DocExplorer } from "@graphiql/plugin-doc-explorer";
+import { GraphiQLProvider } from "@graphiql/react";
+import type { GraphQLSchema } from "graphql";
+
+export default function GraphQLSchemaDocExplorer({ schema }: { schema: GraphQLSchema }) {
+  return (
+    <div
+      style={{
+        border: "1px solid var(--sl-color-gray-5)",
+        borderRadius: "1rem",
+        paddingLeft: "1rem",
+        paddingTop: "1rem",
+        paddingBottom: "1rem",
+      }}
+    >
+      <div
+        className="graphiql-container"
+        style={{
+          maxHeight: "650px",
+          overflow: "auto",
+        }}
+        data-theme="light"
+      >
+        <GraphiQLProvider
+          defaultTheme="light"
+          schema={schema}
+          dangerouslyAssumeSchemaIsValid
+          fetcher={() => Promise.resolve({})}
+        >
+          <DocExplorer />
+        </GraphiQLProvider>
+      </div>
+    </div>
+  );
+}

docs/ensnode.io/src/components/organisms/OmnigraphSchemaDocExplorer.tsx

@@ -1,41 +1,9 @@
-import "@graphiql/react/style.css";
-import "@graphiql/plugin-doc-explorer/style.css";
-
-import { DocExplorer, DocExplorerStore } from "@graphiql/plugin-doc-explorer";
-import { GraphiQLProvider } from "@graphiql/react";
 import omnigraphSchemaSdl from "enssdk/omnigraph/schema.graphql?raw";
 import { buildSchema } from "graphql";
+import GraphQLSchemaDocExplorer from "./GraphQLSchemaDocExplorer.tsx";
 
 const omnigraphSchema = buildSchema(omnigraphSchemaSdl);
 
 export default function OmnigraphSchemaDocExplorer() {
-  return (
-    <div
-      style={{
-        border: "1px solid var(--sl-color-gray-5)",
-        borderRadius: "1rem",
-        paddingLeft: "1rem",
-        paddingTop: "1rem",
-        paddingBottom: "1rem",
-      }}
-    >
-      <div
-        className="graphiql-container"
-        style={{
-          maxHeight: "650px",
-          overflow: "auto",
-        }}
-        data-theme="light"
-      >
-        <GraphiQLProvider
-          defaultTheme="light"
-          schema={omnigraphSchema}
-          dangerouslyAssumeSchemaIsValid
-          fetcher={() => Promise.resolve({})}
-        >
-          <DocExplorer />
-        </GraphiQLProvider>
-      </div>
-    </div>
-  );
+  return <GraphQLSchemaDocExplorer schema={omnigraphSchema} />;
 }

docs/ensnode.io/src/components/organisms/SubgraphSchemaDocExplorer.tsx

@@ -0,0 +1,9 @@
+import subgraphSchemaSdl from "@data/subgraph-schema.graphql?raw";
+import { buildSchema } from "graphql";
+import GraphQLSchemaDocExplorer from "./GraphQLSchemaDocExplorer.tsx";
+
+const subgraphSchema = buildSchema(subgraphSchemaSdl);
+
+export default function SubgraphSchemaDocExplorer() {
+  return <GraphQLSchemaDocExplorer schema={subgraphSchema} />;
+}

docs/ensnode.io/src/content.config.ts

@@ -3,17 +3,6 @@ import { z } from "astro/zod";
 import { docsLoader } from "@astrojs/starlight/loaders";
 import { docsSchema } from "@astrojs/starlight/schema";
 
-import { exampleQuerySchema, savedQueries } from "./data/ens-v1-examples-queries";
-
-const examples = defineCollection({
-  loader: () =>
-    savedQueries.map((query) => ({
-      ...query,
-      id: query.id,
-    })),
-  schema: exampleQuerySchema,
-});
-
 export const collections = {
   docs: defineCollection({
     loader: docsLoader(),
@@ -24,5 +13,4 @@ export const collections = {
       }),
     }),
   }),
-  examples,
 };