Skip to content

ZenNotes v2.88.0

Latest

Choose a tag to compare

@github-actions github-actions released this 19 Nov 16:13
· 3 commits to main since this release

ZenNotes 2.88.0 is a fix release. A drawing created at the root of a vault that keeps its notes at the root no longer disappears from the app the next time ZenNotes starts. The desktop app also bundles zn 0.17.3.

Released from 5d2bc2c0 through #1092 on 2026-11-19.

Fixes

  • Drawings created at the vault root stay where you made them (#1086, reported by @daffamumtaz2361). With Primary notes location set to Vault root and drawings saved to the primary location (both defaults), New Drawing writes the drawing to the vault root, and it opened fine until the app restarted. Then it was gone from the sidebar. Every time a vault opens, ZenNotes moves loose files at the vault root (images, PDFs and the like) into assets/, and it treated a drawing as one of them. Neither the sidebar nor the Assets view shows a drawing inside assets/, so the file was still on disk but could no longer be opened from the app. Drawings at the vault root now stay put; other loose files move into assets/ as before.

    If a drawing already went missing: quit ZenNotes and move it from <vault>/assets/ back to the vault root. ZenNotes does not move it back for you, because it kept no record of which files it moved, and a guess could move a file you put there yourself. Embeds such as ![[Untitled drawing.excalidraw]] find a drawing by its name, so they keep working wherever the file is.

zn

  • The desktop app bundles zn 0.17.3, which keeps a repeating task's block id on the open task when it rolls, the way this app does since 2.87.0 (#1083). A desktop-managed zn already updates itself; this raises the version a fresh install starts from.

Dependencies

  • smol-toml 1.9.1, which reads config.toml in the app, its MCP server and the Quick Look extension. 1.8.0 carried a moderate advisory, GHSA-r4xh-jqrq-34v2: a very large TOML file took quadratic time to parse.

For contributors

  • migrateLooseAssets skips .excalidraw at the vault root, next to its existing skips for notes and databases. assets-migrate.test.ts has a case with a drawing and a PNG at the root: the drawing stays, the PNG moves.

Verification

How to test locally:

  1. Install this release. In Settings, Vault, Notes, set Primary notes location to Vault root and Default drawings location to Primary location (the defaults for a new vault).
  2. Create a drawing with New Drawing (the Drawing button on Home). It lands at <vault>/Untitled drawing.excalidraw.
  3. Quit ZenNotes with Cmd+Q and open it again.
  4. Before: the drawing was gone from the sidebar and the file was at <vault>/assets/Untitled drawing.excalidraw. After: the drawing is still in the sidebar and the file is still at the vault root. A loose image at the vault root, for comparison, still moves into assets/.

Distribution channels

  • GitHub: this release, latest, with all five update feeds. Every file they name was checked, and the app in both macOS DMGs is Notarized Developer ID and stapled.
  • AUR: zennotes-bin 2.88.0-1, pinned to the Linux tarball's SHA-256 e222b2b7…dd79e0.
  • Homebrew: the zennotes cask in ZenNotes/homebrew-tap (2b7c043).
  • Nix: packaging/nix/release-data.json (0732c2a0), built on main (run 44573422004).
  • nixpkgs: NixOS/nixpkgs#585604, zennotes-desktop: 2.83.0 -> 2.88.0, waiting for nixpkgs review.
  • Self-hosted server and Docker: unchanged; server 2.84.1 is current.
  • zn: this app bundles 0.17.3, the latest.
  • Phones: unchanged. Nothing in this release reaches them; iPhone 1.41.0 and Android 1.1.60 are current.
  • Website: the release page on zennotes.org.

Release validation

  • On 5d2bc2c0: typecheck, every test suite uncached (shared-domain 2701, portable-vault 398, app-core 4949, quicklook 18, web 76, desktop 1953), build:prod, npm run pack and the packaged launch check (page target, rendered, 2.88.0), and the three smoke suites. No hazards, no high audit findings, no long dashes.
  • The #1086 fix was also driven in the built app: a Vault Root vault with a drawing and a loose image at its root was opened twice; the drawing stayed at the root and in the sidebar both times, and the image moved into assets/.
  • The gate found one moderate advisory, smol-toml's quadratic parse (GHSA-r4xh-jqrq-34v2). It was bumped to 1.9.1 before the cut and every check ran again on the new commit.
  • CI on the release PR (#1092) and on main passed on every platform at 5d2bc2c0 before the tag.
  • The phones and the server have no change in this release, so no phone builds and no server release were made; the iPhone Cloud UI tests were skipped for the same reason.
  • Not tested before release: packaged Windows and Linux builds beyond CI.