koaning · koaning · May 1, 2026 · May 1, 2026
diff --git a/.claude/skills/prep-release/SKILL.md b/.claude/skills/prep-release/SKILL.md
@@ -14,19 +14,19 @@ Prepare a new wigglystuff release. Follow these steps:
    - Look at the git diff against `main` to determine what changed
 
 4. **Update all documentation locations** for any new widgets:
-   - `mkdocs/reference/<widget-name>.md` — create a reference doc following the pattern in existing reference pages (use `::: wigglystuff.module.ClassName` mkdocstrings directive + a synced traitlets table)
-   - `mkdocs.yml` — add the widget to the `nav` Reference section
-   - `mkdocs/index.md` — add to the appropriate gallery section (main gallery or 3rd party gallery)
+   - `docs/reference/<widget-name>.md` — create a reference doc following the pattern in existing reference pages (use `::: wigglystuff.module.ClassName` mkdocstrings directive + a synced traitlets table)
+   - `zensical.toml` — add the widget to the `nav` Reference section
+   - `docs/index.md` — add to the appropriate gallery section (main gallery or 3rd party gallery)
    - `readme.md` — add to the appropriate gallery table (main gallery or 3rd party table)
-   - `mkdocs/llms.txt` — add a one-line entry in the appropriate section
+   - `docs/llms.txt` — add a one-line entry in the appropriate section
    - `CLAUDE.md` — add a row to the quick reference table
    - `wigglystuff/__init__.py` — verify the widget is imported and listed in `__all__`
 
 5. **For 3rd party widgets** (those requiring non-core dependencies like neo4j, torch, wandb):
    - Place them in the "3rd party widgets" section of the galleries (not the main gallery)
    - Use a molab link for the demo instead of a local example page
    - Use `MOLAB_LINK_HERE` as a placeholder if the molab link is not yet available and tell the user they need to fill it in
-   - Screenshot path should be `mkdocs/assets/gallery/<widgetname>.png` — tell the user if one is missing
+   - Screenshot path should be `docs/assets/gallery/<widgetname>.png` — tell the user if one is missing
 
 6. **Check dependencies**: Read `pyproject.toml` and verify that no 3rd party widget dependency (neo4j, torch, wandb, etc.) has been added to core `[project] dependencies`. These must only appear under `[project.optional-dependencies]` as extras. Core dependencies should only include packages needed by all widgets (anywidget, numpy, pillow, python-dotenv). If a 3rd party dep has leaked into core dependencies, remove it.
 

