This template repository demonstrates how to export marimo notebooks to WebAssembly and deploy them to GitHub Pages.

• apps/charts.py: Interactive data visualization with Altair
• notebooks/fibonacci.py: Interactive Fibonacci sequence calculator
• notebooks/penguins.py: Interactive data analysis with Polars and marimo

1. Fork this repository
2. Add your marimo files to the notebooks/ or apps/ directory
   1. notebooks/ notebooks are exported with --mode edit
   2. apps/ notebooks are exported with --mode run
3. Push to main branch
4. Go to repository Settings > Pages and change the "Source" dropdown to "GitHub Actions"
5. GitHub Actions will automatically build and deploy to Pages

To include data or assets in your notebooks, add them to the public/ directory.

For example, the apps/charts.py notebook loads an image asset from the public/ directory.

<img src="public/logo.png" width="200" />

And the notebooks/penguins.py notebook loads a CSV dataset from the public/ directory.

import polars as pl
df = pl.read_csv(mo.notebook_location() / "public" / "penguins.csv")

To test the export process, run .github/scripts/build.py from the root directory.

python .github/scripts/build.py

This will export all notebooks in a folder called _site/ in the root directory. Then to serve the site, run:

python -m http.server -d _site

This will serve the site at http://localhost:8000.