From 687251b1a9475f3d2ded251d98433cc4dac90c1a Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Tue, 18 Aug 2026 12:50:07 +0000
Subject: [PATCH 1/2] feat: add Discord and X links on landing, Grave, and
 Learn

Surface Nether's Discord and X accounts with official Clyde and X
marks (white/black, unmodified) and point Learn readers to Discord
for questions.

Co-authored-by: Rastsislau Lipski <rastsislaux@users.noreply.github.com>
---
 apps/web/public/social/discord.svg            |  4 ++
 apps/web/public/social/x.svg                  |  4 ++
 apps/web/src/components/Header.astro          |  2 +
 apps/web/src/components/MobileChrome.tsx      |  7 +++
 apps/web/src/components/SocialLinks.tsx       | 46 +++++++++++++++
 apps/web/src/components/SocialMark.tsx        | 16 +++++
 .../src/components/dashboard/DashboardApp.tsx |  3 +
 apps/web/src/lib/site.ts                      |  2 +
 apps/web/src/lib/social.test.ts               | 36 ++++++++++++
 apps/web/src/lib/social.ts                    | 11 ++++
 apps/web/src/pages/index.astro                |  2 +
 apps/web/src/pages/learn.astro                | 58 ++++++++++++++++++-
 12 files changed, 190 insertions(+), 1 deletion(-)
 create mode 100644 apps/web/public/social/discord.svg
 create mode 100644 apps/web/public/social/x.svg
 create mode 100644 apps/web/src/components/SocialLinks.tsx
 create mode 100644 apps/web/src/components/SocialMark.tsx
 create mode 100644 apps/web/src/lib/social.test.ts
 create mode 100644 apps/web/src/lib/social.ts

diff --git a/apps/web/public/social/discord.svg b/apps/web/public/social/discord.svg
new file mode 100644
index 0000000..e196d6f
--- /dev/null
+++ b/apps/web/public/social/discord.svg
@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img">
+  <title>Discord</title>
+  <path fill="#000000" d="M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 00-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z"/>
+</svg>
diff --git a/apps/web/public/social/x.svg b/apps/web/public/social/x.svg
new file mode 100644
index 0000000..a77d253
--- /dev/null
+++ b/apps/web/public/social/x.svg
@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" role="img">
+  <title>X</title>
+  <path fill="#000000" d="M18.901 1.153h3.68l-8.04 9.19L24 22.846h-7.406l-5.8-7.584-6.638 7.584H.474l8.6-9.83L0 1.154h7.594l5.243 6.932ZM17.61 20.644h2.039L6.486 3.24H4.298Z"/>
+</svg>
diff --git a/apps/web/src/components/Header.astro b/apps/web/src/components/Header.astro
index dbd0f4b..293314a 100644
--- a/apps/web/src/components/Header.astro
+++ b/apps/web/src/components/Header.astro
@@ -3,6 +3,7 @@ import ExternalLink from '@lucide/astro/icons/external-link';
 import { GITHUB_REPO_URL, withBase } from '../lib/site';
 import { HeaderActions } from './HeaderActions.tsx';
 import { MobileChrome } from './MobileChrome.tsx';
+import { SocialLinks } from './SocialLinks.tsx';
 
 const homeHref = withBase();
 const learnHref = withBase('learn');
