Add homepage, robots.txt, and update build config

mdaneri · mdaneri · commit 9b0eda25c9f5 · 2026-01-25T19:03:27.000-08:00
Adds a new index.html homepage and robots.txt for search engine indexing. Updates _config.yml to include jekyll-sitemap and jekyll-last-modified-at plugins. Updates GitHub Pages workflow to use latest actions and required settings for Jekyll plugins.
diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
@@ -30,24 +30,30 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6.0.1
+        with:
+          fetch-depth: 0   # IMPORTANT: needed for jekyll-last-modified-at (git history)
+
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: '3.3' # Not needed with a .ruby-version file
           bundler-cache: true # runs 'bundle install' and caches installed gems automatically
           cache-version: 0 # Increment this number if you need to re-download cached gems
+
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5
+
       - name: Build with Jekyll
         # Outputs to the './_site' directory by default
         run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
         env:
           JEKYLL_ENV: production
+
       - name: Upload artifact
         # Automatically uploads an artifact from the './_site' directory by default
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
 
   # Deployment job
   deploy:
diff --git a/_config.yml b/_config.yml
@@ -5,6 +5,8 @@ theme: just-the-docs
 plugins:
   - jekyll-default-layout
   - jekyll-seo-tag
+  - jekyll-sitemap
+  - jekyll-last-modified-at
   
 url: https://kestrun.github.io
 
