fdxmw · Oct 12, 2026 · Oct 8, 2026
diff --git a/examples/Makefile b/examples/Makefile
@@ -1,7 +1,7 @@
 PYTHON := uv run
 TO_IPYNB := tools/to_ipynb.py
 PY_FILES := $(wildcard example*.py) introduction-to-hardware.py
-IPYNB_FILES := $(addprefix ../ipynb-examples/, $(PY_FILES:.py=.ipynb))
+IPYNB_FILES := $(addprefix ../www/, $(PY_FILES:.py=.ipynb))
 
 all: $(IPYNB_FILES)
 

diff --git a/examples/README.md b/examples/README.md
@@ -17,7 +17,7 @@ uv run python3 -i $SCRIPT_FILE
 ## Generating Jupyter Notebooks
 
 Each example script is automatically converted to a Jupyter notebook in the
-[`ipynb-examples`](https://github.com/UCSBarchlab/PyRTL/tree/development/ipynb-examples)
+[`www`](https://github.com/UCSBarchlab/PyRTL/tree/development/www)
 directory.
 [`examples/tools/to_ipynb.py`](https://github.com/UCSBarchlab/PyRTL/blob/development/examples/tools/to_ipynb.py)
 performs these conversions. Do not manually edit the generated Jupyter

diff --git a/pyproject.toml b/pyproject.toml
@@ -55,7 +55,7 @@ Changelog = "https://github.com/UCSBarchlab/PyRTL/blob/development/CHANGELOG.md"
 source = "vcs"
 
 [tool.ruff]
-exclude = ["ipynb-examples", "docs/_build", "www/_build"]
+exclude = ["*.ipynb", "docs/_build", "www/_build"]
 
 [tool.ruff.lint]
 # See https://docs.astral.sh/ruff/rules/
@@ -118,7 +118,7 @@ ignore = [
 dev = [
     "furo>=2025.9.25",
     "graphviz>=0.21",
-    "jupyterlite-pyodide-kernel<0.8",
+    "jupyterlite-pyodide-kernel>=0.8.6",
     "jupyterlite-sphinx>=0.9.3",
     "pyparsing>=3.2.5",
     "pytest>=8.4.2",

diff --git a/uv.lock b/uv.lock
diff --git a/www/conf.py b/www/conf.py
@@ -28,15 +28,15 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+exclude_patterns = ["*.ipynb", "_build", "Thumbs.db", ".DS_Store"]
 
 # Enable links to Python standard library classes (str, list, dict, etc).
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
     "pyrtl": ("https://pyrtl.readthedocs.io/en/latest/", None),
 }
 
-jupyterlite_contents = "../ipynb-examples"
+jupyterlite_contents = "*.ipynb"
 
 # -- Options for HTML output -------------------------------------------------
 

diff --git a/ipynb-examples/example-adder.ipynb → www/example-adder.ipynb b/ipynb-examples/example-adder.ipynb → www/example-adder.ipynb
diff --git a/ipynb-examples/example-fir.ipynb → www/example-fir.ipynb b/ipynb-examples/example-fir.ipynb → www/example-fir.ipynb
diff --git a/ipynb-examples/example-gcd.ipynb → www/example-gcd.ipynb b/ipynb-examples/example-gcd.ipynb → www/example-gcd.ipynb
diff --git a/ipynb-examples/example-maxn.ipynb → www/example-maxn.ipynb b/ipynb-examples/example-maxn.ipynb → www/example-maxn.ipynb
diff --git a/ipynb-examples/example-mul.ipynb → www/example-mul.ipynb b/ipynb-examples/example-mul.ipynb → www/example-mul.ipynb
diff --git a/ipynb-examples/example-ripple-carry.ipynb → www/example-ripple-carry.ipynb b/ipynb-examples/example-ripple-carry.ipynb → www/example-ripple-carry.ipynb
diff --git a/...es/example0-minimum-viable-hardware.ipynb → www/example0-minimum-viable-hardware.ipynb b/...es/example0-minimum-viable-hardware.ipynb → www/example0-minimum-viable-hardware.ipynb
diff --git a/ipynb-examples/example1-combologic.ipynb → www/example1-combologic.ipynb b/ipynb-examples/example1-combologic.ipynb → www/example1-combologic.ipynb
diff --git a/...-examples/example1.1-signed-numbers.ipynb → www/example1.1-signed-numbers.ipynb b/...-examples/example1.1-signed-numbers.ipynb → www/example1.1-signed-numbers.ipynb
diff --git a/ipynb-examples/example1.2-wire-struct.ipynb → www/example1.2-wire-struct.ipynb b/ipynb-examples/example1.2-wire-struct.ipynb → www/example1.2-wire-struct.ipynb
diff --git a/ipynb-examples/example2-counter.ipynb → www/example2-counter.ipynb b/ipynb-examples/example2-counter.ipynb → www/example2-counter.ipynb
diff --git a/ipynb-examples/example3-statemachine.ipynb → www/example3-statemachine.ipynb b/ipynb-examples/example3-statemachine.ipynb → www/example3-statemachine.ipynb
diff --git a/ipynb-examples/example4-debuggingtools.ipynb → www/example4-debuggingtools.ipynb b/ipynb-examples/example4-debuggingtools.ipynb → www/example4-debuggingtools.ipynb
diff --git a/ipynb-examples/example5-introspection.ipynb → www/example5-introspection.ipynb b/ipynb-examples/example5-introspection.ipynb → www/example5-introspection.ipynb
diff --git a/ipynb-examples/example6-memory.ipynb → www/example6-memory.ipynb b/ipynb-examples/example6-memory.ipynb → www/example6-memory.ipynb
diff --git a/ipynb-examples/example7-synth-timing.ipynb → www/example7-synth-timing.ipynb b/ipynb-examples/example7-synth-timing.ipynb → www/example7-synth-timing.ipynb
diff --git a/ipynb-examples/example8-verilog.ipynb → www/example8-verilog.ipynb b/ipynb-examples/example8-verilog.ipynb → www/example8-verilog.ipynb
diff --git a/www/index.rst b/www/index.rst
@@ -115,7 +115,7 @@ differences between the approaches.
             The code below provides everything needed to instantiate, simulate, and
             visualize the resulting design.
 
-            .. jupyterlite:: ../ipynb-examples/example-gcd.ipynb
+            .. jupyterlite:: example-gcd.ipynb
                :new_tab: True
                :new_tab_button_text: Try this example in your browser
 
@@ -134,7 +134,7 @@ differences between the approaches.
             an output ``y`` which is the resulting sum of products and is valid every
             cycle (since the design is naturally fully pipelined).
 
-            .. jupyterlite:: ../ipynb-examples/example-fir.ipynb
+            .. jupyterlite:: example-fir.ipynb
                :new_tab: True
                :new_tab_button_text: Try this example in your browser
 
@@ -154,7 +154,7 @@ differences between the approaches.
             like :func:`~functools.reduce`, which is used to chain together multiple
             ``max_2`` elements into a bigger ``max_n``.
 
-            .. jupyterlite:: ../ipynb-examples/example-maxn.ipynb
+            .. jupyterlite:: example-maxn.ipynb
                :new_tab: True
                :new_tab_button_text: Try this example in your browser
 
@@ -176,7 +176,7 @@ differences between the approaches.
             an 8-bit ROM address and returns the value stored in the ROM at that
             address.
 
-            .. jupyterlite:: ../ipynb-examples/example-mul.ipynb
+            .. jupyterlite:: example-mul.ipynb
                :new_tab: True
                :new_tab_button_text: Try this example in your browser
 
@@ -197,7 +197,7 @@ differences between the approaches.
             final ``full_sum`` is produced by concatenating the wires in ``sum`` with
             :func:`~pyrtl.concat_list`.
 
-            .. jupyterlite:: ../ipynb-examples/example-adder.ipynb
+            .. jupyterlite:: example-adder.ipynb
                :new_tab: True
                :new_tab_button_text: Try this example in your browser
 
@@ -255,7 +255,7 @@ introduction to fixed 4-bit adders
 <https://www.youtube.com/watch?v=bL3ihMA8_Gs>`_, let's go ahead and build an
 `arbitrary` bitwidth adder.
 
-.. jupyterlite:: ../ipynb-examples/example-ripple-carry.ipynb
+.. jupyterlite:: example-ripple-carry.ipynb
    :new_tab: True
    :new_tab_button_text: Try this example in your browser
 

diff --git a/...b-examples/introduction-to-hardware.ipynb → www/introduction-to-hardware.ipynb b/...b-examples/introduction-to-hardware.ipynb → www/introduction-to-hardware.ipynb