README file from
GithubBases Improvements
Supercharge your Obsidian Bases workflow with dynamic search filtering — filter any base query instantly
🎥 Quick Tutorial
Watch this quick video tutorial to see Bases Improvements in action:
📚 Documentation
Quick Links:
📦 Installation
Bases Improvements is currently awaiting approval for the Obsidian Community Plugin store. In the meantime, you can install it using one of these methods:
🎯 Recommended: BRAT (Beta Reviewers Auto-update Tool)
The easiest way to install and keep Bases Improvements up to date:
- Install the BRAT plugin from Obsidian's Community Plugins
- Open BRAT settings (Settings → BRAT)
- Click Add Beta Plugin
- Enter this repository URL:
https://github.com/Real1tyy/BasesImprovements - Click Add Plugin
- Enable Bases Improvements in Settings → Community Plugins
Benefits: Automatic updates, smooth experience, one-click installation
📥 Manual Installation from GitHub Releases
- Go to Releases
- Download the latest release assets:
main.jsmanifest.jsonstyles.css
- Create folder:
{VaultFolder}/.obsidian/plugins/bases-improvements/ - Move downloaded files into the folder
- Reload Obsidian (Ctrl/Cmd + R)
- Enable Bases Improvements in Settings → Community Plugins
Note: All releases are versioned and tagged for easy reference.
✨ Coming Soon
Once approved for the Community Plugin store, you'll be able to install Bases Improvements directly from Settings → Community Plugins → Browse.
🎯 What Does It Do?
Bases Improvements automatically injects a search input field above every base code block in your notes. As you type, the plugin dynamically updates the base block content to include a file.name.contains("value") filter, making it easy to search and filter your query results on the fly.
✨ Key Features
- 🔍 Dynamic Search Filtering - Live search input injected above base blocks
- 📝 Smart Filter Injection - Intelligently adds filters to existing WHERE clauses
- 🔗 Embed Support - Works with both inline blocks and embedded
.basefiles - ⚡ Debounced Input - Configurable debouncing prevents excessive updates
🚀 Quick Example
Before Typing
```base
FROM notes
SELECT title, date
```
After Typing "meeting"
```base
FROM notes
WHERE file.name.contains("meeting")
SELECT title, date
```
The filter is automatically injected and your base query updates in real-time!
🎬 How It Works
- Detects Base Blocks - Scans your active note for code blocks with the configured language (default:
base) - Injects Search Input - Renders a styled search input above each detected block
- Live Updates - As you type, the filter is automatically added or updated in the base block
- Smart Filtering - Handles existing WHERE clauses by appending with AND logic
Support & Sponsorship
If you find Bases Improvements useful and want to support its ongoing development, please consider becoming a sponsor. Your contribution helps ensure continuous maintenance, bug fixes, and the introduction of new features.
Every contribution, no matter the size, is greatly appreciated!
Contributing
MIT-licensed. PRs welcome!