docs: configure Jekyll Just the Docs theme for GitHub Pages

night-slayer18 · night-slayer18 · commit 28fa9ddd1435 · 2026-06-07T13:10:30.000+05:30
Add Jekyll front matter to all markdown guides and create docs/_config.yml
configured for GitHub Pages using the just-the-docs theme.

Signed-off-by: night-slayer18 &lt;samanuaia257@gmail.com&gt;
diff --git a/docs/README.md b/docs/README.md
@@ -1,3 +1,10 @@
+---
+layout: default
+title: Welcome
+nav_order: 1
+permalink: /
+---
+
 # Runtime documentation
 
 Documentation index for the Runtime monorepo. Start with the project [README](../README.md) for an overview and quick start.
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -0,0 +1,14 @@
+# Book settings
+title: "Runtime"
+description: "A family of terminal-native developer tools built with Go and Bubble Tea."
+theme: "just-the-docs"
+
+# URL configuration (for GitHub Pages hosting)
+url: "https://night-slayer18.github.io"
+baseurl: "/runtime"
+
+# Navigation settings
+nav_sort: "nav_order"
+
+# Theme settings
+color_scheme: "dark"
diff --git a/docs/architecture.md b/docs/architecture.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Architecture
+nav_order: 2
+---
+
 # Architecture
 
 Runtime is a Go monorepo of independently versioned modules: five applications under `apps/` and eleven shared packages under `packages/`. This document describes how the pieces fit together.
diff --git a/docs/configuration.md b/docs/configuration.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Configuration & Themes
+nav_order: 3
+---
+
 # Configuration
 
 Every Runtime application shares one configuration model, provided by the `packages/config` module. Configuration is per-app, stored as JSON in the platform's standard config directory, and applied on startup. The schema is compatible across all apps, so knowledge transfers between them.
diff --git a/docs/grid.md b/docs/grid.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Grid (Tabular)
+nav_order: 4
+---
+
 # runtime-grid
 
 Tabular data workbench. Grid imports a data file into a virtualized table you can navigate and filter entirely from the keyboard.
diff --git a/docs/prism.md b/docs/prism.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Prism (Documents)
+nav_order: 5
+---
+
 # runtime-prism
 
 Structured document explorer. Prism parses a document into a navigable tree you can expand, collapse, and search by key or value.
diff --git a/docs/pulse.md b/docs/pulse.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Pulse (Logs)
+nav_order: 6
+---
+
 # runtime-pulse
 
 Log exploration and analysis. Pulse tails a log file live, filters lines by pattern, and groups similar messages so you can spot recurring errors.
diff --git a/docs/releasing.md b/docs/releasing.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Versioning & Releases
+nav_order: 9
+---
+
 # Releasing
 
 Every module in the monorepo is versioned and released **independently**. Releasing one app never requires touching another. This guide covers cutting a release with `scripts/version.sh` and what the release pipeline produces.
diff --git a/docs/strata.md b/docs/strata.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Strata (Database)
+nav_order: 7
+---
+
 # runtime-strata
 
 Database exploration and administration. Strata connects to a database from a single connection string, reads its schema, and renders query results in a virtualized table.
diff --git a/docs/vault.md b/docs/vault.md
@@ -1,3 +1,9 @@
+---
+layout: default
+title: Vault (Secrets)
+nav_order: 8
+---
+
 # runtime-vault
 
 Secrets and configuration explorer. Vault inspects, validates, and decodes secret artifacts, showing only non-sensitive metadata — secret values are always masked.
