docs: restyle mkdocs to match Gateway API theme

- Add navigation tabs, light/dark toggle, rounded search box
- Use custom primary color (#0A65C0) matching Frame brand
- Add SVG logo (color and white variants) for header and favicon
- Hide header title in favor of logo, enlarge logo display
- Remove missing nav entries (ai-assistant-mode.md, blueprints.md)
- Exclude docs/venv/ and site/ from git

Author: pitabwire

.gitignore

@@ -19,4 +19,7 @@ coverage.out
 .idea/
 vendor/
 tests_runner/*.pem
-tests_runner/*.srl
+tests_runner/*.srl
+bin/
+docs/venv/
+site/

docs/assets/logo-white.svg

@@ -1,8 +1,46 @@
+/* Frame primary color */
 :root {
+  --md-primary-fg-color: #0A65C0;
   --md-text-font: "IBM Plex Sans", system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
   --md-code-font: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
 }
 
+/* Hide title in favor of logo */
+.md-header__topic {
+  display: none;
+}
+
+/* Increase size of logo */
+.md-header__button.md-logo img,
+.md-header__button.md-logo svg {
+  height: 1.8rem;
+}
+
+/* Always show tabs, even on smaller screens */
+@media screen and (max-width: 76.234375em) {
+  .md-header__button.md-logo {
+    display: block;
+  }
+
+  .md-tabs {
+    display: block;
+  }
+}
+
+/* Rounded search box + results */
+.md-search__form {
+  border-radius: .5rem;
+}
+
+[data-md-toggle=search]:checked~.md-header .md-search__form {
+  border-radius: .5rem .5rem 0 0;
+}
+
+[dir=ltr] .md-search__output {
+  border-radius: 0 0 .5rem .5rem;
+}
+
+/* Typography */
 .md-typeset h1 {
   letter-spacing: -0.02em;
 }
@@ -15,14 +53,12 @@
   font-size: 0.9em;
 }
 
-.md-typeset table {
-  font-size: 0.95em;
-}
-
-.md-header {
-  box-shadow: none;
+/* Make tables use the maximum available size */
+.md-typeset__table {
+  min-width: 100%;
+  width: 100%;
 }
 
-.md-footer {
-  display: none;
+.md-typeset table {
+  font-size: 0.95em;
 }

docs/assets/logo.svg

@@ -4,33 +4,54 @@ site_url: "https://pitabwire.github.io/frame/"
 repo_name: pitabwire/frame
 repo_url: "https://github.com/pitabwire/frame"
 edit_uri: "edit/main/docs/"
+exclude_docs: |
+  venv/
 
 theme:
   name: material
-  language: en
+  logo: assets/logo-white.svg
+  favicon: assets/logo.svg
+  icon:
+    repo: fontawesome/brands/git-alt
   features:
-    - navigation.instant
-    - navigation.tracking
-    - navigation.sections
-    - navigation.expand
+    - search.highlight
+    - navigation.tabs
     - navigation.top
-    - content.code.copy
+    - navigation.expand
     - content.tabs.link
+    - content.code.copy
   palette:
     - scheme: default
-      primary: deep orange
-      accent: teal
+      primary: custom
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: custom
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
   font:
     text: "IBM Plex Sans"
     code: "IBM Plex Mono"
 
 markdown_extensions:
   - admonition
-  - codehilite
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.details
+  - pymdownx.highlight
+  - pymdownx.inlinehilite
+  - pymdownx.superfences
+  - pymdownx.snippets
+  - pymdownx.tabbed:
+      alternate_style: true
   - toc:
       permalink: true
   - attr_list
   - md_in_html
+  - tables
 
 plugins:
   - search