Let's see if this works and makes it look better

Author: jschreuder

_config.yml

@@ -1 +1,23 @@
-remote_theme: pages-themes/cayman@v0.2.0
+title: "Middle Framework Guide"
+description: "Complete guide to building maintainable web applications with Middle Framework"
+
+# Use remote theme instead of gem
+remote_theme: just-the-docs/just-the-docs
+
+# Navigation
+nav_sort: case_insensitive
+nav_external_links:
+  - title: "Middle Framework on GitHub"
+    url: "https://github.com/jschreuder/Middle"
+
+# Footer
+footer_content: "Middle Framework: Explicit. Replaceable. Safe."
+
+# Optional: Color scheme
+color_scheme: light
+
+# Plugins (GitHub Pages compatible)
+plugins:
+  - jekyll-remote-theme
+  - jekyll-feed
+  - jekyll-sitemap

chapter1.md

@@ -1,6 +1,9 @@
 ---
-title: "Middle Framework - Chapter 1: Architecture Fundamentals"
+title: "Chapter 1"
+description: "Architecture Fundamentals"
 layout: default
+nav_order: 2
+permalink: /chapter1/
 ---
 
 # Chapter 1: Architecture Fundamentals

chapter2.md

@@ -1,6 +1,9 @@
 ---
-title: "Middle Framework - Chapter 2: Getting Started"
+title: "Chapter 2"
+description: "Getting Started"
 layout: default
+nav_order: 3
+permalink: /chapter2/
 ---
 
 # Chapter 2: Getting Started

chapter3.md

@@ -1,6 +1,9 @@
 ---
-title: "Middle Framework - Chapter 3: Interface Design Mastery"
+title: "Chapter 3"
+description: "Interface Design Mastery"
 layout: default
+nav_order: 4
+permalink: /chapter3/
 ---
 
 # Chapter 3: Interface Design Mastery

index.md

@@ -1,6 +1,9 @@
 ---
-title: "Middle Framework Guide"
 layout: default
+title: "Middle Framework Guide"
+description: "Complete guide to building maintainable web applications with explicit architecture"
+nav_order: 1
+permalink: /
 ---
 
 # Middle Framework Guide