diff --git a/docs/_config.yml b/docs/_config.yml
index c4192631f..d7de25717 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -1 +1,27 @@
-theme: jekyll-theme-cayman
\ No newline at end of file
+# Jekyll config for the published docs site (https://dapperlib.dev).
+# Pinned here rather than left to GitHub's defaults, which take the site title and
+# description from the repo's name and description fields.
+
+title: Dapper
+description: A simple object mapper for .NET
+url: https://dapperlib.dev
+
+theme: jekyll-theme-cayman
+
+# Cayman renders "Download .zip/.tar.gz" buttons in its header when this is on, and
+# GitHub's default config turns it on; these ship as NuGet packages, not tarballs.
+show_downloads: false
+
+# Cayman renders the page title in its header banner, and the title comes from each page's
+# first heading - so without this the heading reads twice, banner then body.
+titles_from_headings:
+ strip_title: true
+
+# Not in the always-on GitHub Pages plugin set, so it has to be asked for; generates
+# sitemap.xml and robots.txt.
+plugins:
+ - jekyll-sitemap
+
+# Present only so the docs show up in the solution; not site content.
+exclude:
+ - docs.csproj
diff --git a/docs/_includes/head-custom.html b/docs/_includes/head-custom.html
new file mode 100644
index 000000000..b3813f378
--- /dev/null
+++ b/docs/_includes/head-custom.html
@@ -0,0 +1,3 @@
+
+
+
diff --git a/docs/assets/icon.png b/docs/assets/icon.png
new file mode 100644
index 000000000..40a2fd94b
Binary files /dev/null and b/docs/assets/icon.png differ
diff --git a/docs/favicon.ico b/docs/favicon.ico
new file mode 100644
index 000000000..6aca2f8a5
Binary files /dev/null and b/docs/favicon.ico differ