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 mongodump and mongorestore stderr 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 mongodump required
• Parallel batch writes: Configurable batch size and concurrent write threads (insertMany with ordered: false)
• Pause / Resume / Stop: Full operation control with resumeId checkpointing 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.json failed 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) and Cmd/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.

Leafbase v1.0.11

Release Notes - v1.0.11

🛡️ Major Security Upgrade: Encryption Everywhere

This version introduces Commercial-Grade Security by encrypting all sensitive user data at rest. LeafBase now integrates with system-native secure storage to ensure your credentials and private queries are protected.

🔑 Secure Credentials Storage

• Native Keychain Integration: Database passwords, SSH credentials, and SSL/TLS passphrases are now encrypted using Electron's safeStorage API.
• Platform Support: Uses macOS Keychain, Windows Credential Manager, and Linux Secret Service.
• Auto-Upgrade: Version 1.0.11 automatically detects legacy plain-text passwords and upgrades them to the encrypted format on the first run.

📝 Encrypted Workspace & Tabs

• Query Privacy: The content of your open tabs (queries) is now encrypted before being saved to disk.
• LocalStorage Migration: Moved workspace data from insecure browser localStorage to a managed, encrypted JSON file.
• Zero-Touch Migration: Existing open tabs from v1.0.10 are automatically migrated and secured.

📜 Protected Query History

• Historical Privacy: Your query history is now encrypted. Even if someone gains access to your computer's storage files, your database interaction logs remain unreadable.
• Enhanced Storage: History has been moved to a dedicated secure storage file, reducing memory footprints in the renderer process.

---

LeafBase v1.0.10

Release Notes - Leafbase v1.0.10

🐛 Bug Fixes

🗓️ Fixed ISODate & MongoDB Helpers in Export/Import

Resolved a critical issue where executing raw query strings or ETL transformations during export/import would fail with ISODate is not defined.

• Universal Sandbox Support: Significantly enhanced the VM execution environment for Export, Import, and Data Previews.
• Standard Helpers: Added full support for common MongoDB shell helpers including ISODate(), ObjectId(), NumberInt(), NumberLong(), and the standard Date object across all data pipelines.
• Consistency: All script execution environments (Query Editor, Export Tab, Import Tab) now share a consistent set of helper functions, ensuring your queries work everywhere.

📁 Corrected Export File Extensions

Fixed a UI bug in the Export dialog where selecting the JSON format would still suggest a .jsonl file extension.

• Format-Aware Extensions: The file save dialog now correctly dynamically switches between .json, .jsonl, .csv, and .xlsx based on your selected export format.
• Improved UX: Reduced manual renaming effort and potential file format confusion during data distribution.

---

LeafBase - The open-source Studio 3T alternative.

LeafBase v1.0.9

Release Notes - v1.0.9

🚀 What's New

 macOS Code Signing & Notarization

LeafBase is now officially Digitally Signed and Notarized by Apple. This is a major security milestone that ensures a seamless installation experience for all macOS users.

• Gatekeeper Approved: No more "Developer cannot be verified" warnings. LeafBase now opens instantly with a trusted Apple-verified dialog.
• Hardened Runtime: Enabled macOS Hardened Runtime for all production builds, providing an extra layer of protection against unauthorized code injection and memory tampering.
• Universal Binaries: Full support for both Intel (x64) and Apple Silicon (arm64) with cryptographically verified signatures for both architectures.

🤖 CI/CD Pipeline Enhancements

• Isolated Apple Secrets: Re-engineered the GitHub Actions workflow to securely inject Apple signing secrets only during macOS build cycles.
• Notarytool Integration: Migrated to the modern Apple notarytool for faster and more reliable automated verification during the release process.
• Optimized electron-builder Config: Standardized environment variable mapping (APPLE_ID, APPLE_PASSWORD, APPLE_TEAM_ID) to align with the latest @electron/notarize standards.

🐛 Bug Fixes