diff --git a/index.html b/index.html
@@ -0,0 +1,218 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Kestrun – Hybrid PowerShell & .NET Web Framework</title>
+
+    <!-- 🔹 Primary Meta Tags -->
+    <meta name="title" content="Kestrun – Hybrid PowerShell & .NET Web Framework">
+    <meta name="description"
+        content="Kestrun is a modern hybrid web framework powered by ASP.NET Core, PowerShell, and C#. Build secure, extensible, multi-language web apps with ease.">
+    <meta name="keywords"
+        content="Kestrun, PowerShell web framework, .NET web framework, ASP.NET Core, Kestrel, hybrid framework, Razor Pages, C# scripting, multi-language routes, open source web server">
+    <meta name="author" content="Kestrun Project">
+    <meta name="robots" content="index, follow">
+    <meta name="language" content="English">
+
+    <!-- Open Graph -->
+    <meta property="og:type" content="website">
+    <meta property="og:url" content="https://www.kestrun.dev/">
+    <meta property="og:site_name" content="Kestrun">
+    <meta property="og:title" content="Kestrun – Hybrid PowerShell & .NET Web Framework">
+    <meta property="og:description"
+        content="A modern hybrid web framework for PowerShell & .NET. Build extensible, secure, and cross-platform apps with ease.">
+    <meta property="og:image" content="https://www.kestrun.dev/assets/kestrun_abstract_transparent.png">
+
+    <!-- Twitter -->
+    <meta name="twitter:card" content="summary_large_image">
+    <meta name="twitter:url" content="https://www.kestrun.dev/">
+    <meta name="twitter:title" content="Kestrun – Hybrid PowerShell & .NET Web Framework">
+    <meta name="twitter:description" content="A modern hybrid web framework for PowerShell & .NET.">
+    <meta name="twitter:image" content="https://www.kestrun.dev/assets/kestrun_abstract_transparent.png">
+
+    <!-- Favicon -->
+    <link rel="icon" href="/assets/favicon.ico" type="image/x-icon" />
+
+    <!-- Theme color (nice on Android/iOS) -->
+    <meta name="theme-color" content="#1f6feb">
+
+    <!-- Preload the wordmark for faster LCP -->
+    <link rel="preload" as="image" href="/assets/kestrun-wordmark-light.svg"
+        imagesrcset="/assets/kestrun-wordmark-light.svg">
+
+    <style>
+        body {
+            margin: 0;
+            font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+            background: white;
+            color: #5c5962;
+            line-height: 1.6;
+        }
+
+        header {
+            text-align: center;
+            background: linear-gradient(135deg, #1f6feb, #238636);
+            color: white;
+            position: relative;
+            padding: 3rem 1rem;
+            /* add comfortable space */
+        }
+
+        header img.logo {
+            position: absolute;
+            top: 1rem;
+            /* <-- add this */
+            right: 1rem;
+            max-width: 80px;
+            height: auto;
+            pointer-events: none;
+            /* purely decorative */
+        }
+
+        header img.wordmark {
+            max-width: 640px;
+            height: auto;
+            margin-bottom: 1rem;
+            display: block;
+            margin-left: auto;
+            margin-right: auto;
+        }
+
+        header p {
+            font-size: 1.25rem;
+            opacity: 0.9;
+        }
+
+        main {
+            max-width: 800px;
+            margin: 2rem auto;
+            padding: 0 1rem;
+        }
+
+
+
+        /* Buttons */
+        a.button {
+            display: inline-flex;
+            align-items: center;
+            gap: .45em;
+            box-sizing: border-box;
+            padding: 0.45em 1.0em;
+            margin: .25em .35em 0 0;
+            font: 500 1rem/1.4 system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+            color: #1f6feb;
+            text-decoration: none;
+            background: #f7f7f9;
+            border-radius: 8px;
+            border: 1px solid rgba(0, 0, 0, .06);
+            box-shadow: 0 1px 2px rgba(0, 0, 0, .06), 0 3px 8px rgba(0, 0, 0, .04);
+        }
+
+        /* ✅ Correct selector (.svg-icon is a CLASS) */
+        .button .svg-icon {
+            display: inline-block;
+            width: 1.1em;
+            height: 1.1em;
+            flex: 0 0 auto;
+            background: currentColor;
+            /* paint */
+            -webkit-mask-image: var(--icon);
+            /* use the vector as a mask */
+            mask-image: var(--icon);
+            -webkit-mask-repeat: no-repeat;
+            mask-repeat: no-repeat;
+            -webkit-mask-position: center;
+            mask-position: center;
+            -webkit-mask-size: contain;
+            mask-size: contain;
+        }
+
+        /* --- Icons as URL-encoded SVGs (no inline <svg> clutter) --- */
+
+        /* Book / Docs */
+        .icon-docs {
+            --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='black' d='M6 3a3 3 0 0 0-3 3v12a3 3 0 0 0 3 3h12.5a1.5 1.5 0 0 0 0-3H7a1.5 1.5 0 1 1 0-3h11.5A1.5 1.5 0 0 0 20 13V6a3 3 0 0 0-3-3H6z'/%3E%3C/svg%3E");
+        }
+
+        /* GitHub Octocat (Simple Icons path) */
+        .icon-github {
+            --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='black' d='M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.387.6.113.82-.262.82-.582 0-.288-.012-1.242-.018-2.25-3.338.726-4.042-1.61-4.042-1.61-.546-1.388-1.333-1.757-1.333-1.757-1.09-.744.082-.73.082-.73 1.205.087 1.84 1.237 1.84 1.237 1.07 1.833 2.807 1.303 3.492.997.107-.775.42-1.303.763-1.603-2.665-.303-5.466-1.332-5.466-5.931 0-1.312.469-2.383 1.237-3.223-.124-.303-.537-1.523.117-3.176 0 0 1.008-.322 3.3 1.23a11.52 11.52 0 0 1 3-.404c1.02.005 2.046.138 3 .404 2.29-1.552 3.297-1.23 3.297-1.23.656 1.653.243 2.873.12 3.176.771.84 1.236 1.911 1.236 3.223 0 4.61-2.806 5.624-5.476 5.921.431.372.824 1.102.824 2.222 0 1.606-.015 2.899-.015 3.293 0 .322.216.7.825.58C20.565 21.797 24 17.298 24 12c0-6.627-5.373-12-12-12z'/%3E%3C/svg%3E");
+        }
+
+        /* Blog (pencil) */
+        .icon-blog {
+            --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='black' d='M3 17.25V21h3.75L17.81 9.94l-3.75-3.75L3 17.25zM20.71 7.04a1 1 0 0 0 0-1.41l-2.34-2.34a1 1 0 0 0-1.41 0l-1.83 1.83 3.75 3.75 1.83-1.83z'/%3E%3C/svg%3E");
+        }
+
+        /* Coverage (check) */
+        .icon-coverage {
+            --icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath fill='black' d='M9 16.17 4.83 12 3.41 13.41 9 19 21 7l-1.41-1.41z'/%3E%3C/svg%3E");
+        }
+
+
+        footer {
+            margin-top: 4rem;
+            padding: 1rem;
+            text-align: center;
+            font-size: 0.875rem;
+            color: #8b949e;
+            border-top: 1px solid #30363d;
+        }
+
+        footer a {
+            color: inherit;
+        }
+    </style>
+</head>
+
+<body>
+    <header>
+        <!-- Logo (top-right) -->
+        <img src="/assets/kestrun_abstract_transparent.png" alt="Kestrun logo" class="logo" />
+
+        <!-- Wordmark (centered) -->
+        <img src="/assets/kestrun-wordmark-light.svg" alt="Kestrun" class="wordmark" />
+
+
+        <p>PowerShell brains. Kestrel speed</p>
+    </header>
+    <main>
+        <h2>What is Kestrun?</h2>
+        <p>
+            Kestrun is a hybrid web framework built on <strong>ASP.NET Core (Kestrel)</strong>,
+            extending it with <strong>PowerShell</strong>, <strong>C#</strong>, and multi-language scripting support.
+            It brings the flexibility of scripting and the performance of .NET into one ecosystem.
+        </p>
+
+        <h2>Features</h2>
+        <ul>
+            <li>⚡ Multi-language routes (PowerShell, C#, F#, VB.NET, JS, Python, …)</li>
+            <li>🔒 Built-in authentication & certificate management</li>
+            <li>📄 Razor pages backed by PowerShell scripts</li>
+            <li>📊 Logging, scheduling, caching, compression</li>
+            <li>🛠 Designed for extensibility & cross-platform use</li>
+        </ul>
+
+        <div class="buttons">
+            <a href="https://docs.kestrun.dev" class="button">
+                <span class="svg-icon icon-docs"></span> Read the Docs
+            </a>
+            <a href="https://github.com/Kestrun/Kestrun" class="button"> <span class="svg-icon icon-github"></span>
+                GitHub Repo
+            </a>
+            <a href="https://blog.kestrun.dev" class="button">
+                <span class="svg-icon icon-blog"></span> Blog
+            </a>
+            <a href="https://coverage.kestrun.dev" class="button">
+                <span class="svg-icon icon-coverage"></span> Test Coverage
+            </a>
+        </div>
+    </main>
+    <footer>
+        © 2025-2026 Kestrun Project · MIT Licensed · <a href="https://github.com/Kestrun/Kestrun">GitHub</a>
+    </footer>
+</body>
+
+</html>
diff --git a/robots.txt b/robots.txt
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://docs.kestrun.dev/sitemap.xml
