Releases: pmslava/joplin-plugin-harper
Release list
v1.3.2
Two multi-window fixes:
- Secondary windows: styled card and underlines. The suggestion card and per-kind underline colors now render correctly in notes opened via "Open in new window" — previously the card appeared unstyled and underlines fell back to editor defaults.
- All windows stay fresh. Settings changes, Add to dictionary, and Disable rule now re-lint every open window, not just the focused one — propagation is near-instant.
Under the hood: style injection and card DOM are now per-window-document; a config-generation subscription lets every editor hear about changes over the plugin bridge; two new two-window e2e specs (both verified red on the pre-fix build, green after); stale-lock race hardening in the e2e guard.
v1.3.1
Documentation release. The README now properly documents the dictionary note (the shared word list that syncs across devices, and the only dictionary mechanism on mobile), Android installation steps, and the mobile settings path. No code changes.
v1.3.0
Dictionary deletions now stick. Deleting a word from the Harper Dictionary note (or the external file) removes it everywhere - it no longer reappears after sync. The sync is a proper three-way merge: additions and deletions both travel between the note, the external file, and all your devices; if the same word is added on one side and deleted on another, the addition wins. File writes are now atomic and preserve your file's line order; duplicate lines are cleaned up; add-to-dictionary no longer appends a word the file already has. Also fixes stale docs (mobile support has been in since v1.1.1).
v1.2.0
New setting: Underline style — choose between the classic squiggly underline and a clean solid line (with a subtle background tint), both in Harper's per-kind colors. Requested by the community in Automattic/harper#1710. Find it in Tools → Options → Harper. Applies live — no need to reopen your note.
v1.1.1
Harper goes mobile: this release runs on Joplin Android (3.3+) as well as desktop.
Mobile support
- Grammar and spell checking in the mobile Markdown editor: colored squiggly underlines, tap an underline for the suggestion card (touch-sized buttons), one-tap fixes, add-to-dictionary, dismiss, disable-rule.
- Fully offline on mobile too — the WASM engine ships inside the plugin.
Unified dictionary across devices
- New: a synced "Harper Dictionary" note (create it via the "Harper: Create dictionary note" command). Words added on any device sync everywhere through Joplin's own sync.
- Desktop can additionally mirror the note to a plain-text dictionary file (the existing external-dictionary setting), keeping external tools like harper-ls/Zed in the same loop.
- Writes are carefully deferred so background updates never disturb an open editor.
Under the hood
- Unified WASM loading on both platforms (the plugin file grows to ~21 MB; functionality unchanged on desktop).
- Faster startup: the engine now warms in the background at launch instead of on your first keystroke.
Install: marketplace, or the .jpl below → Tools → Options → Plugins → Install from file. Mobile requires enabling plugin support in Joplin Android's settings (Beta).
v1.0.2
The suggestion card now opens on click only — matching the Harper browser extension. The hover tooltip is removed, so no more doubled cards, and clicking into a word to edit it by hand dismisses the card on your first keystroke (Escape and clicking elsewhere also close it).
v1.0.1
Small usability release.
- Click to open: clicking a lint underline now opens the suggestion card — hover still works too. (Matches the Harper browser extension's behavior.)
- Live debounce: changing the lint debounce setting now applies immediately, no need to reopen the note.
- Hardened the ignore/dismiss end-to-end test to verify persisted state content.
Install: download io.github.pmslava.harper.jpl below → Joplin → Tools → Options → Plugins → Install from file — or via the plugin marketplace once listed.
v1.0.0
First public release: the Harper grammar checker integrated into Joplin desktop's Markdown editor.
Features
- Fast, fully offline grammar and spell checking powered by Harper (Automattic) — the WASM engine ships inside the plugin; no network calls, no telemetry.
- Colored squiggly underlines, one color per issue type (all 21 Harper lint kinds), matching Harper's own palette in light and dark themes.
- Harper-style suggestion card on hover: issue type, explanation with the flagged word highlighted, one-click fix pills, add-to-dictionary, dismiss (ignore), and a disable-rule toggle.
- English dialects: American, British, Australian, Canadian.
- External dictionary: point the plugin at a plain word-per-line file — words added from the editor are appended there, and outside changes are picked up automatically (~60 s), so the list can be synced between machines and shared with other Harper tools.
- Settings: master switch, dialect, lint debounce, external dictionary path, advanced per-rule JSON overrides.
Requirements
Joplin desktop 3.1+, Markdown editor only, desktop only. First check after startup takes a second or two (engine warm-up); afterwards ~50 ms per pass on a typical note.
Install: download io.github.pmslava.harper.jpl below → Joplin → Tools → Options → Plugins → Install from file.