• Fixed Windows Build Failure: Resolved a critical issue where the Windows build runner attempted to use macOS certificates for signing, causing a publisher name extraction error (ERR_ELECTRON_BUILDER_CANNOT_EXECUTE).
• Fixed Notarization 500 Error: Patched the notarization configuration to avoid tool warnings and transient HTTP 500 errors from Apple's Notary Service by using recommended environment variable overrides.
• Gatekeeper Assessment: Fixed a local verification issue by explicitly setting gatekeeperAssess: false in the build configuration, ensuring smoother post-signing checks.

---

LeafBase - The open-source Studio 3T alternative.

Leafbase v1.0.8

Release Notes - v1.0.8

🚀 What's New

🗂️ Workspace Sessions

• Auto-Save Sessions: LeafBase now silently saves your open tabs on every change. If you have 10 tabs open and close the app, your full working state is preserved automatically.
• Resume Last Session: A new Workspaces button in the Sidebar Footer lets you instantly restore all your tabs from your last working session, including query text, pagination, and target database.
• Export / Import Workspaces: Save your current tab setup as a portable .json file and share it with teammates, or re-import it on another machine. Native OS file dialogs are used for seamless Save/Open experience.
• Lazy Reconnection: Restored tabs start in an Offline (Gray ⚪) state and only connect when you click Run, avoiding unnecessary SSH tunnel startup overhead on launch.
• Sidebar Sync on LazyConnect: When a dormant tab reconnects implicitly via Run, the Connection Tree on the left sidebar automatically updates — green dot, expanded DB, and visible collections in one shot.

🖱️ Tab Context Menu (Right-Click)

• Duplicate Tab: Clone the current tab with its full query into a new tab instantly.
• Close Other Tabs: Shut every tab except the active one.
• Close Tabs to the Right: Progressively close all tabs positioned after the current one.
• Close All Tabs: Clear the workspace completely.

🕒 Global Query History

• Auto-Capture: Every time you run a query, it is automatically recorded to a persistent History Store (max 500 entries) with connection name, database, and full query text.
• Search & Filter: The History Modal (click 🕒 History above the Editor) provides real-time text search and context-aware filtering by Current DB or Starred queries.
• Rich Code Preview: History entries are displayed with full syntax highlighting using the VS Code Dark+ theme.
• Star / Bookmark: Pin important queries with the ⭐ Star button. Starred queries bypass the 500-limit cleanup and survive Clear History.
• Smart Restore:
  • Restore to current tab if the history entry targets the same DB and server.
  • Automatically opens a new tab targeting the correct DB if the restore context differs, with skipAutoRun to avoid unintended query execution.
• Privacy Toggle: A new "Auto-Save Query History" toggle in Global Settings lets you opt out of history recording for sensitive environments.

🐛 Bug Fixes

• Fixed blank screen when opening the Workspaces Modal (missing component import).
• Fixed Not connected error when running a query on a Workspace-restored tab (implemented LazyConnect in the Electron backend).
• Fixed sidebar green dot and DB tree not updating after implicit LazyConnect.
• Fixed Restore button in History Modal doing nothing (setTabs → updateTabContent correction).
• Fixed Restore always replacing instead of opening new tab — caused by connId type mismatch (number vs string from JSON deserialization).
• Added missing react-syntax-highlighter dependency to package.json.

---

LeafBase - The open-source Studio 3T alternative.

1.0.7

Release Notes - v1.0.7

🚀 What's New

🛡️ Network & SSH Resilience

• Crash Prevention: Complete suppression of ECONNRESET and Not connected OS-level exceptions that previously caused Electron to crash abruptly when networks dropped.
• Smart Auto-Reconnect: The background reconnection loop is now fully network-aware. It pauses gracefully via DNS checks when your wifi drops, preventing resource-draining infinite retries.
• Real-Time UI Status Dots (Traffic Light): Added Mac-style visual indicators to every open Query Tab:
  • 🟢 Green: Active connection.
  • 🟡 Yellow (Pulsing): Network disrupted, seamlessly reconnecting in the background.
  • ⚪ Gray: Network offline.

⚙️ Global Settings & Memory Protection

• Default Page Size Setup: Introduced a new Global Settings Modal (Zustand Persist). You can now permanently configure your preferred Default Page Size (e.g. 100 or 500 records) instead of constantly adjusting the hardcoded 50 default when opening new collection tabs.
• V8 Out-Of-Memory Defense: Hardened the Node.js backend against memory exhaustion when fetching millions of documents across IPC boundaries.
• Smart .toArray() Execution: Calling .toArray() natively will now bypass default UI pagination safely, extracting up to 1,000 documents securely without freezing the Electron frontend.

