Add documentation site

Author: ryanhiebert

.claude/settings.local.json

@@ -0,0 +1,31 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv python install 3.14t
+      - run: uv sync --group dev
+      - run: uv run mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+      - id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/docs.yml

@@ -15,3 +15,6 @@ uv.lock
 .python-version
 .ruff_cache/
 .ropeproject/
+
+# MkDocs
+site/

.gitignore

@@ -8,6 +8,10 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com).
 [Unreleased]
 ------------
 
+### Added
+
+- Documentation site.
+
 [0.5.0] - 2026-02-08
 --------------------
 

CHANGELOG.md

@@ -0,0 +1 @@
+queueio.dev

CNAME

@@ -0,0 +1,7 @@
+.md-header__topic {
+    display: none;
+}
+
+.md-nav--primary > .md-nav__title {
+    display: none;
+}

docs_overrides/assets/images/favicon.svg

@@ -0,0 +1,47 @@
+<script>
+  (function () {
+    // Remove any cached palette so Material always re-evaluates media queries
+    try {
+      var key = __md_scope.pathname + ".__palette";
+      localStorage.removeItem(key);
+    } catch (e) {}
+
+    // Prevent Material from persisting palette choices
+    var origSet = __md_set;
+    __md_set = function (k) {
+      if (k === "__palette") return;
+      return origSet.apply(this, arguments);
+    };
+
+    function apply() {
+      var inputs = document.querySelectorAll("[data-md-color-media]");
+      for (var i = 0; i < inputs.length; i++) {
+        var media = inputs[i].getAttribute("data-md-color-media");
+        if (media && matchMedia(media).matches) {
+          document.body.setAttribute(
+            "data-md-color-scheme",
+            inputs[i].getAttribute("data-md-color-scheme"),
+          );
+          document.body.setAttribute(
+            "data-md-color-primary",
+            inputs[i].getAttribute("data-md-color-primary"),
+          );
+          document.body.setAttribute(
+            "data-md-color-accent",
+            inputs[i].getAttribute("data-md-color-accent"),
+          );
+          break;
+        }
+      }
+    }
+
+    if (document.body) apply();
+    document.addEventListener("DOMContentLoaded", apply);
+
+    // Listen on both light and dark queries for maximum compatibility
+    var dark = matchMedia("(prefers-color-scheme: dark)");
+    var light = matchMedia("(prefers-color-scheme: light)");
+    dark.addEventListener("change", apply);
+    light.addEventListener("change", apply);
+  })();
+</script>