Skip to content

Releases

Planchette v0.2.0-beta.1

Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Nov 22:11

What changed

A beta of 0.2.0, for testing on a real table. Published as a pre-release.

Added

  • Run interfaces on a real table. The desktop app listens for TUIO 1.1 from
    a table's tracker (pucks and fingers) and feeds it to interfaces exactly as
    the simulator does, so they need no changes. Off unless switched on in
    Settings > Table input; a designer's machine never opens a socket. See
    docs/TABLE.md.
  • Present mode for the table's own computer: fullscreen on the table's
    display at one table pixel per screen pixel whatever the display scaling, no
    authoring chrome, native touch ignored. Table > Enter Present Mode, or
    "present": true in table.json to boot into it.
  • A control puck that opens an interface picker on the table: put it down,
    turn it, touch an interface to open it.
  • Table > Assign Pucks maps the tags printed on a table's pucks to the
    marker numbers interfaces use, and Table > Calibrate lines the tracker up
    with the screen. Both apply live. Stored per computer in table.json.
  • scripts/tuio-send.mjs, a stand-in tracker for working without a table.
  • npm test: unit tests for OSC decoding, TUIO frames, table.json and
    workspace upgrades, gating CI on both runners.

Changed

  • Workspaces are now kept up to date. Opening a workspace refreshes its
    reference docs, SDK types and agent guidance when the app has newer ones. A
    file you edited is kept, with the new version written beside it
    (API.new.md); anything you deleted stays deleted; interfaces and examples
    are never overwritten. A notice says what changed. Works for workspaces
    created by 0.1.0 and 0.1.1.
  • table.version and the SDK's hello now report the app's version. They said
    0.1.0 in every release so far.

Installing

These builds are unsigned, so both systems object the first time. Once per
machine:

macOS — right-click the app and choose Open, then confirm. If it still
refuses, or it arrived as a zip through Slack:

xattr -cr "/Applications/Planchette.app"

Windows — SmartScreen shows "Windows protected your PC". Click More info,
then Run anyway.

Which file

You have Download
Apple Silicon Mac the arm64.dmg
Intel Mac the plain .dmg
Windows setup.exe to install, or the portable .exe to just run it

First run

Planchette creates a workspace at ~/Documents/Planchette (Windows:
Documents\Planchette) holding four example interfaces, the API reference, and
the design rules. Everything in the App menu comes from that folder.

Making your own, with an agent

File > New interface… scaffolds a folder with starter files. Then open that
folder in Claude Code, or whatever coding agent you use, and describe what you
want:

make a puck that scrubs through a video, with the timeline
under the puck and a filmstrip along it

You do not need to explain the table, the units, or the puck API. The workspace
already carries the SDK reference, the design rules, type declarations, and a
skill that fires when you mention pucks or a table, so an agent opened on that
folder starts with everything it needs.

Save a file and the app reloads it, keeping your pucks where they were.

GETTING-STARTED.md in the repository has the full walkthrough, and
DESIGN-RULES.md in your workspace has the handful of rules that decide whether
an interface works on a real table.

Planchette v0.1.1

Choose a tag to compare

@github-actions github-actions released this 26 Aug 13:45

What changed

Fixed

  • Reopening the window from the macOS dock left it permanently blank. IPC
    handlers were registered per window, and ipcMain.handle refuses a second
    registration for the same channel, so the throw landed before the window was
    ever pointed at a URL. They are now registered once for the process.
  • Two copies running at once raced on settings.json, each overwriting the
    other's idea of the current workspace. A second launch now focuses the
    existing window instead.
  • The workspace file watcher was not closed on quit.
  • macOS builds carried Copyright © 2026 Planchette, the product name standing
    in for a vendor, because package.json named no author.

Security

  • An interface could navigate the whole shell away from the app and leave no way
    back. Interfaces share the host's origin by design, so window.top was
    reachable from inside the frame; only the main process could refuse it, and
    it now does.
  • The host UI is served with a Content Security Policy. It is deliberately not
    applied to interfaces, which are meant to run whatever inline script their
    author wrote in their own folder.
  • Interface and workspace names were interpolated into the pickers as markup, so
    a folder named like an HTML tag ran script in the document that holds the
    preload bridge. Options are built as DOM nodes now.
  • The SDK accepted table messages from any window rather than only from the
    host, which the host was already checking for in the other direction.

