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/mobile-access.html ADDED Viewed

@@ -0,0 +1,445 @@
+<!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>Mobile Access - YAKMESH Tutorials</title>
+    <meta name="description" content="Access and manage your YAKMESH node from your phone. Remote access, PWA installation, and security tips.">
+    <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-accent-hover:hover { color: #34d399; }
+        .theme-badge { background: rgba(16, 185, 129, 0.2); color: #34d399; }
+        .theme-border { border-color: #10b981; }
+        .theme-callout { background: rgba(16, 185, 129, 0.1); border-color: #059669; }
+        .active-link { background: rgba(16, 185, 129, 0.2) !important; color: #34d399 !important; }
+        .tutorial-card { background: rgba(30, 41, 59, 0.5); border: 1px solid #334155; border-radius: 0.75rem; padding: 1.5rem; margin-bottom: 1.5rem; }
+        .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; flex-shrink: 0; }
+        .step-header { display: flex; align-items: center; margin-bottom: 1rem; }
+    </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 -->
+      <nav class="mb-6">
+        <a href="../tutorials.html" class="text-mountain-400 hover:text-white transition">← Back to Tutorials</a>
+      </nav>
+      <!-- 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">Mobile Access</h1>
+          <span class="theme-badge text-xs px-2 py-1 rounded-full">10 min</span>
+        </div>
+        <p class="theme-accent text-lg">View and manage your node from your phone</p>
+        <p class="text-mountain-300 mt-2">
+          Access your YAKMESH dashboard from anywhere, install it as an app, and stay connected on the go.
+        </p>
+      </div>
+      <!-- What You'll Learn -->
+      <div class="tutorial-card">
+        <h2 class="text-xl font-bold mb-4">📋 What You'll Learn</h2>
+        <ul class="space-y-2 text-mountain-300">
+          <li>• Access your dashboard on the same network</li>
+          <li>• Set up remote access with Tailscale or ZeroTier</li>
+          <li>• Install the PWA on your phone's home screen</li>
+          <li>• Understand what you can manage remotely</li>
+          <li>• Security best practices for mobile access</li>
+        </ul>
+      </div>
+      <!-- Local Network Access -->
+      <div class="tutorial-card">
+        <div class="step-header">
+          <span class="step-number">1</span>
+          <h2 class="text-xl font-bold">Access on Your Home Network</h2>
+        </div>
+        <p class="text-mountain-300 mb-4">
+          When your phone is on the same WiFi network as your YAKMESH node, you can access it directly.
+        </p>
+        <h3 class="font-semibold text-lg mb-3">Find Your Node's Address</h3>
+        <pre class="language-bash mb-4"><code># On your YAKMESH node, find the local IP:
+hostname -I
+# Example output: 192.168.1.100
+# Or check the dashboard startup message:
+# Dashboard: http://192.168.1.100:3000/dashboard</code></pre>
+        <h3 class="font-semibold text-lg mb-3">Open in Mobile Browser</h3>
+        <ol class="list-decimal list-inside space-y-2 text-mountain-300 mb-4">
+          <li>Connect your phone to the same WiFi network</li>
+          <li>Open your mobile browser (Safari, Chrome, Firefox)</li>
+          <li>Enter: <code class="bg-mountain-800 px-2 py-1 rounded">http://192.168.1.100:3000/dashboard</code></li>
+          <li>Bookmark the page for quick access</li>
+        </ol>
+        <div class="theme-callout rounded-lg p-4 border">
+          <p class="font-semibold theme-accent mb-1">💡 Use mDNS for Easier Access</p>
+          <p class="text-sm text-mountain-300">
+            If your node has a hostname, try: <code class="bg-mountain-800 px-1 rounded">http://yakmesh-node.local:3000</code><br>
+            This works on most home networks without remembering the IP address.
+          </p>
+        </div>
+      </div>
+      <!-- Remote Access with Tailscale -->
+      <div class="tutorial-card">
+        <div class="step-header">
+          <span class="step-number">2</span>
+          <h2 class="text-xl font-bold">Remote Access with Tailscale</h2>
+        </div>
+        <p class="text-mountain-300 mb-4">
+          <a href="https://tailscale.com" class="theme-accent theme-accent-hover" target="_blank">Tailscale</a>
+          creates a secure private network that works from anywhere. Free for personal use.
+        </p>
+        <h3 class="font-semibold text-lg mb-3">Install on Your YAKMESH Node</h3>
+        <pre class="language-bash mb-4"><code># Install Tailscale (Linux/Raspberry Pi)
+curl -fsSL https://tailscale.com/install.sh | sh
+# Start and authenticate
+sudo tailscale up
+# Follow the link to authenticate in your browser
+# Note your Tailscale IP (usually 100.x.x.x)</code></pre>
+        <h3 class="font-semibold text-lg mb-3">Install on Your Phone</h3>
+        <ol class="list-decimal list-inside space-y-2 text-mountain-300 mb-4">
+          <li>Download Tailscale from App Store (iOS) or Play Store (Android)</li>
+          <li>Sign in with the same account you used on your node</li>
+          <li>Enable the VPN when prompted</li>
+          <li>Your phone is now on the same virtual network as your node!</li>
+        </ol>
+        <h3 class="font-semibold text-lg mb-3">Access Your Dashboard Remotely</h3>
+        <pre class="language-bash mb-4"><code># Find your node's Tailscale IP
+tailscale ip -4
+# Example: 100.64.0.1
+# Access from your phone (even on cellular):
+http://100.64.0.1:3000/dashboard</code></pre>
+        <div class="bg-mountain-800 rounded-lg p-4">
+          <p class="font-semibold text-white mb-2">✨ Tailscale Benefits</p>
+          <ul class="text-sm text-mountain-300 space-y-1">
+            <li>• <strong>No port forwarding needed</strong> - works behind any NAT/firewall</li>
+            <li>• <strong>End-to-end encrypted</strong> - WireGuard-based security</li>
+            <li>• <strong>Always connected</strong> - access from anywhere in the world</li>
+            <li>• <strong>Free tier</strong> - up to 100 devices for personal use</li>
+          </ul>
+        </div>
+      </div>
+      <!-- Alternative: ZeroTier -->
+      <div class="tutorial-card">
+        <div class="step-header">
+          <span class="step-number">3</span>
+          <h2 class="text-xl font-bold">Alternative: ZeroTier</h2>
+        </div>
+        <p class="text-mountain-300 mb-4">
+          <a href="https://zerotier.com" class="theme-accent theme-accent-hover" target="_blank">ZeroTier</a>
+          is another excellent option for creating a virtual private network.
+        </p>
+        <h3 class="font-semibold text-lg mb-3">Setup Overview</h3>
+        <pre class="language-bash mb-4"><code># Install ZeroTier on your node
+curl -s https://install.zerotier.com | sudo bash
+# Join a network (create one at my.zerotier.com first)
+sudo zerotier-cli join &lt;network-id&gt;
+# Check your ZeroTier IP
+sudo zerotier-cli listnetworks</code></pre>
+        <ol class="list-decimal list-inside space-y-2 text-mountain-300">
+          <li>Create a free account at <a href="https://my.zerotier.com" class="theme-accent theme-accent-hover" target="_blank">my.zerotier.com</a></li>
+          <li>Create a new network and note the Network ID</li>
+          <li>Install ZeroTier on your node and phone</li>
+          <li>Join the same network on both devices</li>
+          <li>Authorize both devices in the ZeroTier dashboard</li>
+          <li>Access your node using its ZeroTier IP</li>
+        </ol>
+      </div>
+      <!-- Install as PWA -->
+      <div class="tutorial-card">
+        <div class="step-header">
+          <span class="step-number">4</span>
+          <h2 class="text-xl font-bold">Install as a Phone App (PWA)</h2>
+        </div>
+        <p class="text-mountain-300 mb-4">
+          The YAKMESH dashboard is a Progressive Web App (PWA). Install it on your home screen for an app-like experience.
+        </p>
+        <h3 class="font-semibold text-lg mb-3">iOS (Safari)</h3>
+        <ol class="list-decimal list-inside space-y-2 text-mountain-300 mb-4">
+          <li>Open the dashboard URL in Safari</li>
+          <li>Tap the Share button (square with arrow)</li>
+          <li>Scroll down and tap <strong>"Add to Home Screen"</strong></li>
+          <li>Edit the name if desired, then tap <strong>"Add"</strong></li>
+          <li>The YAKMESH icon now appears on your home screen!</li>
+        </ol>
+        <h3 class="font-semibold text-lg mb-3">Android (Chrome)</h3>
+        <ol class="list-decimal list-inside space-y-2 text-mountain-300 mb-4">
+          <li>Open the dashboard URL in Chrome</li>
+          <li>Tap the three-dot menu (⋮)</li>
+          <li>Tap <strong>"Add to Home screen"</strong> or <strong>"Install app"</strong></li>
+          <li>Confirm the installation</li>
+          <li>Find YAKMESH in your app drawer!</li>
+        </ol>
+        <div class="theme-callout rounded-lg p-4 border">
+          <p class="font-semibold theme-accent mb-1">📲 PWA Features</p>
+          <ul class="text-sm text-mountain-300 space-y-1">
+            <li>• <strong>Full-screen mode</strong> - no browser UI clutter</li>
+            <li>• <strong>Offline support</strong> - cached pages work without connection</li>
+            <li>• <strong>Push notifications</strong> - get alerts about your node (if enabled)</li>
+            <li>• <strong>Fast launch</strong> - opens directly without typing URLs</li>
+          </ul>
+        </div>
+      </div>
+      <!-- What You Can Do Remotely -->
+      <div class="tutorial-card">
+        <div class="step-header">
+          <span class="step-number">5</span>
+          <h2 class="text-xl font-bold">What You Can Do Remotely</h2>
+        </div>
+        <h3 class="font-semibold text-lg mb-3">Full Access</h3>
+        <ul class="space-y-2 text-mountain-300 mb-4">
+          <li>✅ <strong>View Dashboard</strong> - See node status, peers, network health</li>
+          <li>✅ <strong>Monitor Metrics</strong> - Uptime, bandwidth, storage usage</li>
+          <li>✅ <strong>Browse Files</strong> - View shared content via YAK:// links</li>
+          <li>✅ <strong>Check Peers</strong> - See connected peers and their status</li>
+          <li>✅ <strong>View Logs</strong> - Debug issues remotely</li>
+        </ul>
+        <h3 class="font-semibold text-lg mb-3">Management Actions</h3>
+        <ul class="space-y-2 text-mountain-300 mb-4">
+          <li>✅ <strong>Connect/Disconnect Peers</strong> - Manage peer connections</li>
+          <li>✅ <strong>Share Content</strong> - Generate YAK:// links</li>
+          <li>✅ <strong>Update Settings</strong> - Change configuration (with API)</li>
+          <li>⚠️ <strong>Upload Files</strong> - Limited by mobile connection speed</li>
+          <li>❌ <strong>Restart Node</strong> - Requires SSH access (see below)</li>
+        </ul>
+        <h3 class="font-semibold text-lg mb-3">SSH for Advanced Control</h3>
+        <p class="text-mountain-300 mb-3">
+          For full admin access, use an SSH app on your phone:
+        </p>
+        <ul class="space-y-1 text-mountain-300">
+          <li>• <strong>iOS:</strong> Termius, Prompt, Blink Shell</li>
+          <li>• <strong>Android:</strong> Termux, JuiceSSH, ConnectBot</li>
+        </ul>
+        <pre class="language-bash mt-3"><code># Connect via Tailscale IP
+ssh pi@100.64.0.1
+# Restart YAKMESH
+sudo systemctl restart yakmesh</code></pre>
+      </div>
+      <!-- Security Considerations -->
+      <div class="tutorial-card">
+        <div class="step-header">
+          <span class="step-number">6</span>
+          <h2 class="text-xl font-bold">Security Considerations</h2>
+        </div>
+        <p class="text-mountain-300 mb-4">
+          Accessing your node remotely adds convenience but requires security awareness.
+        </p>
+        <h3 class="font-semibold text-lg mb-3">Best Practices</h3>
+        <div class="space-y-4">
+          <div class="bg-mountain-800 rounded-lg p-4">
+            <p class="font-semibold text-emerald-400 mb-1">✅ DO: Use VPN-based solutions</p>
+            <p class="text-sm text-mountain-300">
+              Tailscale and ZeroTier encrypt all traffic and don't expose ports to the internet.
+            </p>
+          </div>
+          <div class="bg-mountain-800 rounded-lg p-4">
+            <p class="font-semibold text-emerald-400 mb-1">✅ DO: Enable authentication</p>
+            <p class="text-sm text-mountain-300">
+              Configure dashboard authentication in <code class="bg-mountain-900 px-1 rounded">yakmesh.config.js</code>:
+            </p>
+            <pre class="language-javascript text-sm mt-2"><code>auth: {
+  enabled: true,
+  username: 'admin',
+  password: 'your-secure-password',
+}</code></pre>
+          </div>
+          <div class="bg-mountain-800 rounded-lg p-4">
+            <p class="font-semibold text-emerald-400 mb-1">✅ DO: Use HTTPS when possible</p>
+            <p class="text-sm text-mountain-300">
+              If accessing over the internet, set up SSL (see <a href="domain-setup.html" class="theme-accent theme-accent-hover">Domain Setup</a> tutorial).
+            </p>
+          </div>
+          <div class="bg-mountain-800 rounded-lg p-4">
+            <p class="font-semibold text-red-400 mb-1">❌ DON'T: Expose ports directly to internet</p>
+            <p class="text-sm text-mountain-300">
+              Avoid port forwarding 3000 or 9001 without authentication and SSL. Use Tailscale instead.
+            </p>
+          </div>
+          <div class="bg-mountain-800 rounded-lg p-4">
+            <p class="font-semibold text-red-400 mb-1">❌ DON'T: Use public WiFi without VPN</p>
+            <p class="text-sm text-mountain-300">
+              Always use Tailscale/ZeroTier when on untrusted networks. They encrypt your traffic.
+            </p>
+          </div>
+          <div class="bg-mountain-800 rounded-lg p-4">
+            <p class="font-semibold text-red-400 mb-1">❌ DON'T: Save passwords in browser on shared devices</p>
+            <p class="text-sm text-mountain-300">
+              Use a password manager instead, and enable biometric lock on your phone.
+            </p>
+          </div>
+        </div>
+      </div>
+      <!-- Quick Reference -->
+      <div class="tutorial-card">
+        <h2 class="text-xl font-bold mb-4">📋 Quick Reference</h2>
+        <div class="overflow-x-auto">
+          <table class="w-full text-sm">
+            <thead>
+              <tr class="border-b border-mountain-700">
+                <th class="text-left py-2 px-3">Access Method</th>
+                <th class="text-left py-2 px-3">Best For</th>
+                <th class="text-left py-2 px-3">Setup Difficulty</th>
+              </tr>
+            </thead>
+            <tbody class="text-mountain-300">
+              <tr class="border-b border-mountain-800">
+                <td class="py-2 px-3 font-semibold">Local WiFi</td>
+                <td class="py-2 px-3">Home use, no internet needed</td>
+                <td class="py-2 px-3 text-emerald-400">Easy</td>
+              </tr>
+              <tr class="border-b border-mountain-800">
+                <td class="py-2 px-3 font-semibold">Tailscale</td>
+                <td class="py-2 px-3">Remote access without port forwarding</td>
+                <td class="py-2 px-3 text-emerald-400">Easy</td>
+              </tr>
+              <tr class="border-b border-mountain-800">
+                <td class="py-2 px-3 font-semibold">ZeroTier</td>
+                <td class="py-2 px-3">Self-hosted network option</td>
+                <td class="py-2 px-3 text-yellow-400">Medium</td>
+              </tr>
+              <tr class="border-b border-mountain-800">
+                <td class="py-2 px-3 font-semibold">Domain + HTTPS</td>
+                <td class="py-2 px-3">Public access, sharing links</td>
+                <td class="py-2 px-3 text-orange-400">Advanced</td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+      </div>
+      <!-- Success -->
+      <div class="bg-emerald-900/30 border border-emerald-600 rounded-xl p-6 mb-8">
+        <h2 class="text-xl font-bold mb-2 text-emerald-400">🎉 Stay Connected!</h2>
+        <p class="text-mountain-300">
+          You can now access your YAKMESH node from your phone, whether you're on the couch
+          or halfway around the world. Install the PWA for the best experience, and use
+          Tailscale for secure remote access without the complexity of port forwarding.
+        </p>
+      </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="raspberry-pi.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">← Previous</div>
+            <div class="flex items-center gap-2">
+              <span class="text-xl">🍓</span>
+              <span class="font-semibold group-hover:text-emerald-400">Running on Raspberry Pi</span>
+            </div>
+          </a>
+          <a href="troubleshooting.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">Troubleshooting FAQ</span>
+            </div>
+          </a>
+        </div>
+      </div>
+    </div>
+  </main>
+  <footer class="docs-footer">
+    <p>© 2026 YAKMESH™</p>
+  </footer>
+  <script src="../prism.min.js"></script>
+  <script src="../prism-bash.min.js"></script>
+  <script src="../prism-javascript.min.js"></script>
+  <script src="../docs.js"></script>
+</body>
+</html>