[preview only] Docs 3.0 QA round 2 — all changes combined

cspell.json

@@ -159,6 +159,7 @@
     "testnet",
     "testnets",
     "thirdweb",
+    "topbar",
     "touchpoints",
     "tunnelmole",
     "tute",

docs.json

@@ -379,27 +379,50 @@
             ]
           }
         ]
+      },
+      {
+        "tab": "Resources",
+        "menu": [
+          {
+            "item": "Developer Portal",
+            "href": "https://developer.worldcoin.org"
+          },
+          {
+            "item": "World Tech Blog",
+            "href": "https://world.org/blog?blog_type=world-tech"
+          },
+          {
+            "item": "Open Source",
+            "href": "https://github.com/worldcoin"
+          },
+          {
+            "item": "Whitepaper",
+            "href": "https://whitepaper.world.org"
+          },
+          {
+            "item": "Ecosystem",
+            "href": "https://world.org/ecosystem"
+          }
+        ]
+      },
+      {
+        "tab": "Support",
+        "menu": [
+          {
+            "item": "Telegram Support Channel",
+            "href": "https://t.me/worlddevelopersupport"
+          },
+          {
+            "item": "Email Support",
+            "href": "mailto:developers@toolsforhumanity.com"
+          },
+          {
+            "item": "Mini Apps FAQ",
+            "href": "/mini-apps/more/faq"
+          }
+        ]
       }
