diff --git a/docs/_config.yml b/docs/_config.yml
new file mode 100644
index 0000000..98c3c35
--- /dev/null
+++ b/docs/_config.yml
@@ -0,0 +1,27 @@
+title: GNAT
+description: >-
+  GNAT's Not A TIP — unified Python library for cyber threat intelligence
+  across 159 security platforms. STIX 2.1 ORM, investigations, reports,
+  rule engine, campaign tracking. Documentation organised with the
+  Diataxis framework.
+
+theme: jekyll-theme-cayman
+
+show_downloads: false
+github:
+  repository_url: https://github.com/wrhalpin/GNAT
+
+markdown: kramdown
+kramdown:
+  input: GFM
+  syntax_highlighter: rouge
+
+include:
+  - assets
+
+exclude:
+  - README.md
+  - Gemfile
+  - Gemfile.lock
+  - node_modules
+  - vendor
diff --git a/docs/index.html b/docs/index.html
index 97b943b..e62d862 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -62,13 +62,13 @@ <h2>Documentation by intent</h2>
         </tr>
         <tr>
           <th>Learning</th>
-          <td><a href="https://github.com/wrhalpin/GNAT/blob/main/docs/tutorials/README.md">Tutorials</a><br>Guided, newcomer-safe walkthroughs.</td>
-          <td><a href="https://github.com/wrhalpin/GNAT/blob/main/docs/explanation/README.md">Explanation</a><br>Architecture, rationale, and design choices.</td>
+          <td><a href="tutorials/">Tutorials</a><br>Guided, newcomer-safe walkthroughs.</td>
+          <td><a href="explanation/">Explanation</a><br>Architecture, rationale, and design choices.</td>
         </tr>
         <tr>
           <th>Working</th>
-          <td><a href="https://github.com/wrhalpin/GNAT/blob/main/docs/how-to/README.md">How-to guides</a><br>Task-focused procedures and recipes.</td>
-          <td><a href="https://github.com/wrhalpin/GNAT/blob/main/docs/reference/README.md">Reference</a><br>Exact technical behavior, config, and interfaces.</td>
+          <td><a href="how-to/">How-to guides</a><br>Task-focused procedures and recipes.</td>
+          <td><a href="reference/">Reference</a><br>Exact technical behavior, config, and interfaces.</td>
         </tr>
       </table>
     </section>