Changelog

What's new in Twiddle

Everything that's changed in Twiddle, release by release. The desktop app checks this list for you and offers to update itself. For the reasoning behind the changes, read the blog.

1. 0.3.1

   You're on this

   Added

   • Twiddle in "Open With". The desktop app now registers as an editor for .md, .markdown and .mdx, so right-clicking a markdown file in Finder or Explorer lists Twiddle — and once it's your default, double-clicking opens the file here. Files opened this way work exactly like ⌘O: edited where they live, saved with ⌘S, never copied into your vault. This lands with the installer, so it starts working the first time you launch this version.

2. 0.3.0

   Added

   • A calendar. Mark a day with @date(2026-09-03) and the note appears on it. Dates are marked rather than guessed at: an editor that scanned your prose for anything date-shaped would put version numbers and identifiers on the calendar and file notes on days you never wrote. The token is forgiving about what goes inside — @date(3 Sep 2026) works too — and @time(09:30) or @time(09:30-11:00) shows alongside. A note with date: in its frontmatter is dated by that; anything else it marks is shown as a day it merely refers to.
   • A map. location: Singapore in a note's frontmatter puts it on the map, and @place(...) marks anywhere else it mentions — a trip written up in one note is several pins. Place names become coordinates using a gazetteer of 34,000 places that ships inside the app, and the basemap is a set of country outlines that ships with it too, so the map contacts nobody. It works with the wifi off. The trade is resolution: coastlines and borders, no streets.
   • Reading dates your way. Settings → Dates chooses how @date(3/9/2026) is read, because those six characters mean 3 September in most of the world and 9 March in the United States. 2026-09-03 and 3 Sep 2026 are never ambiguous and are always read the same way.
   • Sync a vault to a GitHub repository, so your notes reach your phone. The repository and the access token are yours, and none of your markdown passes through us. Images sync too, kept in the attachments/ folder beside the note they belong to. Runs when you press the button in Settings → Sync, never on its own. When the same note changed in both places nothing is merged and nothing is thrown away — GitHub's version takes the file and yours is kept beside it as a conflicted copy.

3. 0.2.1

   Fixed

   • Dragging a note into a folder did nothing in the desktop app. It worked in the browser, which made it look like a Mac problem rather than a real one. Tauri installs its own drag-and-drop handler on the window so it can catch dropped .md files, and the side effect is that the webview stops delivering HTML5 drag events entirely. Dragging is now built on pointer events, which nothing intercepts — so one implementation covers the browser and the desktop, and dropping a file onto the window still opens it. The label that follows the cursor now also says where the note is going.

   Added

   • About, in Settings. The version, what Twiddle is, and links to the changelog, blog and source. On the desktop app there is also a Check for updates button — the automatic check runs once at launch and stays quiet when you're current, which left no way to ask.
   • About Twiddle on macOS now has something in it: version, description and a link to the site, instead of the bare default.
   • A TINYLabs account, optional and free. One sign-in across the TINYLabs apps, by emailed link — no password. It unlocks nothing in the editor today and exists for licences later. Your notes are not involved: they stay plain files on your disk and are never uploaded.
   • A newsletter, if you want it — Twiddle's releases, everything TINYLabs makes, or both.
   • A blog, a download page, and a page for the rest of what TINYLabs builds. The feature list on the home page is now a document you can type into.

   Changed

   • Privacy wording is narrower and truer. "Nothing leaves your machine" became "nothing goes to our servers", which stays honest once optional sync means your own GitHub repo or iCloud Drive — your storage, not ours.
   • Twiddle no longer describes itself by comparison to other markdown apps.

4. 0.2.0

   Added

   • Images in notes. Paste from the clipboard, drag a file in, or pick one from the slash menu. Files are written next to the note in an attachments/ folder and referenced with ordinary ![alt](attachments/name.png) markdown, so they stay readable in any other editor.
   • Automatic updates on macOS and Windows. Twiddle checks on launch and offers to install, replacing the download-it-again-by-hand routine.
   • This changelog, and a /changelog page that renders it.
   • Tutorial steps for tagging a note and adding an image, and a cheat-sheet section covering images.

   Fixed

   • Equations were being deleted from your files. A $…$ node serialized to an empty <span>, which turndown treats as blank and drops, so opening a note containing an equation and typing a single character rewrote the file without it. The LaTeX is now carried as the element's text.
   • Typed [[wiki-links]] were silently destroyed. Nothing converted them as you typed, so they stayed plain text — and turndown escapes [, writing \[\[Note\]\] to disk. That no longer parsed as a link, produced no backlink, and never ticked the tutorial step. Wiki-links now convert on the closing brackets.
   • $e^{i\pi}+1=0$ and $$…$$ now render as you type them instead of only after the note is reopened.
   • Typography was rewriting ^2 to ², which corrupted the exact equation the tutorial asks you to type. Those two substitutions are off; the rest of the prose polish stays.
   • To-dos: - [ ] now creates one, matching the markdown the cheat sheet shows. Previously only [ ] worked, and the instructions said the opposite.
   • Dragging a note into a folder did nothing on macOS. The drop carried the note id in a custom MIME type, which WebKit — Safari and the desktop app's webview — discards; the dragged note is now tracked directly.
   • Tagged releases built installers stamped with the previous version number. src-tauri/tauri.conf.json now reads its version from package.json, so npm version moves the tag, the release title and the filenames together.

   Changed

   • The Windows installer now installs per-user instead of per-machine, so an update no longer needs an administrator prompt every time.

5. 0.1.0

   The first build worth handing to someone else.

   Added

   • WYSIWYG markdown editing on a document model — headings, lists, task lists, tables, code blocks with syntax highlighting, math and highlights, all round-tripping to plain .md.
   • Vaults: point Twiddle at a folder and every .md file inside it becomes a note, with real folders as the tree.
   • Wiki-links ([[Another note]]) with backlinks, and #tags that filter the sidebar.
   • The command palette (⌘P), slash menu, bubble format bar, and a shortcuts dialog that all read from one command registry.
   • Five palettes — Paper, Slate, Ember, Graphite, Phosphor — in light and dark.
   • macOS and Windows desktop builds, plus an installable web app.