@@ -45,6 +46,7 @@ function tabClass(active: boolean): string {
       <ExternalLink class="h-3 w-3 text-accent" stroke-width={1.5} aria-hidden="true" />
       <span class="sr-only">(opens in a new tab)</span>
     </a>
+    <SocialLinks className="flex items-center gap-3" />
   </nav>
   <div class="hidden justify-self-end md:block">
     <HeaderActions client:load />
diff --git a/apps/web/src/components/MobileChrome.tsx b/apps/web/src/components/MobileChrome.tsx
index 1fd6840..858f142 100644
--- a/apps/web/src/components/MobileChrome.tsx
+++ b/apps/web/src/components/MobileChrome.tsx
@@ -3,6 +3,7 @@ import { ExternalLink, Menu, X } from 'lucide-react';
 import { WalletProviders } from './wallet/WalletProviders.tsx';
 import { NetworkSwitch } from './NetworkSwitch.tsx';
 import { ConnectButton } from './wallet/ConnectButton.tsx';
+import { SocialLinks } from './SocialLinks.tsx';
 
 export function MobileChrome({
   learnHref,
@@ -89,6 +90,12 @@ export function MobileChrome({
                 <ExternalLink className="h-3.5 w-3.5 text-accent" strokeWidth={1.5} aria-hidden="true" />
                 <span className="sr-only">(opens in a new tab)</span>
               </a>
+              <SocialLinks
+                labeled
+                className="flex flex-col gap-4"
+                iconClass="h-3.5 w-3.5"
+                linkClass="inline-flex items-center gap-1.5 text-sm tracking-[0.22em] text-white uppercase"
+              />
             </nav>
             <div className="mt-6">
               <NetworkSwitch />
diff --git a/apps/web/src/components/SocialLinks.tsx b/apps/web/src/components/SocialLinks.tsx
new file mode 100644
index 0000000..e66636e
--- /dev/null
+++ b/apps/web/src/components/SocialLinks.tsx
@@ -0,0 +1,46 @@
+import { DISCORD_URL, X_URL } from '../lib/site.ts';
+import { SocialMark } from './SocialMark.tsx';
+
+const ITEMS = [
+  { name: 'discord' as const, href: DISCORD_URL, label: 'Discord' },
+  { name: 'x' as const, href: X_URL, label: 'X' },
+] as const;
+
+export function SocialLinks({
+  labeled = false,
+  className,
+  iconClass,
+  linkClass,
+}: {
+  labeled?: boolean;
+  className?: string;
+  iconClass?: string;
+  linkClass?: string;
+}) {
+  const markClass = iconClass ?? (labeled ? 'h-3.5 w-3.5' : 'h-4 w-4');
+  const itemClass =
+    linkClass ??
+    (labeled
+      ? 'inline-flex items-center gap-1.5 text-[0.65rem] font-normal tracking-[0.28em] text-white uppercase md:text-[0.7rem]'
+      : 'inline-flex items-center justify-center p-1 text-paper/80 hover:text-white focus-visible:outline focus-visible:outline-1 focus-visible:outline-offset-2 focus-visible:outline-accent');
+
+  return (
+    <div role="group" aria-label="Social" className={className ?? 'flex items-center gap-3'}>
+      {ITEMS.map((item) => (
+        <a
+          key={item.name}
+          href={item.href}
+          rel="noopener noreferrer"
+          target="_blank"
+          className={itemClass}
+        >
+          <SocialMark name={item.name} className={markClass} />
+          {labeled ? item.label : null}
+          <span className="sr-only">
+            {labeled ? '(opens in a new tab)' : `${item.label} (opens in a new tab)`}
+          </span>
+        </a>
+      ))}
+    </div>
+  );
+}
diff --git a/apps/web/src/components/SocialMark.tsx b/apps/web/src/components/SocialMark.tsx
new file mode 100644
index 0000000..b57a773
--- /dev/null
+++ b/apps/web/src/components/SocialMark.tsx
@@ -0,0 +1,16 @@
+import { DISCORD_MARK_PATH, DISCORD_MARK_VIEWBOX, X_MARK_PATH, X_MARK_VIEWBOX } from '../lib/social.ts';
+
+export function SocialMark({ name, className }: { name: 'discord' | 'x'; className?: string }) {
+  const viewBox = name === 'discord' ? DISCORD_MARK_VIEWBOX : X_MARK_VIEWBOX;
+  const path = name === 'discord' ? DISCORD_MARK_PATH : X_MARK_PATH;
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox={viewBox}
+      className={className ? `shrink-0 ${className}` : 'shrink-0'}
+      aria-hidden="true"
+    >
+      <path d={path} fill="currentColor" />
+    </svg>
+  );
+}
diff --git a/apps/web/src/components/dashboard/DashboardApp.tsx b/apps/web/src/components/dashboard/DashboardApp.tsx
index 68c3bc3..bf5fd5d 100644
--- a/apps/web/src/components/dashboard/DashboardApp.tsx
+++ b/apps/web/src/components/dashboard/DashboardApp.tsx
@@ -9,6 +9,7 @@ import { MIN_GAS_RESERVE_WEI } from '../../lib/slippage.ts';
 import { simulateThenSend, waitOneConfirmation, type WalletWriter } from '../../lib/tx.ts';
 import { isUserRejected, revertShortMessage } from '../../lib/errors.ts';
 import { useLiveSnapshot } from '../useLiveSnapshot.ts';
+import { SocialLinks } from '../SocialLinks.tsx';
 import { WalletProviders } from '../wallet/WalletProviders.tsx';
 import { WrongNetworkBanner } from '../wallet/WrongNetworkBanner.tsx';
 import { BuryForm } from './BuryForm.tsx';
@@ -261,6 +262,7 @@ function DashboardBody() {
     return (
       <div className="px-5 py-10 md:px-10 md:py-14">
         <RpcDown network={network} contracts={contracts} onRetry={retry} />
+        <SocialLinks className="mt-8 flex items-center gap-4" />
         <MobileDock />
       </div>
     );
@@ -378,6 +380,7 @@ function DashboardBody() {
         onChain={onChain}
         nethBalance={nethBalance}
       />
+      <SocialLinks className="flex items-center gap-4 px-1 pt-1 md:pt-2" />
       <MobileDock />
     </div>
   );
diff --git a/apps/web/src/lib/site.ts b/apps/web/src/lib/site.ts
index b96fe0f..55d6890 100644
--- a/apps/web/src/lib/site.ts
+++ b/apps/web/src/lib/site.ts
@@ -47,6 +47,8 @@ export const STATS: readonly Stat[] = [
 
 export const GITHUB_REPO_FALLBACK = 'https://github.com/rastsislaux/nether';
 export const GITHUB_REPO_URL = githubRepoUrl();
+export const DISCORD_URL = 'https://discord.gg/N9mTHr5VE';
+export const X_URL = 'https://x.com/netherprotocol';
 
 export const RISK_WARNING =
   'Capital at high risk, team does not hold any responsibility for possible losses. Hover for details.';
diff --git a/apps/web/src/lib/social.test.ts b/apps/web/src/lib/social.test.ts
new file mode 100644
index 0000000..51234b7
--- /dev/null
+++ b/apps/web/src/lib/social.test.ts
@@ -0,0 +1,36 @@
+import assert from 'node:assert/strict';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { describe, it } from 'node:test';
+import { fileURLToPath } from 'node:url';
+import { DISCORD_URL, X_URL } from './site.ts';
+import {
+  DISCORD_MARK_FILE,
+  DISCORD_MARK_PATH,
+  DISCORD_MARK_VIEWBOX,
+  X_MARK_FILE,
+  X_MARK_PATH,
+  X_MARK_VIEWBOX,
+} from './social.ts';
+
+describe('social links', () => {
+  const publicDir = join(dirname(fileURLToPath(import.meta.url)), '../../public');
+
+  it('points at Nether Discord and X accounts', () => {
+    assert.equal(DISCORD_URL, 'https://discord.gg/N9mTHr5VE');
+    assert.equal(X_URL, 'https://x.com/netherprotocol');
+  });
+
+  it('publishes unmodified Discord and X marks', () => {
+    for (const [file, path, viewBox] of [
+      [DISCORD_MARK_FILE, DISCORD_MARK_PATH, DISCORD_MARK_VIEWBOX],
+      [X_MARK_FILE, X_MARK_PATH, X_MARK_VIEWBOX],
+    ] as const) {
+      assert.equal(existsSync(join(publicDir, file)), true, file);
+      const svg = readFileSync(join(publicDir, file), 'utf8');
+      assert.ok(svg.includes(path));
+      assert.ok(svg.includes(`viewBox="${viewBox}"`));
+      assert.ok(svg.includes('fill="#000000"'));
+    }
+  });
+});
diff --git a/apps/web/src/lib/social.ts b/apps/web/src/lib/social.ts
new file mode 100644
index 0000000..33673b5
--- /dev/null
+++ b/apps/web/src/lib/social.ts
@@ -0,0 +1,11 @@
+export const DISCORD_MARK_FILE = 'social/discord.svg';
+export const X_MARK_FILE = 'social/x.svg';
+
+export const DISCORD_MARK_VIEWBOX = '0 0 24 24';
+export const X_MARK_VIEWBOX = '0 0 24 24';
+
+export const DISCORD_MARK_PATH =
+  'M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 00-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z';
+
+export const X_MARK_PATH =
+  'M18.901 1.153h3.68l-8.04 9.19L24 22.846h-7.406l-5.8-7.584-6.638 7.584H.474l8.6-9.83L0 1.154h7.594l5.243 6.932ZM17.61 20.644h2.039L6.486 3.24H4.298Z';
diff --git a/apps/web/src/pages/index.astro b/apps/web/src/pages/index.astro
index 51acbf4..5fb32b6 100644
--- a/apps/web/src/pages/index.astro
+++ b/apps/web/src/pages/index.astro
@@ -4,6 +4,7 @@ import FeatureIcon from '../components/FeatureIcons.astro';
 import GraveCta from '../components/GraveCta.astro';
 import { HolderStats } from '../components/HolderStats.tsx';
 import RiskWarning from '../components/RiskWarning.astro';
+import { SocialLinks } from '../components/SocialLinks.tsx';
 import {
   FEATURES,
   HOLDER_COPY,
@@ -44,6 +45,7 @@ const heroSrc = withBase('hero.png');
             {SECONDARY_CTA}
           </a>
         </div>
+        <SocialLinks className="mt-5 flex items-center gap-4" iconClass="h-5 w-5" />
         <div class="mt-4">
           <RiskWarning />
         </div>
diff --git a/apps/web/src/pages/learn.astro b/apps/web/src/pages/learn.astro
index 6b3782e..7279d43 100644
--- a/apps/web/src/pages/learn.astro
+++ b/apps/web/src/pages/learn.astro
@@ -21,7 +21,8 @@ import {
   formatLearnNumber,
   hasIndependentProductionAudit,
 } from '../lib/learn';
-import { GITHUB_REPO_URL, withBase } from '../lib/site';
+import { DISCORD_URL, GITHUB_REPO_URL, X_URL, withBase } from '../lib/site';
+import { SocialMark } from '../components/SocialMark.tsx';
 
 const docsHref = withBase('docs');
 const specHref = withBase('docs/protocol-spec');
@@ -138,6 +139,7 @@ const toc = [
   { href: '#strategy-losses', label: 'Strategy losses' },
   { href: '#allocation', label: 'Token allocation' },
   { href: '#faq', label: 'FAQ' },
+  { href: '#community', label: 'Questions' },
   { href: '#risks', label: 'Risks' },
   { href: '#verify', label: 'Verify it' },
 ] as const;
@@ -684,6 +686,24 @@ const toc = [
             )
           }
         </FaqItem>
+        <FaqItem question="Where can I ask questions?">
+          <p>
+            If you have questions, you can ask them in{' '}
+            <a href={DISCORD_URL} rel="noopener noreferrer" target="_blank">
+              Nether's Discord
+              <span class="sr-only">, opens in a new tab</span>
+            </a>
+            .
+          </p>
+          <p>
+            Protocol updates are also posted on{' '}
+            <a href={X_URL} rel="noopener noreferrer" target="_blank">
+              X
+              <span class="sr-only">, opens in a new tab</span>
+            </a>
+            .
+          </p>
+        </FaqItem>
         <FaqItem question="Where can I verify the protocol?">
           <ul>
             <li>
@@ -711,6 +731,42 @@ const toc = [
       </div>
     </section>
 
+    <section class="learn-section" id="community" aria-labelledby="learn-community">
+      <h2 id="learn-community" class="learn-heading">Questions?</h2>
+      <p class="mt-4 max-w-2xl text-sm leading-relaxed text-paper">
+        If you have questions, you can ask them in Nether's Discord. Follow along on X for updates.
+      </p>
+      <div class="mt-8 grid gap-4 md:grid-cols-2">
+        <a
+          class="learn-card learn-card-link"
+          href={DISCORD_URL}
+          rel="noopener noreferrer"
+          target="_blank"
+        >
+          <SocialMark name="discord" className="h-6 w-6 text-white" />
+          <h3 class="mt-3 text-[0.7rem] tracking-[0.22em] text-accent uppercase">
+            Discord
+            <ExternalLink class="ml-1.5 inline h-3.5 w-3.5 align-[-0.1em]" stroke-width={1.5} />
+          </h3>
+          <p class="mt-2 text-sm leading-relaxed text-paper/90">
+            Ask questions in Nether's Discord community.
+          </p>
+          <span class="sr-only">, opens in a new tab</span>
+        </a>
+        <a class="learn-card learn-card-link" href={X_URL} rel="noopener noreferrer" target="_blank">
+          <SocialMark name="x" className="h-6 w-6 text-white" />
+          <h3 class="mt-3 text-[0.7rem] tracking-[0.22em] text-accent uppercase">
+            X
+            <ExternalLink class="ml-1.5 inline h-3.5 w-3.5 align-[-0.1em]" stroke-width={1.5} />
+          </h3>
+          <p class="mt-2 text-sm leading-relaxed text-paper/90">
+            Follow @netherprotocol for protocol updates.
+          </p>
+          <span class="sr-only">, opens in a new tab</span>
+        </a>
+      </div>
+    </section>
+
     <section class="learn-section learn-risks" id="risks" aria-labelledby="learn-risks">
       <h2 id="learn-risks" class="learn-heading">Understand the risks</h2>
       <p class="mt-4 max-w-2xl text-sm leading-relaxed text-paper">

From 8d819d3de8789b2ddb7ba9e414b947026dba484f Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Tue, 18 Aug 2026 13:02:08 +0000
Subject: [PATCH 2/2] fix: place landing Discord and X icons beside Learn

Co-authored-by: Rastsislau Lipski <rastsislaux@users.noreply.github.com>
---
 apps/web/src/pages/index.astro | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/web/src/pages/index.astro b/apps/web/src/pages/index.astro
index 5fb32b6..9488da1 100644
--- a/apps/web/src/pages/index.astro
+++ b/apps/web/src/pages/index.astro
@@ -44,8 +44,8 @@ const heroSrc = withBase('hero.png');
           >
             {SECONDARY_CTA}
           </a>
+          <SocialLinks className="flex items-center gap-3" iconClass="h-5 w-5" />
         </div>
-        <SocialLinks className="mt-5 flex items-center gap-4" iconClass="h-5 w-5" />
         <div class="mt-4">
           <RiskWarning />
         </div>