- 
+ 
+ 
+ 
+ Notebooks
+Interactive notebooks in edit mode - you can modify and experiment with the code
+
+
+
+
+
+
+
+
+
+ fibonacci
+
+
+ Interactive Fibonacci sequence calculator with a slider to adjust the number of sequence elements.
+ Open Notebook +
+
+
+ penguins
+
+
+ Interactive data analysis of the Palmer Penguins dataset using Polars and marimo.
+ Open Notebook +Apps
+Interactive applications in run mode - code is hidden for a clean user interface
+
+
+
+
+
+
+
+ charts
+
+
+ Interactive data visualization dashboard with Altair charts.
+ Open App +
+### Setting Up the Environment
+
+This project uses [uv](https://github.com/astral-sh/uv) for package management. The Makefile includes commands to help you get started:
+
+```bash
+# Install uv package manager
+make uv
+
+# Run a specific notebook in edit mode
+make notebook NOTEBOOK=fibonacci
+
+# Run a specific app in edit mode
+make app APP=charts
+
+# Build the entire website locally (dry run)
+make dryrun
```
-And the `notebooks/penguins.py` notebook loads a CSV dataset from the `public/` directory.
+The `dryrun` command builds the entire website locally using the same process as the CI/CD pipeline but publishes it to a local `_site` folder instead of deploying to GitHub Pages. This is useful for previewing the complete website before pushing changes.
+
+### Creating New Notebooks
+
+1. Add your Python file to either the `notebooks/` or `apps/` directory
+2. Include the necessary dependencies at the top of your file:
```python
-import polars as pl
-df = pl.read_csv(mo.notebook_location() / "public" / "penguins.csv")
+# /// script
+# requires-python = ">=3.12"
+# dependencies = [
+# "marimo>=0.13.15",
+# # Add other dependencies here
+# ]
+# ///
```
-## ๐งช Testing
+## ๐ Including Data or Assets
-To test the export process, run `.github/scripts/build.py` from the root directory.
+To include data or assets in your notebooks, add them to the `public/` directory within either the `notebooks/` or `apps/` directory.
-```bash
-python .github/scripts/build.py
+### Examples:
+
+#### Loading an image:
+
+```markdown
+