René's URL Explorer Experiment

Title: feat(examples): browser app with one Run button and one configurable endpoint by jamesbhobbs · Pull Request #464 · deepnote/deepnote · GitHub

Open Graph Title: feat(examples): browser app with one Run button and one configurable endpoint by jamesbhobbs · Pull Request #464 · deepnote/deepnote

X Title: feat(examples): browser app with one Run button and one configurable endpoint by jamesbhobbs · Pull Request #464 · deepnote/deepnote

Description: Summary A self-contained HTML page that runs a Deepnote notebook and renders its outputs, driven by one Run button pointed at one configurable endpoint that defaults to https://api.deepnote.com — so the common case needs no configuration at all. const APP_CONFIG = { notebookId: null, notebookName: 'Dashboard', baseUrl: 'https://api.deepnote.com', inputs: [], } Point baseUrl elsewhere and the same /v2/runs surface serves a local Deepnote server: # Cloud — the default, nothing to configure http://127.0.0.1:?notebookId=&token= # A local Deepnote server, same endpoints http://127.0.0.1:?notebookId=&baseUrl=http://localhost:8080 The app targets one at a time, so there is a single request path and a single result shape to render — rather than separate cloud and local buttons whose visibility depends on probing for a local server. How it works POST {baseUrl}/v2/runs to trigger GET {baseUrl}/v2/runs/{runId}?snapshotDelivery=inline to poll Parse the returned snapshot YAML client-side with the existing snapshot-reader.iife.js bundle Render outputs — tables, charts, text, HTML Token acquisition: on deepnote.com the page asks the shell via postMessage (deepnote-static-files-api-token-request) and gets a short-lived project-scoped token; elsewhere it accepts ?token=. serve.mjs is for local development only and has no API routes — runs never pass through it. Its only job is mapping /snapshot-reader.js to the built bundle so there's no copy step. That's why it's 45 lines. Dependencies — none This branches directly off main and depends on no other open PR. main already builds snapshot-reader.iife.js (packages/local-runner/tsdown.config.ts) and already hosts sibling examples under examples/local-runner/. Nothing outside examples/local-runner/cloud-app/ changes except a one-word cspell.json entry for deepnoteworkspace, the domain the README documents. One forward reference to flag: the README's "Publishing to deepnote.com" section uses deepnote publish, which ships in #455. It is documentation only — nothing in the app calls it — but if this merges first, that section describes a command not yet on main. Test plan pnpm test — 2894 passed, 1 skipped pnpm spell-check — 0 issues pnpm biome:check — clean (the two noConsole warnings in serve.mjs match gallery/, run-app/, and snapshot-viewer/ on main) node examples/local-runner/cloud-app/serve.mjs serves the page and /snapshot-reader.js Cloud run against the default api.deepnote.com with ?token= renders outputs ?baseUrl=http://localhost:8080 drives the same code path against a local server On deepnote.com, the postMessage token flow works with no baseUrl set 🤖 Generated with Claude Code Summary by CodeRabbit New Features Added a standalone browser app for running Deepnote notebooks, viewing run history, and rendering outputs. Added support for cloud and local API execution, including run status, errors, streams, images, HTML, and text results. Added a local development server with configurable app and snapshot-reader URLs. Documentation Added setup, configuration, execution, snapshot rendering, and publishing instructions for the browser app. Chores Added the app name to the spell-check dictionary.

Open Graph Description: Summary A self-contained HTML page that runs a Deepnote notebook and renders its outputs, driven by one Run button pointed at one configurable endpoint that defaults to https://api.deepnote.com — s...

X Description: Summary A self-contained HTML page that runs a Deepnote notebook and renders its outputs, driven by one Run button pointed at one configurable endpoint that defaults to https://api.deepnote.com — s...

Opengraph URL: https://github.com/deepnote/deepnote/pull/464

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width