Create an expanded example project

README.md

@@ -14,7 +14,7 @@ pip install budge
 
 ## Usage
 
-See the [demo notebook][demo] for usage examples.
+See the [example directory][demo] for usage examples.
 
 ## Copyright
 
@@ -24,7 +24,7 @@ Copyright © 2025 Jesse Brooklyn Hannah. Licensed under the terms of the
 [badge/pypi-publish]: https://github.com/budgeapp/budge/actions/workflows/pypi.yml/badge.svg
 [badge/pypi]: https://img.shields.io/pypi/v/budge
 [badge/pytest]: https://github.com/budgeapp/budge/actions/workflows/pytest.yml/badge.svg
-[demo]: https://github.com/budgeapp/budge/blob/trunk/demo.ipynb
+[demo]: https://github.com/budgeapp/budge/blob/trunk/example
 [license]: https://github.com/budgeapp/budge/blob/trunk/LICENSE.md
 [pypi]: https://pypi.org/project/budge/
 [workflows/pypi-publish]: https://github.com/budgeapp/budge/actions/workflows/pypi.yml

example/.python-version

@@ -0,0 +1 @@
+3.13

example/.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "ms-python.python",
+    "ms-toolsai.jupyter",
+    "ms-toolsai.datawrangler"
+  ]
+}

example/README.md

@@ -0,0 +1,8 @@
+# Example Budget
+
+This is an example of how to use a Jupyter notebook and Budge to track and
+forecast your budget. All of the dependencies needed to run the notebook at
+[`budget.ipynb`][nb] are listed in [`pyproject.toml`][toml].
+
+[nb]: ./budget.ipynb
+[toml]: ./pyproject.toml