Add official Catalyst links and align theme

Add a single Official links page and wire website/explorer/faucet into navbar/footer and relevant guides. Update styling for a cleaner light-first look with optional dark mode.

Made-with: Cursor

Author: TheNewAutonomy

README.md

@@ -40,6 +40,7 @@ npm run serve
 This repo is set up to build the site on every PR, and deploy `site/build/` to GitHub Pages on merges to `main`.
 
 Notes:
-- For project pages, Docusaurus uses `baseUrl: "/catalyst-docs/"`.
-- The deployed URL will be the org GitHub Pages host + repo path (example: `https://catalyst-network.github.io/catalyst-docs/`).
+- For the current setup (custom domain), the site is served from the domain root:
+  - `https://docs.catalystnet.org/`
+- If you host as a GitHub Pages **project site** instead, the site is served under `/<repo>/` and Docusaurus must use `baseUrl: "/catalyst-docs/"`.
 

site/docs/explorer/user-guide.md

@@ -7,6 +7,10 @@ title: Explorer user guide
 
 - The explorer URL for your network (public testnet or your operator’s explorer)
 
+Official public explorer:
+
+- `https://explorer.catalystnet.org/`
+
 ## Steps
 
 ### 1) Look up a transaction

site/docs/faucet/user-guide.md

@@ -7,9 +7,13 @@ The faucet is **testnet-only** and is intended to provide small amounts of KAT f
 
 ## You will need
 
-- Your address (EVM `address20`, `0x...`) as requested by the faucet UI/API
+- Your Catalyst **`pubkey32`** address (`0x` + 64 hex chars) as requested by the faucet UI/API
 - Access to the hosted faucet UI (or your operator’s faucet)
 
+Official public faucet:
+
+- `https://faucet.catalystnet.org/`
+
 ## Steps
 
 ### 1) Request funds via the UI

site/docs/index.md

@@ -6,6 +6,13 @@ sidebar_position: 1
 
 This is the public documentation hub for the Catalyst ecosystem.
 
+Official links:
+
+- **Website**: `https://catalystnet.org/`
+- **Explorer**: `https://explorer.catalystnet.org/`
+- **Faucet**: `https://faucet.catalystnet.org/`
+- **More**: see **[Official links](/docs/overview/official-links)**.
+
 ## Choose your path
 
 - **Everyday users**: start with **[Use cases (for everyone)](/docs/use-cases/send-money)** or **[Quickstart: use Catalyst apps](/docs/quickstarts/i-want-to-use-apps)**.

site/docs/overview/official-links.md

@@ -0,0 +1,28 @@
+---
+sidebar_position: 0
+title: Official links
+---
+
+Use these links consistently across the docs (and prefer them over “random” mirrors).
+
+## Website
+
+- `https://catalystnet.org/`
+
+## Explorer (public testnet)
+
+- `https://explorer.catalystnet.org/`
+
+## Faucet (public testnet)
+
+- `https://faucet.catalystnet.org/`
+
+## App downloads (coming soon)
+
+Add these once the pages exist:
+
+- **iOS App Store**: (TBD)
+- **Google Play**: (TBD)
+- **Chrome Web Store**: (TBD)
+- **Catalyst app store**: (TBD)
+

site/docusaurus.config.ts

@@ -10,6 +10,13 @@ const config: Config = {
   title: 'Catalyst Docs',
   tagline: 'Operators, wallets, builders, and protocol/RPC reference.',
   favicon: 'img/favicon.ico',
+  customFields: {
+    links: {
+      website: 'https://catalystnet.org/',
+      explorer: 'https://explorer.catalystnet.org/',
+      faucet: 'https://faucet.catalystnet.org/',
+    },
+  },
 
   // Future flags, see https://docusaurus.io/docs/api/docusaurus-config#future
   future: {
@@ -76,6 +83,8 @@ const config: Config = {
   themeConfig: {
     image: 'img/docusaurus-social-card.jpg',
     colorMode: {
+      defaultMode: 'light',
+      disableSwitch: false,
       respectPrefersColorScheme: true,
     },
     navbar: {
@@ -91,6 +100,30 @@ const config: Config = {
           position: 'left',
           label: 'Docs',
         },
+        {
+          to: '/docs/overview/official-links',
+          label: 'Links',
+          position: 'left',
+        },
+        {
+          type: 'search',
+          position: 'right',
+        },
+        {
+          href: 'https://catalystnet.org/',
+          label: 'Website',
+          position: 'right',
+        },
+        {
+          href: 'https://explorer.catalystnet.org/',
+          label: 'Explorer',
+          position: 'right',
+        },
+        {
+          href: 'https://faucet.catalystnet.org/',
+          label: 'Faucet',
+          position: 'right',
+        },
         {
           href: 'https://github.com/catalyst-network/catalyst-docs',
           label: 'GitHub',
@@ -101,6 +134,14 @@ const config: Config = {
     footer: {
       style: 'dark',
       links: [
+        {
+          title: 'Catalyst',
+          items: [
+            { label: 'Website', href: 'https://catalystnet.org/' },
+            { label: 'Explorer', href: 'https://explorer.catalystnet.org/' },
+            { label: 'Faucet', href: 'https://faucet.catalystnet.org/' },
+          ],
+        },
         {
           title: 'Docs',
           items: [

site/src/css/custom.css

@@ -6,25 +6,34 @@
 
 /* You can override the default Infima variables here. */
 :root {
-  --ifm-color-primary: #2e8555;
-  --ifm-color-primary-dark: #29784c;
-  --ifm-color-primary-darker: #277148;
-  --ifm-color-primary-darkest: #205d3b;
-  --ifm-color-primary-light: #33925d;
-  --ifm-color-primary-lighter: #359962;
-  --ifm-color-primary-lightest: #3cad6e;
+  /* Brand-ish neutral blue accent (easy on white backgrounds). */
+  --ifm-color-primary: #2563eb;
+  --ifm-color-primary-dark: #1d4ed8;
+  --ifm-color-primary-darker: #1e40af;
+  --ifm-color-primary-darkest: #1e3a8a;
+  --ifm-color-primary-light: #3b82f6;
+  --ifm-color-primary-lighter: #60a5fa;
+  --ifm-color-primary-lightest: #93c5fd;
+
+  --ifm-font-family-base: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica,
+    Arial, "Apple Color Emoji", "Segoe UI Emoji";
   --ifm-code-font-size: 95%;
   --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
 }
 
 /* For readability concerns, you should choose a lighter palette in dark mode. */
 [data-theme='dark'] {
-  --ifm-color-primary: #25c2a0;
-  --ifm-color-primary-dark: #21af90;
-  --ifm-color-primary-darker: #1fa588;
-  --ifm-color-primary-darkest: #1a8870;
-  --ifm-color-primary-light: #29d5b0;
-  --ifm-color-primary-lighter: #32d8b4;
-  --ifm-color-primary-lightest: #4fddbf;
+  --ifm-color-primary: #60a5fa;
+  --ifm-color-primary-dark: #3b82f6;
+  --ifm-color-primary-darker: #2563eb;
+  --ifm-color-primary-darkest: #1d4ed8;
+  --ifm-color-primary-light: #93c5fd;
+  --ifm-color-primary-lighter: #bfdbfe;
+  --ifm-color-primary-lightest: #dbeafe;
   --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
 }
+
+/* Subtle “product” feel: crisp header, white background. */
+.navbar {
+  border-bottom: 1px solid var(--ifm-toc-border-color);
+}