Releases: vutranHS/byson
Release list
BysonDB v1.1.9
BysonDB v1.1.9 - Aggregation Pipeline Builder π§±
A new visual way to build, preview, and tune MongoDB aggregation pipelines, right inside BysonDB.
β¨ New: Aggregation Pipeline Builder
Open it from the collection menu in the sidebar (Aggregate...).
- Build visually. Drag stages from a searchable palette (or click to add), reorder by the drag handle, enable/disable, and duplicate stages. Every stage gets its own editor.
- Form or Code per stage. Simple stages ($match, $project, $sort, $limit, $skip, $sample, $unwind) offer a structured form; anything more advanced falls back to a code editor.
- Live preview. See results up to any stage as you build, in Tree / Table / JSON views. Write stages ($out / $merge) are skipped in preview.
- Explain plan. One click shows the execution plan (index usage, COLLSCAN warnings, docs examined vs returned) plus static hints (move $match earlier, suggest indexes for $match / $sort).
- Collection autocomplete for $lookup, $graphLookup, $unionWith, $out, and $merge.
- Save and reuse pipelines, export results to JSON, copy the generated code, or open it in a Query tab.
- Pipelines and view preferences are remembered across tab switches and restarts.
π Safe by design
Aggregation results are read-only, so you cannot accidentally edit or delete documents from the results view, and the source collection is never modified.
BysonDB v1.1.8
BysonDB v1.1.8 - Keep clone progress when switching tabs π
A small fix for anyone running Collection / Database Clone jobs.
π Fixes
- Fixed the Clone tab going blank when you switch away and back during a clone. While a collection or database clone was running, switching to
another tab and returning showed an empty Execution Status with no progress bar or logs. The running job looked lost, and a paused job could
even resume against the wrong target. - Clone state now lives outside the tab view and keeps updating in the background, so progress, logs, and pause/resume all survive tab switches.
The clone keeps running even while you are on another tab.
β No data or settings changes. Just update and carry on. πΏ
macOS 26 (Tahoe) users: auto-update works normally from v1.1.7 onward, so this should arrive on its own. If you are still on a build older than
v1.1.7, download once manually from this Releases page.
BysonDB v1.1.7
On macOS 26 (Tahoe) and newer, BysonDB could download an update and quit after Restart Now, but reopen on the old version. This release fixes that.
π§ What was wrong
macOS 26 changed how launchd handles the updater helper (ShipIt). After the app asked to install the update, the helper was registered but never actually started, so the downloaded update sat staged on disk and was never applied. This is a known Electron/Squirrel.Mac regression on macOS 26 (electron/electron#50866).
β
The fix
When running on macOS 26+, BysonDB now starts the updater helper itself right after you click Restart Now β waiting for the app to fully quit, then launching ShipIt so the update is applied and the app relaunches on the new version.
Older macOS versions are unaffected and keep the normal update flow.
Added persistent updater logs under ~/Library/Logs/byson/BysonDB/ to make any future update issues easy to diagnose.
Already on an older BysonDB and stuck on macOS 26? If auto-update closes the app but doesn't upgrade it, download v1.1.7 once from the Releases page and replace the app in your Applications folder. From v1.1.7 onward, auto-update works on macOS 26.
BysonDB v1.1.6
v1.1.6 β Light mode polish & a white-screen crash fix π
A small but important maintenance release: the last few dark-only corners now follow
your theme, and a crash that could blank the whole window is fixed.
π Fixes
- Fixed a white-screen crash in the result views. Documents containing a date
outside the years 1970β9999 (e.g. old birthdates or far-future timestamps) caused
RangeError: Invalid time valuewhile rendering, which blanked the entire app β most
often when switching to Table view. Dates are now formatted safely and never
crash, in both Table and Tree views. - Added an error boundary around the results panel, so any unexpected render error
now shows an inline message with a Try again button instead of a blank screen.
π¨ Light mode improvements
- Document editor (View / Edit / Insert) now switches to a light Monaco theme in
Light Mode instead of staying dark. - Query history snippets use a light syntax theme when Light Mode is active.
- Clone operation logs follow the theme for both background and text colors.
No data or configuration changes β just update and carry on. πΏ
Full Changelog: v1.1.5...v1.1.6
BysonDB v1.1.5
π LeafBase is now BysonDB
This release is a full rebrand β LeafBase has been renamed to BysonDB. Same free, open-source MongoDB GUI, same features, same data format. Only the name changed.
π The project now lives at https://github.com/vutranHS/byson. The old
leafbaserepository has been archived.
β οΈ Existing LeafBase users β please read
Because the app's identity changed, BysonDB is treated as a brand-new application:
- No auto-update from LeafBase. Your old LeafBase install will not update to BysonDB automatically β download BysonDB manually once from the assets below. From v1.1.5
onward, BysonDB auto-updates normally. - Your old data stays with the old app (saved connections, query history, and settings are not carried over automatically).
π§³ Migrating your data
Simplest path: just re-add your connections in BysonDB. To keep your saved query tabs:
- Open old LeafBase β Workspaces β Export (saves a
*_workspace_*.jsonfile). - Open BysonDB β Workspaces β Import that file.
Old data folder (safe to delete after you've moved over):
- macOS:
~/Library/Application Support/leafbase - Windows:
%APPDATA%\leafbase - Linux:
~/.config/leafbase
π₯ Downloads
| OS | File |
|---|---|
| macOS (Apple Silicon) | BysonDB-1.1.5-arm64.dmg |
| macOS (Intel) | BysonDB-1.1.5-x64.dmg |
| Windows | BysonDB-1.1.5-x64-setup.exe |
| Linux | BysonDB-1.1.5-x86_64.AppImage |
macOS builds are signed & notarized by Apple β open directly after dragging to Applications.
Thanks for using BysonDB! πΏ
LeafBase v1.1.4
LeafBase v1.1.4
This release focuses on query result usability and query editor layout polish.
What's Changed
Query Result Copy Improvements
- Added click-to-select support for individual field/cell values in query results.
- Press
Cmd+Con macOS orCtrl+Con Windows/Linux to copy the selected value. - Supported in both Table View and Tree View.
- Copy behavior now preserves useful raw values:
- Strings copy without extra quotes.
- Numbers and booleans copy as plain text.
- Objects and arrays copy as formatted JSON.
- Tree View's existing "Copy Value" action now copies structured values as JSON instead of
[object Object].
Resizable Table Columns
- Table result columns now support manual resizing by dragging the right edge of the column header.
- Columns keep a compact default width to avoid long fields taking over the table.
- Long values are truncated by default and can be revealed by resizing the column.
- Added a minimum column width to keep the table usable.
Query Editor Toolbar Layout Fix
- Fixed an issue where query action buttons could overlap or cover long query text.
- The query toolbar now lives in the normal editor layout instead of floating over the Monaco editor.
- Export Query, History, and Run buttons remain accessible without obscuring query content.
Version
- Bumped app version to
1.1.4.
LeafBase v1.1.3
fix(security): patch command injection, open-handler, and auto-update risks
- bsonTools: replace exec() with execFile() when extracting tar archives so
userData paths containing spaces or shell metacharacters can't be
interpreted as commands. - main window: allowlist http(s)/mailto in setWindowOpenHandler to prevent
file:// or custom-scheme URLs from triggering arbitrary handlers via
shell.openExternal. - autoUpdater: only enable on macOS, where builds are signed/notarized.
Windows/Linux builds are unsigned, so auto-downloading installers would
be a supply-chain RCE vector until code-signing is in place.
LeafBase v1.1.2
LeafBase v1.1.2 Release Notes
π Features & Enhancements
- Forced Auto-Update System: Integrated
electron-updaterto automatically notify and enforce updates. When a new version is downloaded in the background, the application will prompt a mandatory "Restart Now" dialog to ensure users are always on the latest version. - macOS Auto-Update Support: Added the
.ziptarget in the build process to natively support macOS background updates via Squirrel.Mac.
π Bug Fixes
- File Selection Bug Fixed: Resolved an issue in the Connection Settings dialog where the browse (
...) buttons for selecting Private Keys (.pem) in the SSH tab, and Certificates (.crt/.pem) in the TLS tab were unresponsive due to an IPC channel mismatch.
π¦ Under the Hood
- Synchronized frontend
ipcRendererand backendipcMainchannels to properly route theshell:openFileevents. - Updated
electron-builder.ymlto package both.dmgand.zipfor macOS Apple Silicon (arm64) and Intel (x64).
LeafBase v1.1.1
Release Notes - v1.1.x
v1.1.1 β Smart Context Menu (Patch)
π Bug Fix: Context Menus Clipped by Screen Edge
Previously, right-clicking on items near the bottom or right edge of the window could cause the context menu to be partially hidden off-screen. This is now fully resolved.
- Viewport-aware positioning: Context menus automatically detect when they would be clipped and flip upward or shift inward to stay within the visible area.
- Zero flicker: Uses
useLayoutEffect+getBoundingClientRect()to measure and reposition menus before the browser paints, ensuring no visual jump. - Applied across all 3 context menu locations:
- Sidebar tree (Connection / Database / Collection)
- Document Tree View
- Document Table View
v1.1.0 β Dual-Engine Database Clone System
A major productivity release introducing a high-performance, one-way database cloning engine supporting both individual collections and entire databases.
β¨ New Feature: Clone Collection & Clone Database
Right-click any Collection or Database in the sidebar to clone it to any other server or database β with full SSH tunnel support.
β‘ Engine 1: Native BSON Pipes (Fastest)
Uses mongodump | mongorestore piped directly in memory β no intermediate files written to disk.
- Maximum throughput: Raw BSON wire transfer bypasses all JSON/EJSON serialization overhead
- Auto-install: Automatically downloads MongoDB Database Tools if not present on the machine
- SSH-aware: Reuses the existing SSH tunnel session so transfers stay encrypted end-to-end
- Live log streaming: Every line from
mongodumpandmongorestorestderr is forwarded to the Execution Status panel in real time - Namespace remapping: Automatically handles database/collection renames during transfer via
--nsFrom/--nsTo - Stop support: Kills both processes cleanly when the user clicks Stop
π§ Engine 2: Parallel Driver Clone (Universal)
Uses the Node.js MongoDB driver β works everywhere including MongoDB Atlas and restricted cloud environments where native tools are blocked.
- Works without external tools: No
mongodumprequired - Parallel batch writes: Configurable batch size and concurrent write threads (
insertManywithordered: false) - Pause / Resume / Stop: Full operation control with
resumeIdcheckpointing so interrupted clones can continue where they left off - Database-level iteration: Sequentially clones all collections in a database with a unified global progress bar
- Index & metadata sync: Recreates collection options and indexes on the target before transferring data
π οΈ Improvements & Fixes
- Terminology: Renamed "Sync" β "Clone" throughout the UI to accurately reflect the one-way operation
- Adaptive CloneTab UI: Collection input fields are automatically hidden when cloning an entire database
- Lazy connection loading: Clone operations now work even if the target connection was not yet opened in the sidebar
- ID type mismatch fix: Resolved a bug where numeric connection IDs from
connections.jsonfailed to match string IDs in dropdowns - URI sanitization: Strips default database path (e.g.,
/admin) from connection URIs before passing to native CLI tools to prevent argument conflicts - URI caching: Active connection URI is now persisted in the session store so Engine 1 can access it without spawning duplicate SSH tunnels
LeafBase - A modern, cross-platform MongoDB GUI.
LeafBase v1.0.12
Release Notes - v1.0.12
A major update enhancing both aesthetics and productivity in LeafBase.
π¨ Multi-Theme Support
We've introduced a comprehensive theme system that adapts to your environment.
- Light Mode: A crisp, high-contrast theme for bright environments.
- Dark Mode: Refined charcoal palette optimized for late-night coding.
- Dynamic Sync: The Monaco Editor now automatically switches themes (
vs/vs-dark) to match your settings.
β‘ Bulk Selection & Deletion
Managing large collections is now much faster.
- Drag-to-Select: Click and drag your mouse to select multiple rows instantly (Table & Tree view).
- Batch Deletion: Right-click to delete multiple documents in a single, efficient database operation.
- Standard Controls: Full support for
Shift + Click(range) andCmd/Ctrl + Click(toggle).
π οΈ Improvements & Fixes
- Replaced hardcoded UI colors with semantic theme variables.
- Improved BSON badge visibility across both light and dark backgrounds.
- Optimized Tree Mode for handling rapid expansion and selection.
- Added visual indicators (checkboxes) for selected rows.
LeafBase - A modern, cross-platform MongoDB GUI.