Bug Fix: Home Assistant 2026.6 YAML Domain Validation

Bug fix release for Home Assistant 2026.6 YAML validation compatibility.

Fixed

• Template blueprints with domain: template are no longer incorrectly flagged as invalid.
• Valid infrared.*, radio_frequency.*, and input_button.* entity IDs are no longer reported as unknown domains.
• Added regression coverage for the updated Home Assistant domain handling.

Developer Tools Reliability, Inline Explorer Naming Fix & Documentation Search Improvements

Blueprint Studio 2.5.4

This patch release improves day-to-day reliability in the editor UI and updates the in-app documentation experience.

Fixed

• Inline file explorer naming no longer disappears while idle. New File, New Folder, and Rename now preserve draft text across explorer refreshes, so
  pausing for a few seconds no longer cancels the edit.
• Developer Tools panel reliability improved. Closing and reopening the panel now cleans up keyboard and state observers, the States tab loads
  correctly when opened directly, state row expansion uses the visible entity list, YAML action calls handle simple nested maps/lists, and obsolete
  duplicate CSS was removed.

Improved

• User Guide search now matches section body content, making module names, endpoints, and feature details easier to find.
• README and in-app User Guide documentation now cover newer integration modules including SFTP, embedded terminal/SSH hosts, Gitea, Developer Tools,
  media previews, ZIP transfer progress, frontend/backend module structure, and API/security boundaries.

HA 2026.6 Compatibility, Tab Reordering, Sidebar Startup Option & ZIP Transfer Improvements

Blueprint Studio 2.5.3

This release focuses on Home Assistant 2026.6 compatibility, smoother editor workflows, safer ZIP handling, and much better large-file transfer behavior.

Highlights

• Editor tabs can now be reordered by dragging, with tab order preserved across reloads.
• Home Assistant 2026.6 compatibility updates, including removal of legacy platform: template sensor autocomplete.
• Python script payload validation fixed so entity_id inside data: is no longer incorrectly warned as deprecated for python_script.* services.
• Sidebar startup behavior is configurable with a new Auto-Hide Sidebar on Startup setting.
• Large ZIP downloads now stream in chunks for local and SFTP folders, reducing memory usage and avoiding browser hangs.
• ZIP download progress overlay now shows processed files, transferred bytes, and the current archived file.
• ZIP uploads are safer with traversal, absolute path, Windows drive path, and NUL-name protection.
• Folder ZIP uploads now use multipart transfers, avoiding Home Assistant JSON body limits.
• Upload progress is non-blocking, allowing users to keep working while large uploads continue.
• SFTP media previews now stream directly with HTTP Range support, improving seeking and reducing browser memory usage.
• Error toasts and modal error flows are now dismissible.

Fixes

• Fixed Jinja syntax highlighting inside YAML folded/literal block scalars after whitespace-only lines.
• Fixed ZIP extraction reporting failure after partial success when only some archive members fail.
• Fixed local ZIP folder uploads not refreshing the explorer immediately after extraction.
• Fixed selected-item ZIP downloads by using short-lived authenticated stream URLs instead of buffering full archives in the browser.

Blueprint Studio 2.5.2: Security Hardening and File Explorer Improvements

Security

• Restricted the Blueprint Studio backend, stream, and upload APIs to admin users, matching the admin-only panel.
• Blocked non-admin authenticated users from sensitive operations including file access, Git, SFTP, uploads, Home Assistant service calls, template rendering, and global search/replace.
• Hardened Git credential handling so credentials are no longer embedded directly into generated shell scripts or stored through Git's plaintext credential store.
• Changed terminal SSH key authentication to use in-memory Paramiko sessions instead of writing private keys to disk.
• Bounded legacy terminal command working directories to the Home Assistant config directory.
• API exception responses now return generic errors while detailed traces remain in server logs.
• Security report credited to anonymous.

Improvements

• Added donation support in the toolbar with Ko-fi, PayPal, Alipay, Bitcoin, and Solana options.
• Added inline create and rename controls in the file explorer.
• Added file explorer filter presets for All, YAML, Python, Images, and Modified files.
• Polished file explorer search with compact controls, result counts, highlighted matches, and no-results state.
• Added Git status badges in the file explorer.

v2.5.1 - HACS Transfer Fix

