Ledge

by lunarch
5
4
3
2
1
Score: 52/100

Description

Reviews

No reviews yet.

Stats

1
stars
606
downloads
0
forks
46
days
31
days
31
days
3
total PRs
0
open PRs
1
closed PRs
2
merged PRs
0
total issues
0
open issues
0
closed issues
306
commits

Latest Version

a month ago

Changelog

Ledge 2.3.0

  • Centralize workspace, metadata, window, and vault subscriptions in one runtime coordinator instead of registering a full global event set for every Dock.
  • Keep disabled Dock presets data-only while maintaining renamed targets, visibility paths, and remembered vault icons through one shared path-maintenance transaction.
  • Share one document/leaf/context registry across simultaneous Docks so workspace traversal and active-note context resolution are no longer repeated per Dock.
  • Add dirty-domain rendering so style, geometry, visibility, item, icon, and position changes update only the affected runtime work instead of rebuilding every Dock item for unrelated settings changes.
  • Cache target resolution by stable item identity and invalidate it on relevant vault or metadata changes, reducing repeated link-path resolution during active-state refreshes.
  • Serialize plugin-data writes and coalesce bursts of non-structural settings changes while keeping structural operations immediately durable.
  • Bound Iconify searches to smaller result sets, debounce remote queries, discard stale results, and deduplicate in-flight icon search/fetch work.
  • Upgrade persisted and exported settings to canonical schema v3: docks is the single stored Dock source of truth, while selected-Dock compatibility fields are non-enumerable live accessors rather than duplicated runtime state.
  • Keep raw legacy settings plus schema-v1 and schema-v2 backups import-compatible, and automatically rewrite older plugin data into canonical schema v3 on load.
  • Harden CI and release validation so dev, prerelease, and stable run the same checks and release tagging validates an immutable source commit instead of modifying source during publication.
  • Add regression coverage for runtime ownership, shared workspace traversal, disabled-Dock lifecycle, incremental DOM reconstruction, target caching, persistence ordering, path maintenance, and schema-v3 migration.

Full Changelog: https://github.com/llocphann/Ledge/compare/2.2.2...2.3.0

README file from

Github

Ledge

Ledge adds customizable navigation docks to the edges and corners of your Obsidian workspace, keeping frequently used notes, Bases, canvases, and other vault files within reach.

Highlights

  • Create up to 8 independent Docks and use them at the same time.
  • Place Docks on the left, right, top, bottom, or any corner.
  • Add shortcuts to notes, Bases, canvases, and other vault files.
  • Use built-in icons from Obsidian/Lucide, Tabler, Material Design Icons, Phosphor, and Bootstrap Icons, or use images stored in your vault.
  • Configure auto-hide, reveal/hide timing, trigger areas, labels, motion, and macOS-style magnification.
  • Show or hide each Dock by note name, exact path, folder, or tag.
  • Customize Dock surfaces, borders, colors, gradients, item icons, and tile appearance.
  • Reorder items with drag-and-drop or keyboard controls.
  • Navigate in the current leaf without creating unnecessary tabs.
  • Works with pop-out windows.
  • Export and import your complete Ledge configuration as JSON.

Install

Community Plugins

Open Settings → Community plugins → Browse, search for Ledge, then install and enable it.

Manual installation

Download main.js, manifest.json, and styles.css from the latest release and place them in:

<Vault>/.obsidian/plugins/ledge/

Reload Obsidian and enable Ledge under Community plugins.

Ledge is desktop-only and requires Obsidian 1.13.7 or newer.

Documentation

See the Ledge Wiki for detailed guides to Dock presets, items and icons, visibility rules, auto-hide and triggers, appearance, backup/restore, and troubleshooting.


☕ Support Ledge

If Ledge has made navigating your Obsidian workspace faster or more comfortable, you can support its continued development here.

Your support helps me keep refining Ledge, improving dock behavior, customization, visibility rules, and documentation.


License

Ledge is licensed under the GNU General Public License v3.0 only.