From f6d7cb5a224c9617858f7ef8ec7d1bc9479da32c Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 30 Jul 2026 22:39:05 -0400
Subject: [PATCH 1/4] MNT: break dependency cycle

mpl-sphinx-theme does not use Matplotlib, but we use ourselves
in the docs.
---
 pyproject.toml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 52f8e54..5c2b9d0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -20,10 +20,14 @@ classifiers = [
 ]
 dependencies = [
     "pydata-sphinx-theme==0.20.0",
-    "matplotlib",
     "sphinx-design",
 ]
 
+[dependency-groups]
+doc = [
+     "matplotlib"
+]
+
 [project.urls]
 homepage = "https://matplotlib.org/mpl-sphinx-theme/"
 repository = "https://github.com/matplotlib/mpl-sphinx-theme"

From 372d03ae3f78041eb2907e5a1b664ad5061586c2 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 30 Jul 2026 22:44:01 -0400
Subject: [PATCH 2/4] DOC/CI: use dependency group in circle

Assisted-by: opeencode:sonnet-4.6

I regret using the robot here.
---
 .circleci/config.yml  | 6 +++---
 CONTRIBUTING.md       | 2 +-
 docs/requirements.txt | 2 --
 3 files changed, 4 insertions(+), 6 deletions(-)
 delete mode 100644 docs/requirements.txt

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 3231e38..6ec6fcf 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -11,9 +11,9 @@ jobs:
       tag: "3.11"
     steps:
       - checkout
-      - python/install-packages:
-          pkg-manager: pip-dist
-          pip-dependency-file: docs/requirements.txt
+      - run:
+          name: Install dependencies
+          command: pip install --group doc -e .
       - run:
           name: Build docs
           command: make -C docs html
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 25ceb41..37d698c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -6,6 +6,6 @@ Installing the theme itself:
 
 After following the contribution guidelines in the Matplotlib docs, you will still need to install the theme itself to see the changes you made. At the root level of the repository run:
 
-`python -m pip install -e .`
+`python -m pip install --group doc -e .`
 
 After that you will be able to build the docs locally by doing `make html` in the `docs` directory.
diff --git a/docs/requirements.txt b/docs/requirements.txt
deleted file mode 100644
index a945df9..0000000
--- a/docs/requirements.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-pydata-sphinx-theme>=0.13.1
-matplotlib
\ No newline at end of file

From 08811ce1bc7f3907a3e4ea76e16c24fef1530d1b Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 30 Jul 2026 23:12:21 -0400
Subject: [PATCH 3/4] ENH: add pixi package metadata

---
 pyproject.toml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index 5c2b9d0..7e77fb5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -54,3 +54,20 @@ mpl_sphinx_theme = [
     "static/font/*.*",
     "components/*.html",
 ]
+
+
+[tool.pixi.workspace]
+channels = ["conda-forge"]
+platforms = ["linux-64", "osx-arm64", "osx-64", "win-64"]
+preview = ["pixi-build"]
+
+
+[tool.pixi.package]
+version = "3.11.1dev"
+name = "mpl-sphinx-theme"
+
+[tool.pixi.package.build.backend]
+name = "pixi-build-python"
+
+[tool.pixi.package.build.config]
+ignore-pypi-mapping = false

From a31f48c12748edce885e2e3ce94b7136f3b32da7 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 30 Jul 2026 23:16:09 -0400
Subject: [PATCH 4/4] MNT: fix version format

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 7e77fb5..5a476ea 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -63,7 +63,7 @@ preview = ["pixi-build"]
 
 
 [tool.pixi.package]
-version = "3.11.1dev"
+version = "3.11.1.dev0"
 name = "mpl-sphinx-theme"
 
 [tool.pixi.package.build.backend]