🔄 UX Enhancements

• Dynamic Connection Binding: Tab connections automatically resume context when background recovery succeeds, allowing you to click "Run" and continue operations without refreshing the application.
• Hover Tooltips: Clarified connection status with full-English descriptions upon hovering native status dots.

---

LeafBase - The open-source Studio 3T alternative.

Leafbase v1.0.6

Release Notes - v1.0.6

🚀 What's New

🛑 Hardened Abort (Emergency Stop)

• Instant Termination: Long-running Export and Import operations now stop immediately when you click the Stop button. No more waiting for buffers to flush.
• Improved UI Reliability: Fixed progress jitter and status race conditions. The UI strictly ignores progress updates from aborted tasks, ensuring a clean transition when starting new operations.
• Backend Safety: Forcibly destroys stream pipelines and MongoDB cursors on abort to free up resources instantly.

📊 Native Excel (.xlsx) Support

• Streaming Export: Directly export collections to .xlsx format with minimum memory overhead.
• Streaming Import: Import documents from .xlsx files with full support for field mapping.
• Complete Integration: Excel support is fully compatible with our Abort functionality and ETL transformation engine.

🔄 UI & Bug Fixes

• Blank Screen Fix: Resolved a ReferenceError that could cause the collection menu to go blank in certain scenarios.
• Refined Progress Tracking: Implemented strict operation-ID isolation across the IPC bridge to prevent percentage "jumping" between old and new tasks.
• BSON & ETL Stability: Improved error handling for BSON serialization during stream transforms.

---

LeafBase - The open-source Studio 3T alternative.

Leafbase v1.0.5

Release Notes v1.0.5 - Leafbase 🚀

✨ New Features

• Full BSON Support: Added ability to Backup and Restore individual collections using mongodump and mongorestore.
• Dynamic Binary Downloader: Automatically detects and downloads the correct MongoDB Database Tools for your platform (macOS Intel/Silicon).

🔧 Improvements & Fixes

• Critical Atlas Connectivity:
  • Resolved SSL alert 80 (Handshake failure) specifically for Atlas clusters.
  • Implemented logic to strip database names from URIs when using BSON tools, preventing conflicts with the --db flag.
  • Fixed "Deadline Exceeded" errors on Atlas Shared Tiers by limiting insertion workers (--numInsertionWorkersPerCollection=1).
  • Added support for both mongodb+srv:// and multi-host (seed-list) connection strings.
• SSH Tunnel Stability: Fixed a TypeError when accessing SSH local ports and ensured BSON operations route correctly through tunnels.
• URI Self-Healing: Implemented automatic sanitization for corrupted connection strings (duplicated ports or illegal ports in SRV).

🖥️ UI/UX

• Real-time Progress: Added IPC listeners to show download progress and operation logs directly in the BSON tab.
• Backup Options: Support for Gzip compression and "Drop collection before restore".

---

Date: 2026-03-18
Version: 1.0.5

LeafBase v1.0.4

[1.0.4] - 2026-03-18

🆕 New Features

🔌 MongoDB Connection URI Support

• Full URI string support including mongodb+srv:// (SRV), MongoDB Atlas, and multi-host replica set formats
• Paste-and-connect workflow for instant URI-based connections

🔒 MongoDB Stable API (v1)

• Added Stable API enforcement with apiVersion: "1" support
• Optional strict mode and deprecation error flags for future-proof queries

📤 Export Engine — Stream-Based

• Stream exports for large datasets without memory bottlenecks
• Supported formats: JSON, JSONL, CSV
• Live sample preview before confirming export

📥 Import Engine — Live Import

• Import data directly from local files or clipboard
• Interactive field mapping UI to align source fields with target collection schema
• Real-time validation feedback during mapping

🔍 Direct Query Export

• Export filtered results directly from the Query Tab
• Honors active filters, projections, and sort order at time of export
• No need to navigate away from your query context

---

🐛 Bug Fixes & Improvements

• Minor UI polish and stability improvements

---