npm - yakmesh - Versions diffs - 2.8.2 → 3.0.0 - Mend

yakmesh 2.8.2 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (232) hide show

package/CHANGELOG.md +637 -0
package/CONTRIBUTING.md +42 -0
package/Caddyfile +77 -0
package/README.md +119 -29
package/adapters/adapter-mlv-bible/README.md +124 -0
package/adapters/adapter-mlv-bible/index.js +400 -0
package/adapters/chat-mod-adapter.js +532 -0
package/adapters/content-adapter.js +273 -0
package/content/api.js +50 -41
package/content/index.js +2 -2
package/content/store.js +355 -173
package/dashboard/index.html +19 -3
package/database/replication.js +117 -37
package/docs/CRYPTO-AGILITY.md +204 -0
package/docs/MTLS-RESEARCH.md +367 -0
package/docs/NAMCHE-SPEC.md +681 -0
package/docs/PEERQUANTA-YAKMESH-INTEGRATION.md +407 -0
package/docs/PRECISION-DISCLOSURE.md +96 -0
package/docs/README.md +76 -0
package/docs/ROADMAP-2.4.0.md +447 -0
package/docs/ROADMAP-2.5.0.md +244 -0
package/docs/SECURITY-AUDIT-REPORT.md +306 -0
package/docs/SST-INTEGRATION.md +712 -0
package/docs/STEADYWATCH-IMPLEMENTATION.md +303 -0
package/docs/TERNARY-AUDIT-REPORT.md +247 -0
package/docs/TME-FAQ.md +221 -0
package/docs/WHITEPAPER.md +623 -0
package/docs/adapters.html +1001 -0
package/docs/advanced-systems.html +1045 -0
package/docs/annex.html +1046 -0
package/docs/api.html +970 -0
package/docs/business/response-templates.md +160 -0
package/docs/c2c.html +1225 -0
package/docs/cli.html +1332 -0
package/docs/configuration.html +1248 -0
package/docs/darshan.html +1085 -0
package/docs/dharma.html +966 -0
package/docs/docs-bundle.html +1075 -0
package/docs/docs.css +3120 -0
package/docs/docs.js +556 -0
package/docs/doko.html +969 -0
package/docs/geo-proof.html +858 -0
package/docs/getting-started.html +840 -0
package/docs/gumba-tutorial.html +1144 -0
package/docs/gumba.html +1098 -0
package/docs/index.html +914 -0
package/docs/jhilke.html +1312 -0
package/docs/karma.html +1100 -0
package/docs/katha.html +1037 -0
package/docs/lama.html +978 -0
package/docs/mandala.html +1067 -0
package/docs/mani.html +964 -0
package/docs/mantra.html +967 -0
package/docs/mesh.html +1409 -0
package/docs/nakpak.html +869 -0
package/docs/namche.html +928 -0
package/docs/nav-order.json +53 -0
package/docs/prahari.html +1043 -0
package/docs/prism-bash.min.js +1 -0
package/docs/prism-javascript.min.js +1 -0
package/docs/prism-json.min.js +1 -0
package/docs/prism-tomorrow.min.css +1 -0
package/docs/prism.min.js +1 -0
package/docs/privacy.html +699 -0
package/docs/quick-reference.html +1181 -0
package/docs/sakshi.html +1402 -0
package/docs/sandboxing.md +386 -0
package/docs/seva.html +911 -0
package/docs/sherpa.html +871 -0
package/docs/studio.html +860 -0
package/docs/stupa.html +995 -0
package/docs/tailwind.min.css +2 -0
package/docs/tattva.html +1332 -0
package/docs/terms.html +686 -0
package/docs/time-server-deployment.md +166 -0
package/docs/time-sources.html +1392 -0
package/docs/tivra.html +1127 -0
package/docs/trademark-policy.html +686 -0
package/docs/tribhuj.html +1183 -0
package/docs/trust-security.html +1029 -0
package/docs/tutorials/backup-recovery.html +654 -0
package/docs/tutorials/dashboard.html +604 -0
package/docs/tutorials/domain-setup.html +605 -0
package/docs/tutorials/host-website.html +456 -0
package/docs/tutorials/mesh-network.html +505 -0
package/docs/tutorials/mobile-access.html +445 -0
package/docs/tutorials/privacy.html +467 -0
package/docs/tutorials/raspberry-pi.html +600 -0
package/docs/tutorials/security-basics.html +539 -0
package/docs/tutorials/share-files.html +431 -0
package/docs/tutorials/troubleshooting.html +637 -0
package/docs/tutorials/trust-karma.html +419 -0
package/docs/tutorials/yak-protocol.html +456 -0
package/docs/tutorials.html +1034 -0
package/docs/vani.html +1270 -0
package/docs/webserver.html +809 -0
package/docs/yak-protocol.html +940 -0
package/docs/yak-timeserver-design.md +475 -0
package/docs/yakapp.html +1015 -0
package/docs/ypc27.html +1069 -0
package/docs/yurt.html +1344 -0
package/embedded-docs/bundle.js +334 -74
package/gossip/protocol.js +247 -27
package/identity/key-resolver.js +262 -0
package/identity/machine-seed.js +632 -0
package/identity/node-key.js +669 -368
package/identity/tribhuj-ratchet.js +506 -0
package/knowledge-base.js +37 -8
package/launcher/yakmesh.bat +62 -0
package/launcher/yakmesh.sh +70 -0
package/mesh/annex.js +462 -108
package/mesh/beacon-broadcast.js +113 -1
package/mesh/darshan.js +1718 -0
package/mesh/gumba.js +1567 -0
package/mesh/jhilke.js +651 -0
package/mesh/katha.js +1012 -0
package/mesh/nakpak-routing.js +8 -5
package/mesh/network.js +724 -34
package/mesh/pulse-sync.js +4 -1
package/mesh/rate-limiter.js +127 -15
package/mesh/seva.js +526 -0
package/mesh/sherpa-discovery.js +89 -8
package/mesh/sybil-defense.js +19 -5
package/mesh/temporal-encoder.js +4 -3
package/mesh/vani.js +1364 -0
package/mesh/yurt.js +1340 -0
package/models/entropy-sentinel.onnx +0 -0
package/models/karma-trust.onnx +0 -0
package/models/manifest.json +43 -0
package/models/sakshi-anomaly.onnx +0 -0
package/oracle/code-proof-protocol.js +7 -6
package/oracle/codebase-lock.js +257 -28
package/oracle/index.js +74 -15
package/oracle/ma902-snmp.js +678 -0
package/oracle/module-sealer.js +5 -3
package/oracle/network-identity.js +16 -0
package/oracle/packet-checksum.js +201 -0
package/oracle/sst.js +579 -0
package/oracle/ternary-144t.js +714 -0
package/oracle/ternary-ml.js +481 -0
package/oracle/time-api.js +239 -0
package/oracle/time-source.js +137 -47
package/oracle/validation-oracle-hardened.js +1111 -1071
package/oracle/validation-oracle.js +4 -2
package/oracle/ypc27.js +211 -0
package/package.json +20 -3
package/protocol/yak-handler.js +35 -9
package/protocol/yak-protocol.js +28 -13
package/reference/cpp/yakmesh_mceliece_shard.cpp +168 -0
package/reference/cpp/yakmesh_ypc27.cpp +179 -0
package/sbom.json +87 -0
package/scripts/security-audit.mjs +264 -0
package/scripts/update-docs-nav.js +194 -0
package/scripts/update-docs-sidebar.cjs +164 -0
package/security/crypto-config.js +4 -3
package/security/dharma-moderation.js +517 -0
package/security/doko-identity.js +193 -143
package/security/domain-consensus.js +86 -85
package/security/fs-hardening.js +620 -0
package/security/hardware-attestation.js +5 -3
package/security/hybrid-trust.js +227 -87
package/security/karma-rate-limiter.js +692 -0
package/security/khata-protocol.js +22 -21
package/security/khata-trust-integration.js +277 -150
package/security/memory-safety.js +635 -0
package/security/mesh-auth.js +11 -10
package/security/mesh-revocation.js +373 -5
package/security/namche-gateway.js +298 -69
package/security/sakshi.js +460 -3
package/security/sangha.js +770 -0
package/security/secure-config.js +473 -0
package/security/silicon-parity.js +13 -10
package/security/steadywatch.js +1142 -0
package/security/strike-system.js +32 -3
package/security/temporal-signing.js +488 -0
package/security/trit-commitment.js +464 -0
package/server/crypto/annex.js +247 -0
package/server/darshan-api.js +343 -0
package/server/index.js +3259 -362
package/server/komm-api.js +668 -0
package/utils/accel.js +2273 -0
package/utils/ternary-id.js +79 -0
package/utils/verify-worker.js +57 -0
package/webserver/index.js +95 -5
package/assets/yakmesh-logo.png +0 -0
package/assets/yakmesh-logo.svg +0 -80
package/assets/yakmesh-logo2.png +0 -0
package/assets/yakmesh-logo2sm.png +0 -0
package/assets/ymsm.png +0 -0
package/website/assets/silhouettes/adapters.svg +0 -107
package/website/assets/silhouettes/api-endpoints.svg +0 -115
package/website/assets/silhouettes/atomic-clock.svg +0 -83
package/website/assets/silhouettes/base-camp.svg +0 -81
package/website/assets/silhouettes/bridge.svg +0 -69
package/website/assets/silhouettes/docs-bundle.svg +0 -113
package/website/assets/silhouettes/doko-basket.svg +0 -70
package/website/assets/silhouettes/fortress.svg +0 -93
package/website/assets/silhouettes/gateway.svg +0 -54
package/website/assets/silhouettes/gears.svg +0 -93
package/website/assets/silhouettes/globe-satellite.svg +0 -67
package/website/assets/silhouettes/karma-wheel.svg +0 -137
package/website/assets/silhouettes/lama-council.svg +0 -141
package/website/assets/silhouettes/mandala-network.svg +0 -169
package/website/assets/silhouettes/mani-stones.svg +0 -149
package/website/assets/silhouettes/mantra-wheel.svg +0 -116
package/website/assets/silhouettes/mesh-nodes.svg +0 -113
package/website/assets/silhouettes/nakpak.svg +0 -56
package/website/assets/silhouettes/peak-lightning.svg +0 -73
package/website/assets/silhouettes/sherpa.svg +0 -69
package/website/assets/silhouettes/stupa-tower.svg +0 -119
package/website/assets/silhouettes/tattva-eye.svg +0 -78
package/website/assets/silhouettes/terminal.svg +0 -74
package/website/assets/silhouettes/webserver.svg +0 -145
package/website/assets/silhouettes/yak.svg +0 -78
package/website/assets/yakmesh-logo.png +0 -0
package/website/assets/yakmesh-logo.webp +0 -0
package/website/assets/yakmesh-logo128x140.webp +0 -0
package/website/assets/yakmesh-logo2.png +0 -0
package/website/assets/yakmesh-logo2.svg +0 -51
package/website/assets/yakmesh-logo40x44.webp +0 -0
package/website/assets/yakmesh.gif +0 -0
package/website/assets/yakmesh.ico +0 -0
package/website/assets/yakmesh.jpg +0 -0
package/website/assets/yakmesh.pdf +0 -0
package/website/assets/yakmesh.png +0 -0
package/website/assets/yakmesh.svg +0 -70
package/website/assets/yakmesh128.webp +0 -0
package/website/assets/yakmesh32.png +0 -0
package/website/assets/yakmesh32.svg +0 -65
package/website/assets/yakmesh32o.ico +0 -2
package/website/assets/yakmesh32o.svg +0 -65
package/website/assets/yakmesh32o.svgz +0 -0

