🐞 Bug Fixes

• Previewing another page: With pageId set to a page other than the one you edit, the preview no longer fills that page with your unsaved content. It shows the page as saved.
• Jump links: Links like #team now scroll to their section inside the preview instead of loading the home page.

🔒 Security

• Messages from the preview: The Panel now saves or follows a link only when the preview itself asks, and never opens a script link like javascript:. Prevents an embed on the previewed page, such as a third-party widget, from saving your changes.

🐞 Bug Fixes

• Leaving a page while the preview loads: Title changes and file sorting no longer refresh a preview that is no longer on screen.
• Recovering from a failed preview: A preview that failed to start now recovers on the next page you open, instead of staying blank until you reload the Panel.
• License status in the system view: On some installs, the system view failed with an error. It opens again, and the license status shows its label.

🚀 Features

• License key activation: The activation dialog now uses your license key instead of the order number for a smoother setup. Find your license key at hub.kirby.tools or in your order confirmation email.

🚀 Features

• Paddle support: Kirby Tools has moved from Lemon Squeezy to Paddle, and license activation now accepts Paddle order numbers, such as 81357-10001.

🚀 Features

• Page render hooks: The page.render:before and page.render:after hooks are now triggered during live preview rendering. If your project relies on render hooks – for example, to load classes or modify template data – they now work as expected.

🚀 Features

• System view license management: View your license key, activation status, and version compatibility directly in the Kirby Panel system view, and activate new licenses from there.

🚀 Features

• Kirby 5 license status integration: The plugin now displays its license status on the Panel's system page, following Kirby 5's plugin license management conventions.

🐞 Bug Fixes

• Device preview scaling: A device preview narrower than the section, such as Mobile at 390px, was scaled up to fill it. It now keeps its device width.

🚀 Features

• New tab button: New button to open previews in a new tab.
• Device dimension buttons: Device dimensions buttons to simulate different screen widths. The height is fixed at 100% of the preview section. The available devices are:
  • Mobile: 390px
  • Tablet: 768px
  • Desktop: 1440px

🐞 Bug Fixes

• Site-level field preview: Changes to site fields (in site.yml) appeared in the preview only after saving. They now appear right away, like changes to page fields.

🚀 Features

• Preview alternate pages: The new pageId section property lets you preview a different page than the one being edited. This is useful for previewing how site-level changes affect a specific page, or for previewing template pages from a settings panel.
• Improved sticky scroll behavior: Once the Panel's top bar scrolls out of view, a sticky preview grows into the space it leaves.

Kirby Live Preview v2 is a major release with full support for Kirby 5. This major release requires a new license key. If you already have a license, you receive either a free upgrade to v2 or a 50% discount on your new license. Head over to the Kirby Tools Hub to get your discount or read more in the license compatibility guide.

🚀 Features

• Update strategy option: The new updateStrategy property controls when the preview updates. Set it to blur instead of the default interval to update the preview when a text-like, number-like, or blocks field loses focus:

type: preview
updateStrategy: blur

🚀 Features

• Panel license activation: Activate your license directly in the Kirby Panel without manual file editing. Click Activate in the Live Preview section to enter your license details.
• Packagist distribution: The plugin is now available via Packagist, simplifying Composer-based installations. The private Composer repository has been deprecated.

🚀 Features

• Update interval option: Change rendering frequency with the updateInterval option or disable it completely.

🐞 Bug Fixes

• Keyboard save shortcut: Saving with Cmd + S now works correctly when the focus is on the preview frame.

🚀 Features

• Permalink resolution: Resolve permalinks in writer fields to redirect links to the corresponding Panel page.
• Frontend preview mode: Support detecting the preview mode in the frontend with the data-preview-mode attribute in CSS and JavaScript:
  assets/css/main.css

  [data-preview-mode] .cookie-banner {
    display: none;
  }
  

  assets/js/main.js

  const isPreviewMode = document.documentElement.dataset.previewMode === "true";
  

• Backend preview mode detection: Support preview mode detection in the backend with the previewMode content key:
  site/snippets/footer.php

  $isPreviewMode = $page->previewMode()->isTrue();
  

Initial Release

Kirby Live Preview v1.0 brings real-time content preview directly into the Kirby Panel. See your changes rendered instantly as you edit, without switching between the Panel and your website.

🚀 Features

• Real-time preview: Content updates are rendered in the preview iframe as you type, providing instant visual feedback.
• Panel section: Add the preview section to any blueprint with type: preview. Works with pages and site blueprints.
• Sticky layout support: Make the preview sticky in your blueprint layout for side-by-side editing alongside blocks and other fields.
• Panel link navigation: Click links in the preview to navigate to the corresponding Panel page instead of the frontend URL.

For setup instructions, see the Getting Started guide.