jklymak · Mar 25, 2026 · Mar 30, 2026 · May 22, 2026 · Jul 19, 2026 · Jul 19, 2026
diff --git a/.github/workflows/pixi_tests.yml b/.github/workflows/pixi_tests.yml
@@ -0,0 +1,84 @@
+---
+name: Pixi
+
+on:
+  pull_request:
+    paths:
+      - "pixi.lock"
+      - "pyproject.toml"
+      - "src/**"
+      - "lib/**"
+      - ".github/workflows/pixi.yml"
+  push:
+    branches: [main]
+    paths:
+      - "pixi.lock"
+      - "pyproject.toml"
+      - "src/**"
+      - "lib/**"
+      - ".github/workflows/pixi.yml"
+  workflow_dispatch:
+
+permissions: {}
+
+jobs:
+  check-lockfile:
+    runs-on: ubuntu-slim
+    permissions:
+      contents: read
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          fetch-depth: 1
+          persist-credentials: false
+
+      - name: Set up pixi
+        uses: prefix-dev/setup-pixi@a09b6247153796b190642a2b53fac4241043cf6f  # v0.10.0
+        with:
+          pixi-version: v0.73.0
+          run-install: false
+
+      - name: Check that pixi.lock is up to date
+        run: |
+          if ! pixi install --locked --manifest-path pyproject.toml; then
+            echo "::error file=pixi.lock::pixi.lock is not consistent with pyproject.toml. " \
+            "Run 'pixi lock' locally and commit the updated pixi.lock."
+            exit 1
+          fi
+
+  pixi-linux-install:
+    needs: check-lockfile
+    runs-on: ubuntu-slim
+    permissions:
+      contents: read
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up pixi and install environment
+        uses: prefix-dev/setup-pixi@a09b6247153796b190642a2b53fac4241043cf6f  # v0.10.0
+        with:
+          pixi-version: v0.73.0
+          locked: true
+          cache: true
+          cache-write: ${{ github.event_name == 'push' && github.ref_name == 'main' }}
+
+      - name: Show pixi info
+        run: |
+          pixi info
+          pixi list
+
+      - name: Clean build artifacts
+        run: |
+          rm -rf build meson-logs meson-private .mesonpy-*
+
+      - name: Install Matplotlib editable
+        run: pixi run python -m pip install --config-settings=setup-args="-Db_lto=false" --editable .
+
+      - name: Smoke test editable install
+        run: |
+          pixi run python -c "import matplotlib; print(matplotlib.__version__)"
diff --git a/.gitignore b/.gitignore
@@ -118,6 +118,15 @@ ENV/
 env.bak/
 venv.bak/
 
+# pixi files on top level
+pixi.toml
+.pixi/
+# ignore the lock file, but we want to commit this if lock is purposely made from
+# pyproject.toml.  If you want the lock file committed, just do `git add -f pixi.lock`
+# after generating it.
+pixi.lock
+
+
 # Jupyter files #
 #################
 

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
@@ -141,6 +141,7 @@ setup.
 
 .. _venv: https://docs.python.org/3/library/venv.html
 .. _conda: https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html
+.. _pixi: https://pixi.prefix.dev/
 
 .. tab-set::
 
@@ -199,6 +200,37 @@ setup.
 
       Remember to activate the environment whenever you start working on Matplotlib!
 
+   .. tab-item:: pixi environment
+
+      A `pixi`_ configuration is included in ``pyproject.toml`` that will
+      install the development dependencies::
+
+        pixi install
+
+      and then to install an editable version of Matplotlib::
+
+         pixi run python -m pip install \
+            --no-build-isolation \
+            --config-settings=setup-args="-Db_lto=false" \
+            --editable .
+
+      (the ``-Db_lto=false`` is not needed on all platforms).  You can test the installation with::
+
+         pixi run python -c "import matplotlib; print(matplotlib.__file__)"
+
+
+      .. tip::
+         We provide some pixi tasks as shortcuts for common development tasks,
+         listed via::
+
+            pixi task list
+
+         If you do not want to use ``pixi run`` in front of every command, run::
+
+            pixi shell
+
+         and continue to use pixi as a python environment.
+
 
 Install external dependencies
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^