René's URL Explorer Experiment

Title: feat(examples): client-only cloud app demo by jamesbhobbs · Pull Request #456 · deepnote/deepnote · GitHub

Open Graph Title: feat(examples): client-only cloud app demo by jamesbhobbs · Pull Request #456 · deepnote/deepnote

X Title: feat(examples): client-only cloud app demo by jamesbhobbs · Pull Request #456 · deepnote/deepnote

Description: Summary Adds examples/local-runner/cloud-app/, a client-only dashboard that reads a configured notebook, renders its input controls, starts detached runs through the Deepnote v2 API, polls them, and renders their outputs. Supports published apps embedded in Deepnote by acquiring a short-lived, project- and viewer-scoped token together with its API origin from the trusted shell. The postMessage handshake is pinned to shellOrigin; credentials are not accepted through URL parameters and the shell token is sent only to the shell-provided origin. Keeps embedded requests within the static-app token scope: GET /v2/notebooks/:id, POST /v2/runs, and GET /v2/runs/:runId. Embedded mode does not discover projects, fetch arbitrary block metadata, or enumerate run history. Loads normalized input definitions from the notebook response, including select options and slider min, max, and step, then submits values in the format accepted by the runs API. Handles both inline snapshot content and the snapshotBlocks returned to static-app tokens, rendering streams, errors, images, sandboxed HTML, and text. Adds serve.mjs as a static assets/layout preview only. It provides no API routes or local notebook execution. Backend dependency GET /v2/notebooks/:id must expose normalized notebook inputs, including select and slider metadata, to both normal and static-app tokens. The corresponding backend change has been merged; it must be deployed before the published app is exercised. Projects using the embedded flow must also have API access for static apps enabled in addition to static file sharing. Relationship to #455 This PR intentionally contains no deepnote publish implementation. #455 adds the CLI command used to upload this directory. Merge this PR with Squash and merge. The #455 branch appears in this branch's history, so a normal or rebase merge of #456 could make GitHub treat #455's commits as already merged. After #456 is squash-merged, merge main into #455 with a normal merge commit and review its remaining diff. Verification pnpm test — 3,056 tests passed, 1 skipped pnpm typecheck pnpm biome:check pnpm prettier:check GitHub CI across the Node 22–25 matrix CodeRabbit review After #455 merges, smoke-test the hosted flow by building and copying snapshot-reader.iife.js, publishing this directory, opening the app from its Deepnote project, and verifying input metadata, run execution, and rendered outputs with a static-app token. Summary by CodeRabbit New Features Added a cloud dashboard for configuring notebook inputs, starting runs, monitoring progress, viewing outputs, and browsing run history. Added support for streamed output, errors, images, HTML, text, and snapshots. Added credential refresh handling for embedded app sessions. Documentation Updated guidance for local previews, publishing, authentication, and choosing among reference apps. Clarified that local previews are static and notebook loading and runs require the published app.

Open Graph Description: Summary Adds examples/local-runner/cloud-app/, a client-only dashboard that reads a configured notebook, renders its input controls, starts detached runs through the Deepnote v2 API, polls them, a...

X Description: Summary Adds examples/local-runner/cloud-app/, a client-only dashboard that reads a configured notebook, renders its input controls, starts detached runs through the Deepnote v2 API, polls them, a...

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

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width