Compare anything. Understand what changed.

📖 Documentation · Download · Changelog

A local-first universal comparison tool for developers. Drop two files, folders, images or clipboard contents — TwinScope detects what they are, picks the right diff engine, and shows what changed.

Your files never leave your machine: no telemetry, no uploads, no account.

Status: 0.3.9 released. Sixteen engines, a twinscope command line, projects, saved comparisons, shareable reports and an opt-in update check. 0.3.9 is a fix release over 0.3.8, whose macOS and Linux arm64 builds compare real PDFs as binaries — take 0.3.9 if you compare PDFs. The macOS builds are unsigned — macOS will refuse to open the app until you right-click → Open → Open. See docs/release.md and the install guide.

Every comparison opens with counts, then the detail. Normalisation is explainable and reversible: anything hidden is counted, named, and one click from coming back.

nvm use          # or: nvm install 24
npm install      # postinstall also fetches the Electron binary
npm run dev      # opens the app with hot reload

That's the whole setup. If npm run dev complains that Electron is missing, re-run npm install — see Troubleshooting.

src/
├── main/       Electron main process — windows, security, IPC
├── preload/    the only bridge between renderer and main
├── renderer/   React UI
├── shared/     cross-process contracts (channel names, types)
└── engines/    comparison engines — pure logic, no Electron, no DOM
e2e/            verification harness (see below)

Three boundaries are enforced by ESLint rather than convention:

• The renderer cannot import node:* or electron. It talks to the main process only through window.twinscope, exposed by the preload script.
• Engines cannot import electron, so the planned CLI can reuse them unchanged.
• src/shared/channels.ts stays dependency-free, because the sandboxed preload imports it.

npm run verify is a harness, not a test suite. It builds the app, boots it in Electron, and gives you a real page to drive:

const harness = await launchApp();
await harness.page.getByTestId('…').click();
await harness.screenshot('what-i-changed');
expect(harness.errors).toEqual([]);

Screenshots land in e2e/.artifacts/screenshots/. Keep e2e/verify.spec.ts small — its security assertions are permanent; for one-off checks, write a throwaway spec and delete it after.

The renderer is treated as untrusted. src/main/security.ts enables the sandbox and context isolation, disables node integration, sets a Content-Security-Policy, and denies navigation, new windows, <webview> embedding and every permission request. npm run verify asserts these hold — a regression there is a remote-code-execution bug, not a UI bug.

"Electron failed to install correctly" / no window opens. npm gates dependency install scripts, so Electron's own postinstall never runs and the binary is missing. scripts/ensure-electron.mjs handles this from the root postinstall; run npm install, or node scripts/ensure-electron.mjs directly.

Don't bump Vite past 7 or TypeScript past 6.0. electron-vite peers on Vite ^5 || ^6 || ^7, and typescript-eslint peers on TypeScript <6.1.0 — TypeScript 7 is the native compiler and has no lint support yet. These are the newest versions the whole toolchain agrees on.

MIT

Full documentation lives at codeaesthetic.github.io/twinscope-website — every engine, every keyboard shortcut, what is stored and what never is, and a screenshot or GIF of each feature captured from the running app.

Its source is codeAesthetic/twinscope-website. The screenshots are produced from this repo by npm run capture, so re-run it after any UI change rather than editing images by hand.