diff --git a/.gitignore b/.gitignore
@@ -170,7 +170,7 @@ Untitled.ipynb
 **/__marimo__/**
 !**/__marimo__/session/
 !**/__marimo__/session/**
-mkdocs/examples/*
-!mkdocs/examples/.demo-hashes.json
+docs/examples/*
+!docs/examples/.demo-hashes.json
 
 wandb/**
diff --git a/AGENTS.md b/AGENTS.md
@@ -71,9 +71,9 @@ syncs back to Python.
   overrides that respond to `.dark`, `.dark-theme`, or `[data-theme="dark"]`
   ancestors so notebook-level theme toggles work instantly.
 - When adding a new widget, remember to update the docs gallery
-  (`mkdocs/index.md`), the README gallery (`readme.md`), the LLM context
-  file (`mkdocs/llms.txt`), and the changelog (`CHANGELOG.md`). Add a
-  screenshot to `mkdocs/assets/gallery/` and reference it from the gallery
+  (`docs/index.md`), the README gallery (`readme.md`), the LLM context
+  file (`docs/llms.txt`), and the changelog (`CHANGELOG.md`). Add a
+  screenshot to `docs/assets/gallery/` and reference it from the gallery
   locations to keep them in sync.
 - New or changed features that haven't been released yet go under the
   `## [Unreleased]` section at the top of `CHANGELOG.md`. That section gets

diff --git a/README.md b/README.md
diff --git a/mkdocs/assets/gallery/altairwidget.png → docs/assets/gallery/altairwidget.png b/mkdocs/assets/gallery/altairwidget.png → docs/assets/gallery/altairwidget.png
diff --git a/mkdocs/assets/gallery/annotation.png → docs/assets/gallery/annotation.png b/mkdocs/assets/gallery/annotation.png → docs/assets/gallery/annotation.png
diff --git a/mkdocs/assets/gallery/apidoc.png → docs/assets/gallery/apidoc.png b/mkdocs/assets/gallery/apidoc.png → docs/assets/gallery/apidoc.png
diff --git a/mkdocs/assets/gallery/celltour.png → docs/assets/gallery/celltour.png b/mkdocs/assets/gallery/celltour.png → docs/assets/gallery/celltour.png
diff --git a/mkdocs/assets/gallery/chartmultiselect.png → docs/assets/gallery/chartmultiselect.png b/mkdocs/assets/gallery/chartmultiselect.png → docs/assets/gallery/chartmultiselect.png
diff --git a/mkdocs/assets/gallery/chartpuck.png → docs/assets/gallery/chartpuck.png b/mkdocs/assets/gallery/chartpuck.png → docs/assets/gallery/chartpuck.png
diff --git a/mkdocs/assets/gallery/chartselect.png → docs/assets/gallery/chartselect.png b/mkdocs/assets/gallery/chartselect.png → docs/assets/gallery/chartselect.png
diff --git a/mkdocs/assets/gallery/colorpicker.png → docs/assets/gallery/colorpicker.png b/mkdocs/assets/gallery/colorpicker.png → docs/assets/gallery/colorpicker.png
diff --git a/mkdocs/assets/gallery/copytoclipboard.png → docs/assets/gallery/copytoclipboard.png b/mkdocs/assets/gallery/copytoclipboard.png → docs/assets/gallery/copytoclipboard.png
diff --git a/mkdocs/assets/gallery/diffviewer.png → docs/assets/gallery/diffviewer.png b/mkdocs/assets/gallery/diffviewer.png → docs/assets/gallery/diffviewer.png
diff --git a/mkdocs/assets/gallery/dimensions.png → docs/assets/gallery/dimensions.png b/mkdocs/assets/gallery/dimensions.png → docs/assets/gallery/dimensions.png
diff --git a/mkdocs/assets/gallery/edgedraw.png → docs/assets/gallery/edgedraw.png b/mkdocs/assets/gallery/edgedraw.png → docs/assets/gallery/edgedraw.png
diff --git a/mkdocs/assets/gallery/envconfig.png → docs/assets/gallery/envconfig.png b/mkdocs/assets/gallery/envconfig.png → docs/assets/gallery/envconfig.png
diff --git a/...gallery/fashion-mnist-parallel-coords.png → ...gallery/fashion-mnist-parallel-coords.png b/...gallery/fashion-mnist-parallel-coords.png → ...gallery/fashion-mnist-parallel-coords.png
diff --git a/mkdocs/assets/gallery/forecast-chart.png → docs/assets/gallery/forecast-chart.png b/mkdocs/assets/gallery/forecast-chart.png → docs/assets/gallery/forecast-chart.png
diff --git a/mkdocs/assets/gallery/gamepad.png → docs/assets/gallery/gamepad.png b/mkdocs/assets/gallery/gamepad.png → docs/assets/gallery/gamepad.png
diff --git a/mkdocs/assets/gallery/hoverzoom.png → docs/assets/gallery/hoverzoom.png b/mkdocs/assets/gallery/hoverzoom.png → docs/assets/gallery/hoverzoom.png
diff --git a/mkdocs/assets/gallery/htmlwidget.png → docs/assets/gallery/htmlwidget.png b/mkdocs/assets/gallery/htmlwidget.png → docs/assets/gallery/htmlwidget.png
diff --git a/mkdocs/assets/gallery/imagerefresh.png → docs/assets/gallery/imagerefresh.png b/mkdocs/assets/gallery/imagerefresh.png → docs/assets/gallery/imagerefresh.png
diff --git a/mkdocs/assets/gallery/keystroke.png → docs/assets/gallery/keystroke.png b/mkdocs/assets/gallery/keystroke.png → docs/assets/gallery/keystroke.png
diff --git a/mkdocs/assets/gallery/matrix.png → docs/assets/gallery/matrix.png b/mkdocs/assets/gallery/matrix.png → docs/assets/gallery/matrix.png
diff --git a/mkdocs/assets/gallery/moduletree.png → docs/assets/gallery/moduletree.png b/mkdocs/assets/gallery/moduletree.png → docs/assets/gallery/moduletree.png
diff --git a/mkdocs/assets/gallery/neo4j-widget.png → docs/assets/gallery/neo4j-widget.png b/mkdocs/assets/gallery/neo4j-widget.png → docs/assets/gallery/neo4j-widget.png
diff --git a/mkdocs/assets/gallery/nested_table.png → docs/assets/gallery/nested_table.png b/mkdocs/assets/gallery/nested_table.png → docs/assets/gallery/nested_table.png
diff --git a/mkdocs/assets/gallery/paint.png → docs/assets/gallery/paint.png b/mkdocs/assets/gallery/paint.png → docs/assets/gallery/paint.png
diff --git a/mkdocs/assets/gallery/parallelcoords.png → docs/assets/gallery/parallelcoords.png b/mkdocs/assets/gallery/parallelcoords.png → docs/assets/gallery/parallelcoords.png
diff --git a/mkdocs/assets/gallery/playslider.png → docs/assets/gallery/playslider.png b/mkdocs/assets/gallery/playslider.png → docs/assets/gallery/playslider.png
diff --git a/mkdocs/assets/gallery/progressbar.png → docs/assets/gallery/progressbar.png b/mkdocs/assets/gallery/progressbar.png → docs/assets/gallery/progressbar.png
diff --git a/mkdocs/assets/gallery/pulsarchart.png → docs/assets/gallery/pulsarchart.png b/mkdocs/assets/gallery/pulsarchart.png → docs/assets/gallery/pulsarchart.png
diff --git a/mkdocs/assets/gallery/scatterwidget.png → docs/assets/gallery/scatterwidget.png b/mkdocs/assets/gallery/scatterwidget.png → docs/assets/gallery/scatterwidget.png
diff --git a/mkdocs/assets/gallery/slider2d.png → docs/assets/gallery/slider2d.png b/mkdocs/assets/gallery/slider2d.png → docs/assets/gallery/slider2d.png
diff --git a/mkdocs/assets/gallery/sortablelist.png → docs/assets/gallery/sortablelist.png b/mkdocs/assets/gallery/sortablelist.png → docs/assets/gallery/sortablelist.png
diff --git a/mkdocs/assets/gallery/speechtotext.png → docs/assets/gallery/speechtotext.png b/mkdocs/assets/gallery/speechtotext.png → docs/assets/gallery/speechtotext.png
diff --git a/mkdocs/assets/gallery/splinedraw.png → docs/assets/gallery/splinedraw.png b/mkdocs/assets/gallery/splinedraw.png → docs/assets/gallery/splinedraw.png
diff --git a/mkdocs/assets/gallery/tangle.png → docs/assets/gallery/tangle.png b/mkdocs/assets/gallery/tangle.png → docs/assets/gallery/tangle.png
diff --git a/mkdocs/assets/gallery/textcompare.png → docs/assets/gallery/textcompare.png b/mkdocs/assets/gallery/textcompare.png → docs/assets/gallery/textcompare.png
diff --git a/mkdocs/assets/gallery/threewidget.png → docs/assets/gallery/threewidget.png b/mkdocs/assets/gallery/threewidget.png → docs/assets/gallery/threewidget.png
diff --git a/mkdocs/assets/gallery/treemap.png → docs/assets/gallery/treemap.png b/mkdocs/assets/gallery/treemap.png → docs/assets/gallery/treemap.png
diff --git a/mkdocs/assets/gallery/webcam-capture.png → docs/assets/gallery/webcam-capture.png b/mkdocs/assets/gallery/webcam-capture.png → docs/assets/gallery/webcam-capture.png
diff --git a/mkdocs/assets/gallery/zooming.png → docs/assets/gallery/zooming.png b/mkdocs/assets/gallery/zooming.png → docs/assets/gallery/zooming.png
diff --git a/mkdocs/assets/logo.png → docs/assets/logo.png b/mkdocs/assets/logo.png → docs/assets/logo.png
diff --git a/mkdocs/assets/stylesheets/extra.css → docs/assets/stylesheets/extra.css b/mkdocs/assets/stylesheets/extra.css → docs/assets/stylesheets/extra.css
diff --git a/mkdocs/demos.md → docs/demos.md b/mkdocs/demos.md → docs/demos.md
diff --git a/mkdocs/index.md → docs/index.md b/mkdocs/index.md → docs/index.md
diff --git a/mkdocs/llms.txt → docs/llms.txt b/mkdocs/llms.txt → docs/llms.txt
diff --git a/mkdocs/overrides/main.html → docs/overrides/main.html b/mkdocs/overrides/main.html → docs/overrides/main.html
diff --git a/mkdocs/reference/altair-widget.md → docs/reference/altair-widget.md b/mkdocs/reference/altair-widget.md → docs/reference/altair-widget.md
diff --git a/mkdocs/reference/api-doc.md → docs/reference/api-doc.md b/mkdocs/reference/api-doc.md → docs/reference/api-doc.md
diff --git a/mkdocs/reference/cell-tour.md → docs/reference/cell-tour.md b/mkdocs/reference/cell-tour.md → docs/reference/cell-tour.md
diff --git a/mkdocs/reference/chart-multi-select.md → docs/reference/chart-multi-select.md b/mkdocs/reference/chart-multi-select.md → docs/reference/chart-multi-select.md
diff --git a/mkdocs/reference/chart-puck.md → docs/reference/chart-puck.md b/mkdocs/reference/chart-puck.md → docs/reference/chart-puck.md
diff --git a/mkdocs/reference/chart-select.md → docs/reference/chart-select.md b/mkdocs/reference/chart-select.md → docs/reference/chart-select.md
diff --git a/mkdocs/reference/color-picker.md → docs/reference/color-picker.md b/mkdocs/reference/color-picker.md → docs/reference/color-picker.md
diff --git a/mkdocs/reference/copy-to-clipboard.md → docs/reference/copy-to-clipboard.md b/mkdocs/reference/copy-to-clipboard.md → docs/reference/copy-to-clipboard.md
diff --git a/mkdocs/reference/diff-viewer.md → docs/reference/diff-viewer.md b/mkdocs/reference/diff-viewer.md → docs/reference/diff-viewer.md
diff --git a/mkdocs/reference/edge-draw.md → docs/reference/edge-draw.md b/mkdocs/reference/edge-draw.md → docs/reference/edge-draw.md
diff --git a/mkdocs/reference/env-config.md → docs/reference/env-config.md b/mkdocs/reference/env-config.md → docs/reference/env-config.md
diff --git a/mkdocs/reference/gamepad.md → docs/reference/gamepad.md b/mkdocs/reference/gamepad.md → docs/reference/gamepad.md
diff --git a/mkdocs/reference/hover-zoom.md → docs/reference/hover-zoom.md b/mkdocs/reference/hover-zoom.md → docs/reference/hover-zoom.md
diff --git a/mkdocs/reference/html-refresh.md → docs/reference/html-refresh.md b/mkdocs/reference/html-refresh.md → docs/reference/html-refresh.md
diff --git a/mkdocs/reference/image-refresh.md → docs/reference/image-refresh.md b/mkdocs/reference/image-refresh.md → docs/reference/image-refresh.md
diff --git a/mkdocs/reference/index.md → docs/reference/index.md b/mkdocs/reference/index.md → docs/reference/index.md
diff --git a/mkdocs/reference/keystroke.md → docs/reference/keystroke.md b/mkdocs/reference/keystroke.md → docs/reference/keystroke.md
diff --git a/mkdocs/reference/matrix.md → docs/reference/matrix.md b/mkdocs/reference/matrix.md → docs/reference/matrix.md
diff --git a/mkdocs/reference/module-tree.md → docs/reference/module-tree.md b/mkdocs/reference/module-tree.md → docs/reference/module-tree.md
diff --git a/mkdocs/reference/neo4j-widget.md → docs/reference/neo4j-widget.md b/mkdocs/reference/neo4j-widget.md → docs/reference/neo4j-widget.md
diff --git a/mkdocs/reference/nested-table.md → docs/reference/nested-table.md b/mkdocs/reference/nested-table.md → docs/reference/nested-table.md
diff --git a/mkdocs/reference/paint.md → docs/reference/paint.md b/mkdocs/reference/paint.md → docs/reference/paint.md
diff --git a/mkdocs/reference/parallel-coords.md → docs/reference/parallel-coords.md b/mkdocs/reference/parallel-coords.md → docs/reference/parallel-coords.md
diff --git a/mkdocs/reference/play-slider.md → docs/reference/play-slider.md b/mkdocs/reference/play-slider.md → docs/reference/play-slider.md
diff --git a/mkdocs/reference/progress-bar.md → docs/reference/progress-bar.md b/mkdocs/reference/progress-bar.md → docs/reference/progress-bar.md
diff --git a/mkdocs/reference/pulsar-chart.md → docs/reference/pulsar-chart.md b/mkdocs/reference/pulsar-chart.md → docs/reference/pulsar-chart.md
diff --git a/mkdocs/reference/scatter-widget.md → docs/reference/scatter-widget.md b/mkdocs/reference/scatter-widget.md → docs/reference/scatter-widget.md
diff --git a/mkdocs/reference/slider2d.md → docs/reference/slider2d.md b/mkdocs/reference/slider2d.md → docs/reference/slider2d.md
diff --git a/mkdocs/reference/sortable-list.md → docs/reference/sortable-list.md b/mkdocs/reference/sortable-list.md → docs/reference/sortable-list.md
diff --git a/mkdocs/reference/spline-draw.md → docs/reference/spline-draw.md b/mkdocs/reference/spline-draw.md → docs/reference/spline-draw.md
diff --git a/mkdocs/reference/talk.md → docs/reference/talk.md b/mkdocs/reference/talk.md → docs/reference/talk.md
diff --git a/mkdocs/reference/tangle.md → docs/reference/tangle.md b/mkdocs/reference/tangle.md → docs/reference/tangle.md
diff --git a/mkdocs/reference/text-compare.md → docs/reference/text-compare.md b/mkdocs/reference/text-compare.md → docs/reference/text-compare.md
diff --git a/mkdocs/reference/three-widget.md → docs/reference/three-widget.md b/mkdocs/reference/three-widget.md → docs/reference/three-widget.md
diff --git a/mkdocs/reference/treemap.md → docs/reference/treemap.md b/mkdocs/reference/treemap.md → docs/reference/treemap.md
diff --git a/mkdocs/reference/utils.md → docs/reference/utils.md b/mkdocs/reference/utils.md → docs/reference/utils.md
diff --git a/mkdocs/reference/webcam-capture.md → docs/reference/webcam-capture.md b/mkdocs/reference/webcam-capture.md → docs/reference/webcam-capture.md
diff --git a/scripts/post_zensical.py b/scripts/post_zensical.py
@@ -13,7 +13,7 @@
 from pathlib import Path
 
 ROOT = Path(__file__).resolve().parents[1]
-DOCS_DIR = ROOT / "mkdocs"
+DOCS_DIR = ROOT / "docs"
 SITE_DIR = ROOT / "site"
 
 

diff --git a/zensical.toml b/zensical.toml
@@ -4,7 +4,7 @@ site_description = "Creative AnyWidgets for notebooks"
 site_url = "https://koaning.github.io/wigglystuff/"
 repo_url = "https://github.com/koaning/wigglystuff"
 repo_name = "koaning/wigglystuff"
-docs_dir = "mkdocs"
+docs_dir = "docs"
 site_dir = "site"
 
 nav = [
@@ -57,7 +57,7 @@ extra_css = ["assets/stylesheets/extra.css"]
 # Theme
 # ----------------------------------------------------------------------------
 [project.theme]
-custom_dir = "mkdocs/overrides"
+custom_dir = "docs/overrides"
 logo = "assets/logo.png"
 favicon = "assets/logo.png"
 language = "en"
@@ -79,8 +79,8 @@ features = [
 repo = "fontawesome/brands/github"
 
 [project.theme.font]
-text = "Geist"
-code = "Geist Mono"
+text = "IBM Plex Sans"
+code = "JetBrains Mono"
 
 [[project.theme.palette]]
 scheme = "default"