Changelog

Typewriter Mode

• New focused writing mode that keeps the active line centered in the editor
• Toggleable via Settings > Editor or the Command Palette
• Smooth scrolling ensures your eyes stay in the middle of the screen as you type

Advanced Image Management

• Support for Drag & Drop and Paste of images directly into the editor
• Images are automatically saved to a local assets/ folder relative to your document
• Instant Markdown insertion with relative paths for portability

Knowledge Graph & Wikilinks

• Added support for [[wikilinks]] syntax for interconnected note-taking
• New Backlinks panel on the right side shows all incoming connections to the current note
• Clicking any wikilink or backlink instantly opens the target note within your workspace

Advanced Git Dashboard

• New visual Git Dashboard panel (Cmd+K to toggle)
• Commit History: Browse the last 20 commits with hashes, authors, and dates
• Live Diff: View line-by-line changes for the current file directly in the sidebar

UI Improvements

• New toggleable side panels for Backlinks and Git history
• Command Palette expansion with quick toggles for all new features
• Theme-consistent styling for all new components

Multi-folder Workspaces

• Added workspace support: create a .crabpad file in any directory to define a multi-folder project
• Workspaces remember open tabs, cursor positions, sidebar state, and layout between sessions
• Open, create, and switch workspaces via Command Palette or the Welcome screen
• Add and remove folders from an active workspace directly in the sidebar explorer
• Recent Workspaces section on the Welcome screen for quick access to previous projects

File Explorer Enhancements

• Added file operations in the sidebar: create files, create folders, rename, and delete
• Inline editing for new file/folder names and renames directly in the explorer tree
• Context menu (right-click) on any file or folder with all available actions
• Hover action buttons on files (rename, delete) and folders (new file, new folder)

Breadcrumbs Navigation

• Added a file path breadcrumb bar above the editor showing the current file location
• When a workspace is active, breadcrumbs display the workspace name and relative path
• Unsaved changes indicator integrated into the breadcrumb bar

Welcome Screen

• Added Recent Directories section derived from recently opened files
• Clicking a recent directory opens the file picker starting in that location
• Added Open Workspace and New Workspace buttons in Quick Start

Housekeeping

• Removed unused TipTap editor dependencies, reducing bundle size by 75 packages

Git Workflow (MVP)

• Added built-in Git workflow in CrabPad: file status badges, branch display in status bar, branch switching, commit selected files, and rebase with auto-stash
• Added Git Actions panel with improved branch picker behavior and clearer selection flow
• Added Git provider settings with support for System Git and Built-in Git, including availability checks and fallback handling

File Watching & Tab State

• Open files now run in watch mode and automatically refresh in the editor when changed externally
• If a file is deleted outside CrabPad, its tab is shown in red with strikethrough and autosave is disabled for that tab
• Manual save can restore a deleted file at its previous path

Editor UX

• Added optional Key Helper overlay (enabled by default) that shows possible shortcuts based on currently held modifiers (for example Cmd, Cmd+Shift)
• Key Helper can be disabled in Settings -> Editor
• Renamed settings section label from Editor & Auto-save to Editor

Update Reliability Fix

• Fixed release version metadata mismatch that could cause the app to restart still showing an older version after in-app update
• Ensured updated builds report and launch the correct version after restart

Fixed Save Location for Linux AppImage

• Save dialog no longer defaults to the AppImage mount path (for example /tmp/.mount_.../usr)
• For new files, default save path now points to a user-friendly location: ~/Documents/Untitled.md
• If Documents is unavailable, CrabPad falls back to ~/Untitled.md
• Existing files keep their current save path behavior

Improved Update Experience

• In-app update modal with real-time download progress bar, version info, and release notes — replaces silent native dialogs
• Update states clearly visible: checking, available, downloading (with MB counter), installing, ready to restart
• Restart Now button after successful install — no more guessing if the update worked
• Error state links to crabpad.app/contact for easy bug reporting

Homebrew Support (macOS)

• Install via brew install --cask LukaszOleniuk/tap/crabpad — bypasses Gatekeeper, no manual xattr needed
• Cask auto-updated on each release via CI/CD

Features

• Zen Mode: Distraction-free writing — hides all UI chrome, centers the editor, and bumps font size. Toggle with Cmd+Alt+Z.
• Reset Keybindings: One-click “Reset to default” button in Settings to restore all shortcuts.
• Extended File Support: Open 9 Markdown-related file formats including .mkd, .mdwn, .mdown, .mdtxt, and .text.

Improvements

• Reliable Shortcuts: Capture-phase event handling ensures shortcuts work consistently across all views.
• Physical Key Detection: Shortcut matching now falls back to physical key codes, fixing Alt-modified key issues on macOS.
• Keybinding Recorder: Recording custom shortcuts in Settings now properly captures key combinations.
• Outline Shortcut: Changed Toggle Outline from Cmd+L to Cmd+Shift+E to avoid WebView conflicts.
• Escape Handling: Escape key now closes UI elements in correct priority order — modals first, then Zen Mode, then search.

Website

• Google Analytics: Added download tracking per platform and page view analytics.
• Updated Screenshots: Fresh app screenshots reflecting the current UI and new features.

Features

• Draggable Tabs: Reorder open tabs by dragging them with the mouse.
• Global Search Tab: Search across all files via CMD+Shift+F, now opens as a tab.
• Persistent Settings: User preferences saved outside the app bundle, surviving updates.

Infrastructure

• Auto-Update: In-app update checks with signed artifacts for secure delivery.

Experience

• Zen Mode: A seamless, distraction-free environment with intelligent state restoration.
• Velocity Shortcuts: Precise navigation via CMD+Shift+E (Outline), CMD+O (Open File), and CMD+Shift+P (Command Palette).

Markdown Engine

• Advanced Rendering: Native support for Footnotes, Definition Lists, and Abbreviations.
• Visual Admonitions: Styled containers for Warning, Info, and Success notes.