package/docs/tutorials/host-website.html ADDED Viewed

@@ -0,0 +1,456 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="tutorials">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <link rel="icon" href="../favicon.ico" sizes="32x32">
+    <link rel="icon" href="../icon.svg" type="image/svg+xml">
+    <link rel="apple-touch-icon" href="../apple-touch-icon.png">
+    <title>Host a Website - YAKMESH Tutorials</title>
+    <meta name="description" content="Complete guide to hosting a static website with YAKMESH. From installation to exposing your site to the internet.">
+    <link rel="stylesheet" href="../tailwind.min.css">
+    <link rel="stylesheet" href="../prism-tomorrow.min.css">
+    <link rel="stylesheet" href="../docs.css">
+    <style>
+        .theme-accent { color: #10b981; }
+        .theme-badge { background: rgba(16, 185, 129, 0.2); color: #34d399; }
+        .tutorial-card { background: rgba(30, 41, 59, 0.5); border: 1px solid #334155; border-radius: 0.75rem; padding: 1.5rem; margin-bottom: 1.5rem; }
+        .tutorial-card:hover { border-color: #10b981; }
+        .step-number { display: inline-flex; align-items: center; justify-content: center; width: 2rem; height: 2rem; background: #10b981; color: white; border-radius: 50%; font-weight: bold; margin-right: 0.75rem; }
+        .theme-callout { background: rgba(16, 185, 129, 0.1); border: 1px solid #059669; border-radius: 0.75rem; padding: 1.5rem; margin: 1.5rem 0; }
+        .warning-callout { background: rgba(245, 158, 11, 0.1); border: 1px solid #d97706; border-radius: 0.75rem; padding: 1.5rem; margin: 1.5rem 0; }
+    </style>
+</head>
+<body class="bg-mountain-900 text-white min-h-screen">
+  <nav class="docs-sidebar" id="sidebar">
+    <a href="../index.html" class="sidebar-logo">
+      <span class="logo-icon">🏔️</span>
+      <span class="logo-text">Yakmesh</span>
+    </a>
+    <a href="/dashboard" class="sidebar-dashboard-link"><span>📊</span> <span>Dashboard</span></a>
+    <ul class="sidebar-nav">
+      <li><a href="../index.html"><span>🏠</span> <span>Overview</span></a></li>
+      <li><a href="../getting-started.html"><span>🚀</span> <span>Getting Started</span></a></li>
+      <li><a href="../tutorials.html"><span>📖</span> <span>Tutorials</span></a></li>
+      <li><a href="../yak-protocol.html"><span class="yak-icon"></span> <span>YAK://</span></a></li>
+      <li><a href="../annex.html"><span>🌉</span> <span>ANNEX</span></a></li>
+      <li><a href="../nakpak.html"><span>🎒</span> <span>NAKPAK</span></a></li>
+      <li><a href="../namche.html"><span>🚪</span> <span>NAMCHE</span></a></li>
+      <li><a href="../doko.html"><span>🧺</span> <span>DOKO</span></a></li>
+      <li><a href="../sherpa.html"><span>🧗</span> <span>SHERPA</span></a></li>
+      <li><a href="../mandala.html"><span>🌐</span> <span>MANDALA</span></a></li>
+      <li><a href="../mantra.html"><span>🕉️</span> <span>MANTRA</span></a></li>
+      <li><a href="../gumba.html"><span>🛕</span> <span>GUMBA</span></a></li>
+      <li><a href="../yurt.html"><span>🏕️</span> <span>YURT</span></a></li>
+      <li><a href="../katha.html"><span>💬</span> <span>KATHA</span></a></li>
+      <li><a href="../vani.html"><span>🎙️</span> <span>VANI</span></a></li>
+      <li><a href="../darshan.html"><span>👁️</span> <span>DARSHAN</span></a></li>
+      <li><a href="../stupa.html"><span>🛕</span> <span>STUPA</span></a></li>
+      <li><a href="../lama.html"><span>🔮</span> <span>LAMA</span></a></li>
+      <li><a href="../mani.html"><span>⏱️</span> <span>MANI</span></a></li>
+      <li><a href="../karma.html"><span>☯️</span> <span>KARMA</span></a></li>
+      <li><a href="../tattva.html"><span>🔯</span> <span>TATTVA</span></a></li>
+      <li><a href="../tribhuj.html"><span>🔺</span> <span>TRIBHUJ</span></a></li>
+      <li><a href="../ypc27.html"><span>🔐</span> <span>YPC-27</span></a></li>
+      <li><a href="../sakshi.html"><span>👁️</span> <span>SAKSHI</span></a></li>
+      <li><a href="../geo-proof.html"><span>🌍</span> <span>PRAMAAN</span></a></li>
+      <li><a href="../trust-security.html"><span>🔒</span> <span>SURAKSHA</span></a></li>
+      <li><a href="../docs-bundle.html"><span>📚</span> <span>GRANTH</span></a></li>
+      <li><a href="../api.html"><span>📡</span> <span>API</span></a></li>
+      <li><a href="../adapters.html"><span>🔌</span> <span>Adapters</span></a></li>
+      <li><a href="../studio.html"><span>🎨</span> <span>Studio</span></a></li>
+      <li><a href="../quick-reference.html"><span>📋</span> <span>Quick Ref</span></a></li>
+    </ul>
+  </nav>
+  <button class="sidebar-toggle" id="sidebarToggle" title="Toggle sidebar">
+    <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+      <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 19l-7-7 7-7m8 14l-7-7 7-7" />
+    </svg>
+  </button>
+  <div class="sidebar-overlay" id="sidebarOverlay"></div>
+  <main class="docs-main" id="mainContent">
+    <div class="docs-content">
+      <!-- Breadcrumb -->
+      <div class="mb-6">
+        <a href="../tutorials.html" class="theme-accent hover:underline">← Back to Tutorials</a>
+      </div>
+      <!-- Page Header -->
+      <div class="mb-8">
+        <div class="flex items-center gap-3 mb-2">
+          <span class="text-4xl">🌐</span>
+          <h1 class="text-4xl font-bold">Host a Website</h1>
+          <span class="theme-badge text-xs px-2 py-1 rounded-full">15 min</span>
+        </div>
+        <p class="theme-accent text-lg">Serve your site locally and expose it to the internet</p>
+        <p class="text-mountain-300 mt-2">
+          This tutorial walks you through hosting a complete static website using YAKMESH — from installation
+          to making your site accessible worldwide, no cloud providers needed.
+        </p>
+      </div>
+      <!-- What You'll Learn -->
+      <div class="theme-callout mb-8">
+        <h3 class="font-bold text-lg mb-3">📚 What You'll Learn</h3>
+        <ul class="text-mountain-300 space-y-2">
+          <li>• Install and initialize YAKMESH on your computer</li>
+          <li>• Understand the htdocs folder structure</li>
+          <li>• Create and configure your website</li>
+          <li>• Start the YAKMESH server</li>
+          <li>• Access your site locally and expose it to the internet</li>
+        </ul>
+      </div>
+      <!-- Prerequisites -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-lg mb-3">Prerequisites</h3>
+        <ul class="text-mountain-300 space-y-2">
+          <li>✓ Node.js 20 or later (22 LTS recommended)</li>
+          <li>✓ npm package manager</li>
+          <li>✓ A text editor (VS Code, Sublime, etc.)</li>
+          <li>✓ Basic understanding of HTML/CSS (helpful but not required)</li>
+        </ul>
+      </div>
+      <!-- Step 1: Install YAKMESH -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">1</span>
+          Install YAKMESH
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          Open your terminal and install YAKMESH globally from npm. This gives you access to the
+          <code class="bg-mountain-800 px-2 py-1 rounded">yakmesh</code> command from anywhere.
+        </p>
+        <pre class="language-bash"><code>npm install -g yakmesh</code></pre>
+        <p class="text-mountain-400 text-sm mt-4">
+          Alternatively, you can use npx to run commands without global installation:
+        </p>
+        <pre class="language-bash"><code>npx yakmesh --version</code></pre>
+      </div>
+      <!-- Step 2: Initialize Your Node -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">2</span>
+          Initialize Your Node
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          Create a new directory for your project and initialize YAKMESH inside it:
+        </p>
+        <pre class="language-bash"><code>mkdir my-website
+cd my-website
+yakmesh init</code></pre>
+        <p class="text-mountain-300 mt-4 mb-2">
+          This creates the following structure:
+        </p>
+        <pre class="language-text"><code>my-website/
+├── yakmesh.config.js    # Node configuration
+├── data/                # Node data (identity, logs, etc.)
+└── htdocs/              # Your website files go here!</code></pre>
+      </div>
+      <!-- Step 3: Understand the htdocs Folder -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">3</span>
+          Understand the htdocs Folder
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          The <code class="bg-mountain-800 px-2 py-1 rounded theme-accent">htdocs/</code> folder is your
+          web root — everything inside this folder is served by YAKMESH. Think of it like a traditional
+          Apache htdocs or Nginx html folder.
+        </p>
+        <div class="bg-mountain-800 rounded-lg p-4 mb-4">
+          <p class="text-sm text-mountain-400 mb-2">How URLs map to files:</p>
+          <ul class="text-mountain-300 text-sm space-y-1 font-mono">
+            <li>http://localhost:3000/ → htdocs/index.html</li>
+            <li>http://localhost:3000/about → htdocs/about.html</li>
+            <li>http://localhost:3000/css/style.css → htdocs/css/style.css</li>
+            <li>http://localhost:3000/images/logo.png → htdocs/images/logo.png</li>
+          </ul>
+        </div>
+        <p class="text-mountain-400 text-sm">
+          <strong>Tip:</strong> You can change the web root directory in <code class="bg-mountain-800 px-2 py-1 rounded">yakmesh.config.js</code>
+          if you prefer a different folder name.
+        </p>
+      </div>
+      <!-- Step 4: Create Your Website -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">4</span>
+          Create Your Website
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          Let's create a simple website. Create an <code class="bg-mountain-800 px-2 py-1 rounded">index.html</code>
+          file inside the htdocs folder:
+        </p>
+        <pre class="language-bash"><code># Create the file (or use your text editor)
+touch htdocs/index.html</code></pre>
+        <p class="text-mountain-300 mt-4 mb-4">
+          Add this content to <code class="bg-mountain-800 px-2 py-1 rounded">htdocs/index.html</code>:
+        </p>
+        <pre class="language-html"><code>&lt;!DOCTYPE html&gt;
+&lt;html lang="en"&gt;
+&lt;head&gt;
+    &lt;meta charset="UTF-8"&gt;
+    &lt;meta name="viewport" content="width=device-width, initial-scale=1.0"&gt;
+    &lt;title&gt;My YAKMESH Site&lt;/title&gt;
+    &lt;style&gt;
+        body {
+            font-family: system-ui, sans-serif;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 2rem;
+            background: #1e293b;
+            color: #f1f5f9;
+        }
+        h1 { color: #10b981; }
+        a { color: #34d399; }
+    &lt;/style&gt;
+&lt;/head&gt;
+&lt;body&gt;
+    &lt;h1&gt;Welcome to My Site!&lt;/h1&gt;
+    &lt;p&gt;This website is hosted on YAKMESH — a post-quantum secure mesh network.&lt;/p&gt;
+    &lt;p&gt;No cloud providers. No central servers. Just you and the mesh.&lt;/p&gt;
+&lt;/body&gt;
+&lt;/html&gt;</code></pre>
+      </div>
+      <!-- Step 5: Configure Your Server -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">5</span>
+          Configure Your Server (Optional)
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          Open <code class="bg-mountain-800 px-2 py-1 rounded">yakmesh.config.js</code> to customize your server settings.
+          Here's what a typical web hosting configuration looks like:
+        </p>
+        <pre class="language-javascript"><code>// yakmesh.config.js
+module.exports = {
+  // Server settings
+  port: 3000,                    // Web server port
+  host: '0.0.0.0',               // Listen on all interfaces
+  // Web hosting settings
+  webRoot: './htdocs',           // Web files directory
+  indexFile: 'index.html',       // Default index file
+  // Security settings
+  enableCORS: true,              // Allow cross-origin requests
+  maxRequestSize: '10mb',        // Max upload size
+  // Mesh network settings
+  enableMesh: true,              // Connect to YAKMESH network
+  enableAnnex: true,             // Enable ANNEX gateway
+  // Logging
+  logLevel: 'info',              // debug, info, warn, error
+};</code></pre>
+        <p class="text-mountain-400 text-sm mt-4">
+          The defaults work for most cases. Only modify if you need specific behavior.
+        </p>
+      </div>
+      <!-- Step 6: Start the Server -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">6</span>
+          Start the Server
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          You're ready to launch! Start your YAKMESH server:
+        </p>
+        <pre class="language-bash"><code>yakmesh start</code></pre>
+        <p class="text-mountain-300 mt-4 mb-4">
+          You should see output like this:
+        </p>
+        <pre class="language-text"><code>🐃 Starting Yakmesh Node...
+🔐 Securing codebase...
+✓ Codebase locked: 65 files protected
+🌐 Starting web server...
+✓ Web server running at http://localhost:3000
+✓ htdocs/ folder mounted as web root
+✓ Yakmesh Node is running!
+   Dashboard: http://localhost:3000/dashboard</code></pre>
+      </div>
+      <!-- Step 7: Access Your Site -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">7</span>
+          Access Your Site
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          Open your browser and navigate to:
+        </p>
+        <div class="bg-mountain-800 rounded-lg p-4 mb-4 text-center">
+          <a href="http://localhost:3000" class="theme-accent text-xl font-mono hover:underline" target="_blank">
+            http://localhost:3000
+          </a>
+        </div>
+        <p class="text-mountain-300 mb-4">
+          You should see your website! The dashboard is available at:
+        </p>
+        <div class="bg-mountain-800 rounded-lg p-4 text-center">
+          <a href="http://localhost:3000/dashboard" class="theme-accent text-xl font-mono hover:underline" target="_blank">
+            http://localhost:3000/dashboard
+          </a>
+        </div>
+      </div>
+      <!-- Step 8: Expose to the Internet -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          <span class="step-number">8</span>
+          Expose to the Internet
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          To make your site accessible from anywhere, you have several options:
+        </p>
+        <h4 class="font-bold text-lg mt-6 mb-3">Option A: ANNEX Gateway (Recommended)</h4>
+        <p class="text-mountain-300 mb-4">
+          ANNEX provides a built-in tunnel that gives your site a public URL without port forwarding:
+        </p>
+        <pre class="language-bash"><code># Enable ANNEX in your config, then restart
+yakmesh restart
+# Your site will be available at a .yak.link address
+# Check the dashboard for your public URL</code></pre>
+        <h4 class="font-bold text-lg mt-6 mb-3">Option B: YAK Protocol Link</h4>
+        <p class="text-mountain-300 mb-4">
+          Share content via the yak:// protocol — cryptographic links that identify your content globally:
+        </p>
+        <pre class="language-bash"><code># Register your htdocs folder
+yakmesh yak register ./htdocs
+# Output: yak://abc123...xyz/
+# Anyone with YAKMESH can access this link</code></pre>
+        <h4 class="font-bold text-lg mt-6 mb-3">Option C: Direct Port Forwarding</h4>
+        <p class="text-mountain-300 mb-4">
+          For advanced users, forward port 3000 on your router:
+        </p>
+        <ol class="text-mountain-300 space-y-2 ml-4">
+          <li>1. Log into your router's admin panel</li>
+          <li>2. Find "Port Forwarding" settings</li>
+          <li>3. Forward external port 80 → internal 3000</li>
+          <li>4. Your site is now at http://your-public-ip/</li>
+        </ol>
+      </div>
+      <!-- Using JavaScript -->
+      <div class="tutorial-card">
+        <h3 class="font-bold text-xl mb-4">
+          💻 Programmatic Hosting (JavaScript)
+        </h3>
+        <p class="text-mountain-300 mb-4">
+          You can also start a YAKMESH web server programmatically in your Node.js applications:
+        </p>
+        <pre class="language-javascript"><code>import { createNode } from 'yakmesh';
+async function startWebsite() {
+  // Create and configure the node
+  const node = await createNode({
+    port: 3000,
+    webRoot: './htdocs',
+    enableMesh: true,
+    enableAnnex: true
+  });
+  // Start the server
+  await node.start();
+  console.log('Website running at http://localhost:3000');
+  console.log('Dashboard at http://localhost:3000/dashboard');
+  // Get your public URL (if ANNEX is enabled)
+  const publicUrl = await node.getPublicUrl();
+  if (publicUrl) {
+    console.log('Public URL:', publicUrl);
+  }
+  // Register content with the yak:// protocol
+  const yakLink = await node.yak.register('./htdocs');
+  console.log('YAK Link:', yakLink);
+}
+startWebsite().catch(console.error);</code></pre>
+      </div>
+      <!-- Summary -->
+      <div class="theme-callout">
+        <h3 class="font-bold text-lg mb-3">✅ Summary</h3>
+        <p class="text-mountain-300 mb-4">
+          Congratulations! You've successfully hosted a website on YAKMESH. Here's what you accomplished:
+        </p>
+        <ul class="text-mountain-300 space-y-2">
+          <li>✓ Installed and initialized YAKMESH</li>
+          <li>✓ Created a static website in the htdocs folder</li>
+          <li>✓ Configured and started your server</li>
+          <li>✓ Made your site accessible locally and to the internet</li>
+        </ul>
+        <p class="text-mountain-400 text-sm mt-4">
+          <strong>Next:</strong> Learn how to share content using the yak:// protocol →
+        </p>
+      </div>
+      <!-- Troubleshooting -->
+      <div class="warning-callout mt-8">
+        <h3 class="font-bold text-lg mb-3" style="color: #fbbf24;">🔧 Troubleshooting</h3>
+        <ul class="text-mountain-300 space-y-3">
+          <li>
+            <strong>Port 3000 already in use?</strong><br>
+            <span class="text-mountain-400">Change the port in yakmesh.config.js or use: <code class="bg-mountain-800 px-2 py-1 rounded">yakmesh start --port 3001</code></span>
+          </li>
+          <li>
+            <strong>Site shows 404?</strong><br>
+            <span class="text-mountain-400">Make sure you have an index.html file in your htdocs folder.</span>
+          </li>
+          <li>
+            <strong>Can't access from other devices on LAN?</strong><br>
+            <span class="text-mountain-400">Ensure host is set to '0.0.0.0' in your config, and check your firewall settings.</span>
+          </li>
+        </ul>
+      </div>
+      <!-- Navigation Footer -->
+      <div class="border-t border-mountain-700 mt-12 pt-8">
+        <div class="flex flex-col sm:flex-row gap-4">
+          <a href="../tutorials.html" class="flex-1 block bg-mountain-800 border border-mountain-700 rounded-xl p-4 hover:border-emerald-500 transition group">
+            <div class="text-xs text-mountain-400 mb-1">← Back to</div>
+            <div class="flex items-center gap-2">
+              <span class="text-xl">📖</span>
+              <span class="font-semibold group-hover:text-emerald-400">All Tutorials</span>
+            </div>
+          </a>
+          <a href="yak-protocol.html" class="flex-1 block bg-mountain-800 border border-mountain-700 rounded-xl p-4 hover:border-emerald-500 transition group">
+            <div class="text-xs text-mountain-400 mb-1">Next →</div>
+            <div class="flex items-center gap-2">
+              <span class="text-xl">🐃</span>
+              <span class="font-semibold group-hover:text-emerald-400">YAK:// Protocol</span>
+            </div>
+          </a>
+        </div>
+      </div>
+    </div>
+  </main>
+  <script src="../prism.min.js"></script>
+  <script src="../prism-javascript.min.js"></script>
+  <script src="../prism-bash.min.js"></script>
+  <script src="../docs.js"></script>
+</body>
+</html>