-    ],
-    "global": {
-      "anchors": [
-        {
-          "anchor": "Telegram Support Channel",
-          "href": "https://t.me/worlddevelopersupport",
-          "icon": "telegram"
-        },
-        {
-          "anchor": "Email Support",
-          "href": "mailto:developers@toolsforhumanity.com",
-          "icon": "envelope"
-        },
-        {
-          "anchor": "GitHub",
-          "href": "https://github.com/worldcoin",
-          "icon": "github"
-        }
-      ]
-    }
+    ]
   },
   "logo": {
     "light": "/logo/world-developers.svg",
@@ -423,7 +446,37 @@
       "x": "https://x.com/worldnetwork",
       "github": "https://github.com/worldcoin",
       "discord": "https://world.org/discord"
-    }
+    },
+    "links": [
+      {
+        "items": [
+          {
+            "label": "About World",
+            "href": "https://world.org"
+          },
+          {
+            "label": "Developers",
+            "href": "https://world.org/developers"
+          },
+          {
+            "label": "Whitepaper",
+            "href": "https://whitepaper.world.org"
+          },
+          {
+            "label": "Open Source",
+            "href": "https://github.com/worldcoin"
+          },
+          {
+            "label": "Ecosystem",
+            "href": "https://world.org/ecosystem"
+          },
+          {
+            "label": "Careers",
+            "href": "https://world.org/careers"
+          }
+        ]
+      }
+    ]
   },
   "contextual": {
     "options": [

index.mdx

@@ -9,6 +9,7 @@ description: "Build Mini Apps, integrate World ID, and deploy on World Chain wit
 ---
 
 import { DeveloperStories } from "/snippets/developer-stories.jsx";
+import { NewsletterForm } from "/snippets/newsletter-form.jsx";
 
 {/* cspell:ignore worldcoin Estevez Jangwon Toktokhan Hyrax gigagas flashblock prismic */}
 
@@ -26,7 +27,7 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
 <Visibility for="humans">
 <div className="landing-container">
 
-<div style={{ marginBottom: "128px" }}>
+<div style={{ marginBottom: "160px" }}>
   <h1 className="landing-hero-title" style={{ margin: 0 }}>World Developer Docs</h1>
   <div className="landing-hero-sub">
     Integrate World ID and deploy on World Chain with official developer documentation.
@@ -37,7 +38,7 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
 
   <a href="/world-id/overview" className="product-card">
     <div className="product-card-tile">
-      <img src="/icons/landing/world-id.svg" alt="" className="product-card-icon" style={{ width: "40px", height: "40px", display: "block" }} />
+      <img src="/icons/landing/world-id.svg" alt="" className="product-card-icon" style={{ width: "32px", height: "32px", display: "block" }} />
     </div>
     <div>
       <div className="product-card-title" style={{ fontSize: "32px", lineHeight: 1.2, letterSpacing: "-0.32px", fontWeight: 300 }}>Integrate World ID</div>
@@ -47,7 +48,7 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
 
   <a href="/mini-apps" className="product-card">
     <div className="product-card-tile">
-      <img src="/icons/landing/mini-app.svg" alt="" className="product-card-icon" style={{ width: "40px", height: "40px", display: "block" }} />
+      <img src="/icons/landing/mini-app.svg" alt="" className="product-card-icon" style={{ width: "32px", height: "32px", display: "block" }} />
     </div>
     <div>
       <div className="product-card-title" style={{ fontSize: "32px", lineHeight: 1.2, letterSpacing: "-0.32px", fontWeight: 300 }}>Create a Mini App</div>
@@ -57,7 +58,7 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
 
   <a href="/agents/agent-kit/integrate" className="product-card">
     <div className="product-card-tile">
-      <img src="/icons/landing/agentkit.svg" alt="" className="product-card-icon" style={{ width: "40px", height: "40px", display: "block" }} />
+      <img src="/icons/landing/agentkit.svg" alt="" className="product-card-icon" style={{ width: "32px", height: "32px", display: "block" }} />
     </div>
     <div>
       <div className="product-card-title" style={{ fontSize: "32px", lineHeight: 1.2, letterSpacing: "-0.32px", fontWeight: 300 }}>AgentKit</div>
@@ -67,7 +68,7 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
 
   <a href="/world-chain" className="product-card">
     <div className="product-card-tile">
-      <img src="/icons/landing/world-chain.svg" alt="" className="product-card-icon" style={{ width: "40px", height: "40px", display: "block" }} />
+      <img src="/icons/landing/world-chain.svg" alt="" className="product-card-icon" style={{ width: "32px", height: "32px", display: "block" }} />
     </div>
     <div>
       <div className="product-card-title" style={{ fontSize: "32px", lineHeight: 1.2, letterSpacing: "-0.32px", fontWeight: 300 }}>World Chain</div>
@@ -77,7 +78,7 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
 
 </div>
 
-<div style={{ marginBottom: "192px" }}>
+<div style={{ marginBottom: "240px" }}>
   <DeveloperStories
     title="Developer stories"
     subtitle="See how developers build trusted, human-centered apps with World."
@@ -107,8 +108,8 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
   />
 </div>
 
-<div style={{ marginBottom: "128px" }}>
-  <div className="landing-section-title" style={{ marginBottom: "48px" }}>World Tech Updates</div>
+<div style={{ marginBottom: "240px" }}>
+  <div className="landing-section-title" style={{ marginBottom: "40px" }}>World Tech Updates</div>
   <div className="landing-updates">
     <a className="landing-update" href="https://world.org/blog/engineering/world-chain-full-block-access-lists" target="_blank" rel="noopener noreferrer">
       <div className="landing-update-title">World Chain launches full block access lists</div>
@@ -123,7 +124,7 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
       <p className="landing-update-desc">The new World ID 4.0 upgrade introduces account abstraction with multi-key support, transforming a World ID from a single secret into an abstract record in a public registry. This increases protocol resilience by allowing the introduction of multiple key support, portability, recovery and improved privacy.</p>
     </a>
   </div>
-  <a href="https://world.org/blog/engineering" target="_blank" rel="noopener noreferrer" className="landing-link" style={{ display: "inline-block", fontSize: "16px", marginTop: "32px", textDecoration: "none" }}>
+  <a href="https://world.org/blog?blog_type=world-tech" target="_blank" rel="noopener noreferrer" className="landing-link" style={{ display: "inline-block", fontSize: "16px", marginTop: "48px", textDecoration: "underline", textUnderlineOffset: "4px" }}>
     Go to World Tech
   </a>
 </div>
@@ -134,35 +135,10 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
 <div className="landing-footer">
   <div className="landing-footer-inner">
 
-    {/* Newsletter — uncomment when a subscribe endpoint exists.
-        Why it is disabled: world.org's form submits through a Next.js server
-        action (company-website src/actions/subscribe.ts) that calls Braze with
-        the server-side NEXT_SERVER_BRAZE_TOKEN. A static Mintlify site cannot
-        hold that secret, so this form needs either a public subscribe endpoint
-        from the web team or a Braze public-key integration before it can ship.
-        Endpoint proposed as https://github.com/worldcoin/company-website/pull/4481 —
-        once merged (plus its Cloudflare rate rule), point this form at
-        POST https://world.org/api/subscribe with body {email} and uncomment.
-
-    <div className="landing-newsletter">
-      <div style={{ display: "grid", gridTemplateColumns: "1fr 1fr", gap: "48px", alignItems: "center" }}>
-        <div className="landing-newsletter-title" style={{ fontSize: "40px", lineHeight: 1.2, letterSpacing: "-0.8px", fontWeight: 300 }}>
-          Subscribe to World Developers Newsletter
-        </div>
-        <div>
-          <form className="landing-email-field" style={{ display: "flex", alignItems: "center", borderRadius: "30px", padding: "10px 10px 10px 24px", gap: "12px" }}>
-            <input type="email" placeholder="Your email" className="landing-email-input" style={{ flex: 1, border: "none", outline: "none", fontSize: "20px", fontWeight: 300, background: "transparent", fontFamily: "inherit" }} />
-            <button type="submit" style={{ width: "40px", height: "40px", borderRadius: "20px", backgroundColor: "#181818", border: "none", cursor: "pointer", display: "flex", alignItems: "center", justifyContent: "center", flexShrink: 0 }}>
-              <svg width="16" height="16" viewBox="0 0 16 16" fill="none"><path d="M8.5 2.8L13.2 7.5H2V8.5H13.2L8.5 13.2L9.2 13.9L15.1 8L9.2 2.1L8.5 2.8Z" fill="white"/></svg>
-            </button>
-          </form>
-          <div style={{ fontSize: "12px", lineHeight: 1.4, color: "#9D9B96", marginTop: "24px" }}>
-            By entering your email address and clicking “Subscribe,” you consent to receive newsletters, marketing communications and ecosystem updates. For details on how we process your personal data, including your rights and how to exercise them, please review our <a href="https://world.org/legal/privacy-notice" target="_blank" style={{ textDecoration: "underline" }} className="landing-privacy-link">Privacy Notice</a>.
-          </div>
-        </div>
-      </div>
-    </div>
-    */}
+    {/* Newsletter — submits to world.org's public subscribe endpoint
+        (worldcoin/company-website#4481). If that endpoint is not live yet,
+        the form shows an explicit error instead of failing silently. */}
+    <NewsletterForm />
 
     {/* Footer links — single row per Docs 3.0: trademark left, links right */}
     <div className="landing-footer-links" style={{ display: "flex", justifyContent: "space-between", alignItems: "baseline", flexWrap: "wrap", gap: "24px 48px", fontSize: "16px", lineHeight: 1.4, fontWeight: 300 }}>
@@ -200,5 +176,5 @@ import { DeveloperStories } from "/snippets/developer-stories.jsx";
   - [World Chain launches full block access lists](https://world.org/blog/engineering/world-chain-full-block-access-lists) — World Chain now streams full EIP-7928 block access lists in every flashblock, enabling parallel block verification, faster validation, and a path toward gigagas-per-second throughput without increasing validator hardware requirements.
   - [Remainder: World's GKR prover for ML and more](https://world.org/blog/engineering/world-zkgpu-for-ml-and-more) — Remainder (Reasonable Machine Learning Doubly-Efficient Prover) is Tools for Humanity's open-sourced in-house GKR + Hyrax proof system. It enables World's users to run ML models locally over private data and prove that they executed them correctly.
   - [Introducing World ID 4.0 - Request for Comments](https://world.org/blog/engineering/introducing-world-id-4.0) — World ID 4.0 introduces account abstraction with multi-key support, transforming a World ID from a single secret into an abstract record in a public registry, improving resilience, portability, recovery and privacy.
-  - More at [World Tech](https://world.org/blog/engineering).
+  - More at [World Tech](https://world.org/blog?blog_type=world-tech).
 </Visibility>