Added

  • MIT licence. The notice ships inside the app bundle and the web artifact, not
    only in the repository.
  • npm run lint (oxlint) and npm run format (Prettier), both gating CI.
    oxlint is the only static checking electron/ and scripts/ get, being plain
    JavaScript that tsc never sees.
  • engines.node, repository, and author in package.json.

Changed

  • Release pages now say what changed. The body was previously install
    instructions alone, identical for every version; it now leads with that
    version's changelog section, assembled by scripts/release-body.mjs. A
    release whose version has no changelog section fails the build rather than
    publishing a page that says nothing.
  • Workspace files are served with Cache-Control: no-store. The watcher's
    reload worked before only because a response with no validators happens to be
    treated as stale.
  • The model and the input layer use the SDK's existing angleDelta rather than
    each reimplementing it. No behavioural change.
  • Removed a write-only counter from the radial-atlas example, which designers
    read as reference code.

Installing

These builds are unsigned, so both systems object the first time. Once per
machine:

macOS — right-click the app and choose Open, then confirm. If it still
refuses, or it arrived as a zip through Slack:

xattr -cr "/Applications/Planchette.app"

Windows — SmartScreen shows "Windows protected your PC". Click More info,
then Run anyway.

Which file

You have Download
Apple Silicon Mac the arm64.dmg
Intel Mac the plain .dmg
Windows setup.exe to install, or the portable .exe to just run it

First run

Planchette creates a workspace at ~/Documents/Planchette (Windows:
Documents\Planchette) holding four example interfaces, the API reference, and
the design rules. Everything in the App menu comes from that folder.

Making your own, with an agent

File > New interface… scaffolds a folder with starter files. Then open that
folder in Claude Code, or whatever coding agent you use, and describe what you
want:

make a puck that scrubs through a video, with the timeline
under the puck and a filmstrip along it

You do not need to explain the table, the units, or the puck API. The workspace
already carries the SDK reference, the design rules, type declarations, and a
skill that fires when you mention pucks or a table, so an agent opened on that
folder starts with everything it needs.

Save a file and the app reloads it, keeping your pucks where they were.

GETTING-STARTED.md in the repository has the full walkthrough, and
DESIGN-RULES.md in your workspace has the handful of rules that decide whether
an interface works on a real table.

Planchette v0.1.0

Choose a tag to compare

@github-actions github-actions released this 21 Aug 23:31

Installing

These builds are unsigned, so both systems object the first time. Once per
machine:

macOS — right-click the app and choose Open, then confirm. If it still
refuses, or it arrived as a zip through Slack:

xattr -cr "/Applications/Planchette.app"

Windows — SmartScreen shows "Windows protected your PC". Click More info,
then Run anyway.

Which file

You have Download
Apple Silicon Mac the arm64.dmg
Intel Mac the plain .dmg
Windows setup.exe to install, or the portable .exe to just run it

First run

Planchette creates a workspace at ~/Documents/Planchette (Windows:
Documents\Planchette) holding four example interfaces, the API reference, and
the design rules. Everything in the App menu comes from that folder.

Making your own, with an agent

File > New interface… scaffolds a folder with starter files. Then open that
folder in Claude Code, or whatever coding agent you use, and describe what you
want:

make a puck that scrubs through a video, with the timeline
under the puck and a filmstrip along it

You do not need to explain the table, the units, or the puck API. The workspace
already carries the SDK reference, the design rules, type declarations, and a
skill that fires when you mention pucks or a table, so an agent opened on that
folder starts with everything it needs.

Save a file and the app reloads it, keeping your pucks where they were.

GETTING-STARTED.md in the repository has the full walkthrough, and
DESIGN-RULES.md in your workspace has the handful of rules that decide whether
an interface works on a real table.