Maintenance release to update repository references after organization transfer.

Blueprint Studio v2.5.0 - HA Agent AI Mode, Diff Viewer Rewrite & File Navigation Overhaul

Blueprint Studio v2.5.0

This release adds a new Home Assistant Agent AI mode, a rewritten Git diff viewer, improved file navigation, broader theme coverage, and better real-time file sync.

Highlights

• New HA Agent AI mode
  Route AI queries through Home Assistant conversation agents, including agents such as Claw Assistant (https://github.com/ha-china/ha_claw). Supports file edits with diff
  review.
• Rewritten Git diff viewer
  New side-by-side and unified diff views with syntax highlighting, context expansion, and inline commenting.
• File navigation overhaul
  Added file-nav-helper.js for path-based reveal-and-open behavior, breadcrumb navigation, and back-button support.
• Theme system expansion
  Major themes.css updates improve dark/light mode consistency across the full UI.
• Blueprint conversion improvements
  Entity extraction in ai_generators.py now uses regex-based parsing instead of deeper YAML traversal for better robustness.
• Frontend cache management
  Added a new Clear Frontend Cache button in settings.
• WebSocket file-change sync
  File create, delete, and rename operations now update tabs and the file tree in real time.

Fixes And Improvements

• Folder ZIP uploads now extract into the correct target-folder/zip-name path and no longer falsely report destination conflicts.
• Terminal-created files now appear in the file tree without requiring a page reload.
• Autocomplete no longer drops the first part of typed words like ac.
• YAML autocomplete has expanded support for modern automation keys, trigger/condition bodies, choose branches, service fields, and value completions.
• Autocomplete filtering is now prefix-first, deduplicated, and less noisy.

Upgrade Notes

After updating, hard refresh Blueprint Studio or use the new frontend cache clearing option so the browser loads the latest JavaScript and CSS assets.

###Special Thank
A special thanks to @knoop7 for his contribution for the New HA Agent AI mode.

Improved Diff Navigation, Stable Settings Sync & UI Fixes

Blueprint Studio 2.4.8 Release Notes

Visual Diff Viewer Navigation

The Visual Diff Viewer now supports seamless navigation between changes within a file. You can move forward and backward through diffs using new navigation controls, and a live counter shows your current position. The active change is clearly highlighted, making it much easier to review large files like automations.yaml and scripts.yaml.

Reliable Cross-Device Settings Sync

Settings syncing across devices has been made more robust. Previously, stale browser cache could overwrite newer server-side settings if its _savedAt timestamp appeared newer.
Now:

• Local recovery is limited to a short same-device window
• A per-browser _clientId ensures isolation between devices
• Resolved settings are written back to local storage after load

This prevents outdated configurations from resurfacing when switching devices.

Cleaner Console (No More .editorconfig 404 Spam)

Opening directories without an .editorconfig file no longer floods the browser console with 404 errors.
The frontend now marks these requests as optional, and the backend returns a normal JSON response when the file is missing, keeping things clean and noise-free.

---

Fixes & Improvements

File Tree Hydration Fix

Collapsible folders in lazy-loaded tree mode no longer appear empty when expanded.
Previously, cached directories could skip reloading but fail to populate their children in the UI.

Now:

• Expanding a cached folder immediately hydrates its contents
• Directory updates correctly replace stale entries instead of only appending new ones

Improved Touch & iPad Navigation

Folder navigation on touch devices is now much more reliable.
The previous detection relied only on matchMedia('(pointer: coarse)'), which missed some devices.

Detection now also includes:

• navigator.maxTouchPoints
• ontouchstart
• any-pointer: coarse

This ensures consistent tap-to-open behavior on iPads and hybrid touch devices.

---

Custom AI & Stability Improvements

Blueprint Studio 2.4.7 Release Notes

This release focuses on a new AI configuration option and several reliability fixes for YAML validation, file browsing, search, and Git exclusions.

Highlights

• Use your own AI endpoint
  Blueprint Studio can now connect to any OpenAI-compatible AI service, including local tools such as Ollama and LM Studio. You can set a custom base URL and model in Settings → AI, then use Fetch Models to load the models available from that endpoint.

• AI requests now fail more cleanly
  AI requests now have a 60-second timeout. If an AI provider is slow or unreachable, Blueprint Studio will stop waiting and report the problem instead of hanging indefinitely.

Fixes

• Valid templated entity_id values are no longer marked as malformed
  The YAML validator no longer reports false errors for valid multi-line Jinja templates such as:

  entity_id: >
    {% if condition %}
      camera.back_garage_camera
    {% else %}
      camera.front_garage_camera
    {% endif %}

  This fixes cases where entity_id: > or entity_id: | was incorrectly treated as a bad entity ID.

• File search no longer blocks Home Assistant
  Large searches now run file scanning work outside the Home Assistant event loop. This prevents warning messages about blocking calls and keeps Home Assistant more responsive during searches.

• Navigation mode now loads folders correctly
  Going back to a previous folder in navigation mode now loads the folder if it is not already cached. This fixes cases where the file tree could get stuck on a loading spinner.

• Saved navigation paths now restore correctly
  If Blueprint Studio opens with a previously saved folder path, it now loads that folder automatically instead of showing an empty or permanently loading file tree.

• Manage Git Exclusions now shows the correct checkbox states
  The Git exclusions dialog now reads your actual .gitignore content correctly. Files ignored by wildcard patterns such as *.db or *.db-shm now show as excluded when the dialog opens.

• Wildcard .gitignore rules are preserved
  Saving Git exclusions no longer removes wildcard rules or adds unnecessary duplicate entries for files already covered by a wildcard pattern.

Credits

• Custom AI gateway support contributed by @xyiqq in PR #61.

2.4.6 - Bug Fix for yaml anchors and UUIDs no longer flagged as invalid entity IDs

Bug Fix for yaml anchors and UUIDs no longer flagged as invalid entity IDs

2.4.5 - Smart Indentation, .editorconfig Support, Modern YAML Syntax & Bug Fixes (Please give a star and follow)

Smart Indentation, .editorconfig Support, Modern YAML Syntax & Bug Fixes

What's New

Professional Indentation Engine

We’ve overhauled how Blueprint Studio handles whitespace to bring it closer to a full IDE experience:

• .editorconfig Support: The editor now automatically detects and applies indent_style and indent_size rules from .editorconfig files. It follows the standard "walk up" logic (stopping at root = true) and caches results for a snappy experience.
• Smart Backspace: Pressing Backspace in leading whitespace now deletes back to the previous indent stop (e.g., removing 2 spaces at once) instead of one character at a time.
• Improved Auto-Detection: The algorithm for detecting a file's indentation is now much smarter, ignoring single-occurrence deltas (like YAML block scalars) to prevent the "Spaces 1" error.
• Per-File Settings: Opening a file with unique indentation no longer overwrites your global preferences. The editor now respects the file's specific needs without changing your default settings.

Enhanced Autocomplete

• Modern Trigger Syntax: Autocomplete now prioritizes the modern trigger: state form (introduced in HA 2024.4), while keeping legacy platform variants as secondary options.
• New Types: Added support for persistent_notification triggers and trigger condition types.
• Smarter Context: The YAML analyzer now scans up to 15 lines (previously 5) to detect blueprints, ensuring it isn't tripped up by long header comments.
• Toggle Control: A new setting in Settings → Editor → Behavior allows you to disable autocomplete suggestions if you prefer a manual workflow.

---

Bug Fixes & Improvements

Editor & UI

• Status Bar Sync: Changing indentation via the status bar picker now correctly updates the Settings panel (and vice versa).
• File Tree Stability: Fixed a critical bug where collapsing a folder in navigation mode would cause the entire file tree to disappear.
• Tab-Indent Logic: Fixed an issue where "Indent with Tabs" was incorrectly calculating units, ensuring that tabbing adds exactly one tab character.
• Visibility Fix: Switching browser tabs or windows no longer "stomps" over a file's detected indentation with global preferences.

Reliability & Performance

• Settings Persistence: Added a timestamp-based syncing system (_savedAt). If you reload the page before a server save completes, the latest local changes will automatically re-sync to the server on reload.
• Autocomplete Precision: Fixed a bug in service completion where leading whitespace after a colon caused fragments of old text to remain.
• Silenced 404s: Optimized the .editorconfig fetcher to stop logging 404 errors to the console when a config file isn't present.
• Code Stability: Fixed a SyntaxError crash caused by a missing async declaration in the tab activation logic.