Getting Started

What is metaframe-js?

js.mtfm.io lets you run arbitrary JavaScript modules directly in the browser, with all code embedded in the URL. There is no server-side storage — the URL is the program.

It is designed for embedding anywhere and combining into metapages so you can connect inputs and outputs to other metaframe URLs or jupyter notebook code. Similar to CodePen or JSFiddle, but completely self-contained.

How to use it

1. Go to js.mtfm.io
2. Write JavaScript in the editor or edit with AI
3. The code runs immediately — the URL updates to contain your code
4. Share the URL with anyone

JavaScript overview

• Code is an ES6 module
• Top-level await is supported
• Export onInputs to listen to inputs from connected metaframes
• Send outputs with setOutput / setOutputs
• Export onResize to handle window/div resizes
• Use ES6 module imports, or add CSS / npm modules — everything is embedded in the URL

See the full JavaScript API for details.

Python widget

Install the metaframe-widget package to use any metaframe as an interactive widget in Jupyter or marimo:

pip install metaframe-widget

See Jupyter integration and marimo integration for usage.