---

📚 Documentation

View Full Documentation →

Quick Links:

• Installation • Quickstart • Configuration
• Features Overview • FAQ • Troubleshooting

---

📦 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:

1. Install the BRAT plugin from Obsidian's Community Plugins
2. Open BRAT settings (Settings → BRAT)
3. Click Add Beta Plugin
4. Enter this repository URL: https://github.com/Real1tyy/BasesImprovements
5. Click Add Plugin
6. Enable Bases Improvements in Settings → Community Plugins

Benefits: Automatic updates, smooth experience, one-click installation

📥 Manual Installation from GitHub Releases

1. Go to Releases
2. Download the latest release assets:
   • main.js
   • manifest.json
   • styles.css
3. Create folder: {VaultFolder}/.obsidian/plugins/bases-improvements/
4. Move downloaded files into the folder
5. Reload Obsidian (Ctrl/Cmd + R)
6. 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 .base files
• ⚡ 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

1. Detects Base Blocks - Scans your active note for code blocks with the configured language (default: base)
2. Injects Search Input - Renders a styled search input above each detected block
3. Live Updates - As you type, the filter is automatically added or updated in the base block
4. 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.

• Support My Work

Every contribution, no matter the size, is greatly appreciated!

---

Contributing

MIT-licensed. PRs welcome!