Repository navigation
What changed
Fixed
- Reopening the window from the macOS dock left it permanently blank. IPC
handlers were registered per window, andipcMain.handlerefuses 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, becausepackage.jsonnamed 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, sowindow.topwas
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) andnpm run format(Prettier), both gating CI.
oxlint is the only static checkingelectron/andscripts/get, being plain
JavaScript thattscnever sees.engines.node,repository, andauthorinpackage.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 byscripts/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
angleDeltarather than
each reimplementing it. No behavioural change. - Removed a write-only counter from the
radial-atlasexample, 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.