Releases: johngarg/obsidian-slipbox
Release list
0.16.0
Slipbox Desk 0.16.0 adds vertical Deck browsing, Drawer and Fan layouts, custom card styling, and stable Desk positioning. Requires Obsidian 1.13.0 or later on desktop.
Added
-
Bring the Deck in front of all Desk piles or send it behind them from a Deck
card or workspace context menu. The choice lasts for the current pane's session;
the Deck starts behind piles, and Branch View stays above both. -
Supported CSS properties for fixed or responsive card sizes, shared card shape,
paper and typography, with a ruled index-card example. Deck spacing and visibility
follow custom dimensions, and reading and editing share the chosen appearance. -
Toggle Deck orientation from the command palette or a configurable Deck shortcut,
preserving browsing position and custom navigation bindings. -
Position the Deck near the left and right with
zhandzl. Directional
positioning now preserves the other axis;zzcentres both axes and resets pan. -
Adjustable Card fading, from fully opaque cards to twice the default fade rate.
-
Optional bottom headers for cards below the anchor in vertical Fan, making
their addresses and titles readable in the overlapping stack. Bottom headers
replace the ordinary backlink footer. -
Vertical Deck orientation, independent Drawer/Fan stacking and deterministic
card splay. Drawer is the new default and opens a reading gap in filing order. -
Left Branch View placement, with full-size branch columns reachable by workspace
panning, and a vertical Deck map and bookmark edge controls. -
Body-first vertical wheel navigation with boundary resistance, plus a setting
to browse the Deck directly. Vertical header drags pan; sideways drags pull cards
onto the Desk. -
Orientation-aware default arrow keys that preserve customized shortcuts.
Changed
- Ordinary Drawer card clicks return the selected card to its chosen reading
position, including after panning the already focused card. Selection, reading-gap
movement and pan reset animate together along the Deck axis, preserving the
perpendicular arrangement. Drawer defaults to centred reading alignment along
its sequence; explicit positioning commands remain in effect. - Deck cards now default to fixed Small/Medium/Large dimensions (720 × 480,
840 × 560, and 960 × 640 px), including in narrow panes. Pan to reach content
outside the pane; viewed cards and Desk piles retain their existing sizing. - Lowered minimum card spread to 0.10 and made card rendering follow the visible
geometry instead of a fixed neighbour limit. - Relicensed Slipbox Desk from 0BSD to the MIT License.
Fixed
-
Keep Desk piles above the Deck by default, and Branch View and its controls
above both card surfaces, so overlapping cards cannot hide navigation controls. -
Keep existing Desk piles in place when switching Deck orientation, including
automatically placed piles and repeated switches between layouts. -
Keep Deck cards under the pointer when starting a Desk drag after positioning
the Deck near an edge or corner. -
Keep vertical trackpad gestures moving through focus changes in Fan and Drawer,
including when the starting card moves off screen. Card-body boundary resistance
now subtracts only 48 px instead of discarding an entire large scroll event. -
Trackpad scrolling moves Drawer cards with the gesture instead of repeatedly
easing the whole deck toward a moving target. Reading-gap changes still animate. -
Reduce fast Deck scrolling stalls by avoiding unnecessary overflow-button
measurements when card branch labels and backlinks already fit. -
Branch View updates its owner geometry after card-height-only changes.
-
Centre the vertical Deck map with matching end margins that clear the status
bar, keeping its hover readout and click targets aligned. -
Fix duplicate settings-row names and cleanup errors when refreshing or closing
the settings screen. -
Avoid repeated card-list scans during Deck scrolling in large vaults.
-
Deck scrolling batches motion into animation frames and reuses unchanged
bookmark controls, avoiding redundant card styling and layout work. -
Sustained Drawer scrolling now releases off-screen cards during transitions,
preventing rendering work from growing with the distance browsed. -
Centred vertical Deck map bookmark, active, colour, and Desk markers on the rail.
-
Kept
ztandzbpositioning inside the pane by accounting for the fixed card
height. In panes shorter than a card, the requested top or bottom edge remains
visible without resizing the card. -
Restored smooth Deck scrolling after the Fan flicker fix by caching moving
card surfaces while retaining the background scroll-layer protection. -
Kept native scrolling on the anchor card only and contained painting within
card frames to address Fan artifacts where background scroll layers covered
the focused card. Background cards retain their body scroll positions. -
Kept branch annotation fitting independent of card splay and scale, preventing
labels from flickering between their text and an overflow count. -
Corrected vertical bookmark tab corners to face the top and bottom pane edges.
-
Stacked vertical Branch View controls beside the focused card’s top-left corner,
with the toggle first and direction icons adapted to vertical navigation. -
Avoided Obsidian tooltip errors when hovering SVG Branch View controls while
retaining their accessible labels.
Full changelog: 0.15.0...0.16.0
0.15.0
0.14.0
Added
- Added optional theme-aware card colours selected through the combined new-card
options dialog. Quick creation remains uncoloured, while the prompted commands
retain their IDs and now expose accessible circle buttons alongside the
optional title. Headers use an adaptive light/dark tint, Deck-map markers keep
the selected colour, and bookmarks surround those markers with an accent ring. - Added optional supplementary branch links using the fixed canonical
+alias
syntax, such as[[card|+a]], with interactive incoming labels on Deck,
Desk, and viewed cards. Marked aliases can receive a quiet outline in
rendered Slipbox card bodies and hide their+prefix there by default,
while labels that do not fit the header collapse into a+Nmenu. Exact
aliases for+-addressed cards remain ordinary;++addressasserts a branch
whose label is+address. - Added optional inserted branches derived from address extension.
- Added an expanded-by-default local Branch View beneath the active Deck card.
Its deterministic SVG shows the current strand, one higher context, active
departures, hidden-branch stubs, responsive counted ellipses, exact duplicate
cards, and labelled supplementary edges. Six movement actions are available
from the command palette with Vim-inspired defaults;btoggles per-view
visibility by default. - Added a Branching settings group. Both branch models are derived in memory
and never rewrite notes or addresses.
Changed
- Changed the default inline-edit shortcut from
eto Vim-stylei. - Reassigned the default bookmark, Branch View, and Deck-map shortcuts to
m,
b, andO, respectively. Saved copies of the unreleased earlier defaults
are replaced on load, while bindings that were actually customized remain. - Split branching settings into relationship and presentation groups, clarified
supplementary-label scope, and shortened the Branch View action names. Turning
off Show local Branch View now removes its control rail and disables its
toggle action instead of leaving a per-view override available. - Replaced the pile-dependent centre shortcut with Vim-style
zt,zz, and
zbDeck positioning at 33%, 50%, and 67% of the view, respectively. New
views initially usezbwhen the reconstructed unfiled-card pile exists and
otherwise usezz;cis no longer bound by default. - Enlarged local Branch View nodes, reduced their address type, aligned each
departure one column to the right of its source, straightened branch
connections, and tightened the spacing between strands. - Presented the local Branch View as an uncapped transparent diagram beneath
its card, widened it within the Deck stage, enabled Deck panning from its
noninteractive space, and added a card-aligned floating control rail. A
persistent standardgit-branchicon toggles the diagram, while its six
standard movement icons extend to the left only while the view is shown. - Replaced repeated supplementary movement buttons with one stable icon per
movement. A single destination opens directly and several destinations use
the exact-card chooser shared with command-palette navigation; supplementary
choices now show their aliases and include them in search. - Made duplicate-address cards consecutive strand members in normal Deck order;
backward, forward, beginning, and higher movement now choose one exact card
directly instead of presenting all cards at that address in a chooser. - Adopted the archive terms “inserted” and “supplementary” throughout the
interface, commands, settings, and documentation. - Clarified branching terminology: a strand is a linear card sequence, while a
branch is a departure or relationship between strands. - Divided the Branching settings into supplementary and inserted subsections.
- Coalesced metadata-driven index rebuilds and removed redundant Deck renders
when ordering, creating Desk cards, filing, or adjusting card spread. - Standardised the current implementation, commands, and styling hooks on
“Desk” and the schema-14 data model.
Removed
- Removed pre-schema-14 settings migrations, the legacy persistent Desk and
Canvas export, Tray-named settings and styling aliases, and deprecated source
exports. Upgrading now resets settings while retaining path bookmarks; Desk
command hotkeys and Tray-based CSS customisations must be configured again.
Fixed
- Preserved supplementary strand context while navigating between exact cards
that share one address. - Removed whole-card identity tooltips from Deck, Desk, and viewed cards while
retaining their accessible names and all tooltips on their controls. - Removed duplicate native tooltips from Branch View controls and prevented its
accessible region and toolbar names from appearing as tooltips when disabled. - Kept a Branch View tray's horizontal position when expanding an omission and
showed the actual card instead of an equally wide ellipsis for singleton runs. - Kept wheel gestures over the local Branch View scroller inside the tray
instead of moving the surrounding Deck. - Restored higher-context hidden-branch stubs to point up and right while all
other stubs retain the same compact down-and-right orientation. - Kept hidden-branch stub hit targets outside their node circles, so clicking a
node consistently activates it and reveals all of its branches instead of
intermittently opening the single-branch expansion chooser. - Kept supplementary Branch View continuations inside their address-extension family,
so comma-number strands such as17,1,1and17,1,2no longer absorb a
separate appended-letter strand such as17,1Aand17,1a. - Bounded promoted supplementary strands at the next supplementary start so diagram and
command navigation cannot cross into a neighbouring supplementary strand. - Made every interactive hidden-branch stub reveal one bounded auxiliary row,
including stubs on departure rows, while suppressing stale, recursive, and
already-visible departures. - Reused one prepared local Branch View projection across command-availability
checks instead of rebuilding every filed card and title for each command. - Elided long local Branch View addresses from the beginning and reserved more
clearance between node labels and their circles. - Partitioned local Branch View departures at later supplementary branch starts
so one inserted continuation is never repeated across several strands. - Prevented pointer navigation on the Deck map from retaining DOM focus and
later acquiring a keyboard-focus outline during ordinary Deck navigation. - Coordinated index, Desk, and view updates after filing, and stopped reporting
bookmark saves as successful when persistence fails. - Kept the inline Desk filing field evenly highlighted, within the normal
header height, and adjacent to the card title. - Stopped blank or missing frontmatter title properties from displaying the
card filename as a Deck, Desk, or viewed-card header title. - Kept “Return from Desk” visually consistent with the other card actions
instead of giving it a disabled-looking grey background. - Disabled filing confirmation while the duplicate-address policy blocks the
entered address. - Made the tooltip preference apply to local Branch View controls, branch annotations,
and links rendered inside Deck and Desk cards. - Made Follow links from cards govern supplementary branch-label navigation as
well as ordinary links and backlinks, while preserving independent previews
and removing underlines from inert rendered card links. - Kept annotated Desk-card headers stable while labels, titles, and action
overflow are fitted, reserved only the signature’s measured content width,
and omitted the address separator when no annotation is present. - Kept available Deck commands runnable from the command palette while its
search field is focused. - Kept text-setting validation messages on their own row beneath the input.
- Promoted supplementary and inserted branching to separate top-level settings groups.
- Removed CSS constructs flagged by Obsidian's community-plugin scanner while
preserving signature focus and drag-time navigation behavior. - Desk piles can now be laid out on existing Canvases, including newly created
empty Canvases. - Kept card interactions, dragging, links, modals, and fitted controls in the
correct window after moving Slipbox Desk to an Obsidian popout.
0.13.0
Added
- Added pile context-menu actions for bringing a pile to the highest ordinal
or sending it to the lowest, while expanded piles remain above collapsed
piles.
Changed
- Replaced Show card tooltips with Show tooltips, which controls all
Slipbox-view tooltips while retaining accessible labels when disabled.
Fixed
- Kept late metadata updates from remounting a card as inline editing closes.
- Kept a viewed card mounted when one of its links moves the Deck anchor.
- Deleted cards now follow Obsidian's confirmation and trash workflow once,
without a second trash attempt or an erroneous missing-file notice. - Card-header buttons now act on their own card without first moving card
focus or the Deck anchor.
0.12.2
0.12.1
0.12.0
Slipbox Desk 0.11.1
Slipbox Desk 0.11.1
This patch release changes the plugin's display name from Slipbox to Slipbox Desk, giving it a unique name for submission to Obsidian's Community Plugin Directory.
The stable plugin ID remains slipbox, so existing installations, settings, commands, and stored data continue to work normally. Plugin behavior is unchanged.
Also included
- Refreshed README and user-facing labels for Community Plugin Directory publication.
- Added clear bug-reporting guidance and links.
- Updated release-candidate smoke-test documentation for the new display name.
Verification
- The full automated suite passes: 354 tests across 62 suites, strict TypeScript checks, warning-free linting, production build, and release validation.
- GitHub Actions passes on Ubuntu with Node.js 20, 22, and 24, and on Windows with Node.js 24.
- The three packaged release assets were verified byte-for-byte against the reviewed local build and have GitHub provenance attestations tied to commit
d1bb21a5c668976314a3885c2b6a1c944266ea36.
Manual Obsidian smoke testing on Windows and Linux remains planned after this initial release.
Full changelog: 0.11.0...0.11.1
Slipbox 0.11.0 — initial public beta
Slipbox 0.11.0 — initial public beta
Slipbox is a desktop Obsidian plugin for browsing, arranging, editing, and filing Markdown notes as a tactile card index.
This initial public beta includes the Deck, transient Desk piles, Canvas layout, inline card viewing and editing, configurable filing and display behavior, bookmarks, backlinks, and keyboard navigation.
Installation
Download main.js, manifest.json, and styles.css from this release and place them together in <Vault>/.obsidian/plugins/slipbox/. Reload Obsidian, then enable Slipbox under Settings → Community plugins.
Testing status
The release passed the complete automated suite: 354 tests, strict type checking, warning-free lint, production-build validation, and clean builds on Ubuntu with Node 20, 22, and 24 and Windows with Node 24. Manual Windows and Linux UI smoke testing is still pending.
Full changelog: 0.10.0...0.11.0