Skip to content

About

Share interactive JavaScript visualizations, charts, dashboards, and apps in a URL — no server, build, or account. Generate with AI or write by hand.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Repository files navigation

FrameJS — open web artifacts, embed them anywhere

framejs.io

Open web artifacts — interactive JavaScript that lives in a URL. Prompt AI to build one, then embed or share it anywhere.

Live Docs → · Create now · Examples · Developer docs


What is it?

framejs.io is an open-source, embeddable, editable web app. You write (or ask AI to write) an ES6 JavaScript module — an interactive figure, dashboard, widget, app, or game — and all of the code and state is encoded in the URL. There is no server storage and no account required: the URL is the program, so anyone with the link can run it instantly.

It is the same unit of work as an artifact built inside Claude or ChatGPT, with the platform taken out from underneath it: because the artifact is a plain URL running open-source code, it embeds live in someone else's page, takes inputs, carries a citable version, and can be forked or self-hosted.

  • 🤖 Create with AI — describe what you want in plain language; works with Claude, ChatGPT, or any LLM.
  • 🔗 Share via URL — copy the link and it just runs. Content-addressed short URLs too.
  • 🧩 Embed anywhere — Notion, Obsidian, Confluence, Google Docs, Jupyter, or your own site.
  • 📓 Notebook widgets — use any frame as an interactive Jupyter or marimo widget.
  • 🕸️ Connect frames — wire inputs and outputs together to build pipelines and dashboards.
  • 🔓 Open source, self-hostable — MIT-licensed runtime and a documented URL format; run the whole thing on your own infrastructure.
  • 🖼️ Rich previews — links render with an Open Graph title, description, and image in Slack, Discord, and social media.

Fastest start (AI)

framejs.io ships a portable Agent Skill that works across ~40 AI coding agents (Claude Code, Gemini CLI, Cursor, Codex, and more).

1. Install the skill (defaults to ~/.claude/skills; pass another harness's skills dir as an argument):

curl -fsSL https://framejs.io/skill/install.sh | sh

2. Ask your AI agent for anything visual:

create an interactive 3D globe that highlights countries on hover with population and fertility

3. The agent generates the JavaScript, creates a shareable short URL, and opens it in your browser. Paste an existing framejs.io/j/<hash> short URL to modify it.

→ Full setup and per-harness install: https://framejs.io/docs/ai/agent-skill

Fastest start (browser)

Open the editor and start typing — framejs.io#?edit=true. Code is an ES6 module with top-level await; import any npm package from a CDN, add CSS, and the URL updates live as you type.

// Send data to connected frames
setOutput("result", { temperature: 72, unit: "F" });

// Receive data from connected frames
export function onInputs(inputs) {
  const data = inputs["sensorData"];
  // process and visualize
}

→ Full JavaScript API.

Documentation

The complete, published documentation lives at framejs.io/docs:

Developing framejs.io

Contributor documentation lives in ./docs/development:

  • Local Setup — prerequisites and running the dev stack
  • Architecture — how it works and project structure
  • Editor — the React/Vite frontend
  • Worker — the Deno/Hono backend
  • Deployment — publishing the site and Python package
just dev      # start the full dev stack (worker + editor + traefik)
just check    # type-check editor + worker
just test     # run tests

License

See LICENSE.

About

Share interactive JavaScript visualizations, charts, dashboards, and apps in a URL — no server, build, or account. Generate with AI or write by hand.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages