Skip to content

Planchette v0.1.1

Latest

Choose a tag to compare

@github-actions github-actions released this 26 Aug 13:45
· 3 commits to main since this release

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.