Configure GitHub Pages: index.md, _config.yml, Jekyll front matter

Geramy · Geramy · commit cd646fd8b828 · 2026-03-18T07:11:29.000-07:00
- Rename Home.md → index.md (GitHub Pages entry point)
- Add _config.yml with jekyll-theme-cayman
- Add Jekyll front matter (layout: default, title) to all 17 docs
- Fix links to use extensionless paths for Jekyll routing
- Update version to v0.8.5-alpha
diff --git a/docs/Architecture.md b/docs/Architecture.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Architecture
+---
+
 # Architecture
 
 ## Table of Contents
diff --git a/docs/Building.md b/docs/Building.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Building from Source
+---
+
 # Building from Source
 
 ## Table of Contents
diff --git a/docs/Client-SDK.md b/docs/Client-SDK.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Client SDK Overview
+---
+
 # Client SDK Overview
 
 For the full SDK reference with code examples, see the [SDK Guide](SDK-Guide.md).
diff --git a/docs/Configuration.md b/docs/Configuration.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Configuration Reference
+---
+
 # Configuration Reference
 
 ## Table of Contents
diff --git a/docs/DNS-Discovery.md b/docs/DNS-Discovery.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: DNS Discovery
+---
+
 # DNS Discovery
 
 ## Table of Contents
diff --git a/docs/FAQ.md b/docs/FAQ.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Frequently Asked Questions
+---
+
 # Frequently Asked Questions
 
 ## What is Lemonade-Nexus?
diff --git a/docs/Frameworks-and-Libraries.md b/docs/Frameworks-and-Libraries.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Frameworks and Libraries
+---
+
 # Frameworks and Libraries
 
 ## Core Language: C++20
diff --git a/docs/Getting-Started.md b/docs/Getting-Started.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Getting Started
+---
+
 # Getting Started
 
 ## Prerequisites
diff --git a/docs/Home.md b/docs/Home.md
diff --git a/docs/IP-Ranges.md b/docs/IP-Ranges.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: IP Ranges and IPAM
+---
+
 # IP Ranges and IPAM
 
 ## Table of Contents
diff --git a/docs/Network-Architecture.md b/docs/Network-Architecture.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Network Architecture
+---
+
 # Network Architecture
 
 ## Network Topology
diff --git a/docs/Ports-and-Firewall.md b/docs/Ports-and-Firewall.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Ports and Firewall
+---
+
 # Ports and Firewall
 
 ## Table of Contents
diff --git a/docs/SDK-Guide.md b/docs/SDK-Guide.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: SDK Guide
+---
+
 # SDK Guide
 
 ## Table of Contents
diff --git a/docs/Security-Model.md b/docs/Security-Model.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Security Model
+---
+
 # Security Model
 
 ## Layers of Security
diff --git a/docs/Security.md b/docs/Security.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Security
+---
+
 # Security
 
 ## Table of Contents
diff --git a/docs/Why-Use-This.md b/docs/Why-Use-This.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Why Use Lemonade-Nexus?
+---
+
 # Why Use Lemonade-Nexus?
 
 ## Self-Hosted, Self-Sovereign
diff --git a/docs/Zero-Trust.md b/docs/Zero-Trust.md
@@ -1,3 +1,8 @@
+---
+layout: default
+title: Zero-Trust Architecture
+---
+
 # Zero-Trust Architecture
 
 ## What Zero-Trust Means Here
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -0,0 +1,12 @@
+title: Lemonade-Nexus
+description: Self-hosted, cryptographically secure WireGuard mesh VPN with zero-trust architecture
+theme: jekyll-theme-cayman
+baseurl: "/lemonade-nexus"
+url: "https://lemonade-sdk.github.io"
+
+markdown: kramdown
+highlighter: rouge
+
+exclude:
+  - Gemfile
+  - Gemfile.lock
diff --git a/docs/index.md b/docs/index.md
@@ -0,0 +1,42 @@
+---
+layout: default
+title: Home
+---
+
+# Lemonade-Nexus
+
+A self-hosted, cryptographically secure WireGuard mesh VPN with zero-trust architecture, federated relay servers, and democratic governance.
+
+## Documentation
+
+### Getting Started
+- [Getting Started](Getting-Started) — Build, install, configure, connect
+- [FAQ](FAQ) — Frequently asked questions
+- [Why Use This?](Why-Use-This) — What makes Lemonade-Nexus different
+
+### Architecture
+- [Architecture](Architecture) — System design, CRTP, gossip, data storage
+- [Network Architecture](Network-Architecture) — Topology diagrams, traffic flows
+- [DNS Discovery](DNS-Discovery) — SEIP/EP subdomains, NS slots, client discovery
+
+### Reference
+- [Ports and Firewall](Ports-and-Firewall) — All ports, iptables, MikroTik, UFW rules
+- [IP Ranges](IP-Ranges) — IPAM allocation, client/server/backbone ranges
+- [Configuration](Configuration) — CLI flags, environment variables, JSON config
+
+### Security
+- [Security](Security) — Cryptography, TEE, binary attestation, credentials
+- [Security Model](Security-Model) — Layered security architecture deep dive
+- [Zero Trust](Zero-Trust) — Trust tiers, attestation tokens, democratic governance
+
+### Development
+- [SDK Guide](SDK-Guide) — C++ and C API reference with examples and best practices
+- [Client SDK](Client-SDK) — SDK overview and linking
+- [Frameworks and Libraries](Frameworks-and-Libraries) — Tech stack and dependencies
+- [Building](Building) — Build instructions for all platforms
+
+## Quick Links
+
+- **Current version:** v0.8.5-alpha
+- **Repository:** [github.com/lemonade-sdk/lemonade-nexus](https://github.com/lemonade-sdk/lemonade-nexus)
+- **Issues:** [GitHub Issues](https://github.com/lemonade-sdk/lemonade-nexus/issues)
