Soliloquy Dynamic - WordPress Plugin

Guide to Using and Configuring Soliloquy Dynamic

Soliloquy Dynamic is not for building yet another manual slider. It is for situations where the images already exist in WordPress or in an external source, and the site admin wants to display them as a clean slider without constantly rebuilding the slide set. In this guide, we will look at how to approach installation, how to configure a basic Dynamic Settings slider, which image sources to choose, how a shortcode differs from a template tag, how to verify the result, and where problems tend to show up most often.

This material is intended for a site owner, editor, theme developer, or support specialist who already understands the basic idea behind sliders but wants to use dynamic output without accidental conflicts involving media files, the theme, caching, or shortcodes. It does not cover buying a license, and it does not include activation workarounds. The focus here is strictly on setting up a product you already have access to.

The main idea is simple: the Dynamic Addon is convenient when slides can be pulled from a specific source such as post attachments, image IDs, URLs, a folder inside wp-content, a WordPress gallery, NextGEN Gallery, or Envira Gallery. But each source behaves differently. If you do not understand where the plugin is getting its images from, it is easy to end up with an empty slider, duplicate IDs, slow loading, or incorrect captions.

From here, the guide moves from decision-making into implementation: first choose the right scenario, then check the environment, create the base configuration, output the dynamic slider, test the front end, and work through diagnostics. That order helps you do more than just "paste code" - it gives you a repeatable process you can use on pages, posts, custom post types, and theme templates.

Where the Dynamic Addon Is Actually Useful

A regular slider works well when the image set is fixed: a homepage banner, a promo block, a project showcase, a few product photos, or a static event gallery. The Dynamic Addon solves a different problem. It lets you build a slider on the fly from data that already exists in WordPress or in a connected gallery. The real value appears when manually adding slides becomes an unnecessary extra step.

The clearest example is a post or page with images that were uploaded directly from that post's editor. In that case, a dynamic slider can output the attached images by post ID. The editor does not need to create a separate slider, duplicate the photos, and maintain two separate sets of content. They work with the content itself, and the slider pulls the attachments from that content.

A second scenario is a site with many recurring page types. For example, a project catalog, customer testimonials, real estate listings, event pages, an internal training portal, or a service portfolio. If each post has its own images, dynamic output lets you use one consistent display method without manually creating a separate Soliloquy slider for every post. This is especially useful when the site has many pages and multiple editors updating content.

A third scenario is working with an existing media library. The Soliloquy documentation describes a mode where images are selected by ID from the Media Library. This works well when you need to quickly assemble a dynamic set from files that have already been uploaded, without tying that set to a single post. This approach requires discipline: the IDs must be correct, the image order should be verified, and captions and alt text are best prepared in advance in the media library itself.

A fourth, more technical scenario is outputting images from direct URLs or from a folder inside wp-content. These modes can be useful for external storage, internal exports, temporary image sets, or automated publishing of small photo collections. But they require care: the URLs must be accessible, the files in the folder should have clean names without spaces, and the folder itself must sit directly inside wp-content, with no nested levels.

A practical rule for choosing: if it is easier for the editor to manage images in a post, in the media library, or in a gallery, the Dynamic Addon saves time. If the slide set changes rarely and each slide needs a more elaborate design, a regular Soliloquy slider may be clearer and safer.

Who the Plugin Is a Good Fit For

Soliloquy Dynamic is a strong fit for sites where content changes frequently but the visual presentation stays consistent. That could be a blog with photo reports, an educational site with lesson materials, an agency portfolio, a corporate site with case studies, a property catalog, an event site, or an editorial team migrating older WordPress galleries into a cleaner slider format.

For developers and technical site admins, the plugin becomes especially interesting because of the template tag. It lets you output a dynamic slider in a theme template when you need it in a predefined layout position rather than inside post content. But this is already a more technical zone, where you need to check whether the function exists, avoid editing parent theme files directly, and keep a rollback path through a child theme or another safe code-insertion method.

Who It May Not Be Right For

The Dynamic Addon does not replace a full design system for complex hero sections, it does not create arbitrary animated scenes, and it does not solve the problem of a visual layer-based builder. If every slide needs its own text, complex composition, animation, buttons, and breakpoint-specific responsive controls, it makes sense to compare Soliloquy with heavier visual slider builders.

The plugin is also not ideal in environments where editors do not understand the difference between an attached image, a media library image, an external URL, and a file in a folder. In that case, it is better to document the internal content workflow first: who uploads images, where they upload them, how files are named, where captions are checked, and who is responsible for the public-facing result.

How the Dynamic Slider Works Inside WordPress

In a regular Soliloquy slider, the admin creates a slider, uploads or selects images, configures the settings, and inserts the finished shortcode. In dynamic mode, there is an added layer: a separate set of base settings acts as a behavior template, while the actual images come from the selected source. That means configuration is split into two parts: how the slider should behave and where the slides come from.

The base settings are defined in a special Soliloquy Dynamic Settings slider. The documentation describes it as the foundation for all dynamic sliders on the site. This is where you configure the settings that will be applied to dynamic output: size, positioning, transitions, navigation behavior, extra tabs from enabled add-ons, and any other options available in the specific Soliloquy setup.

The image source is defined through a shortcode or a template tag. The basic idea looks like this: you pass a Dynamic Addon ID or a special source identifier, and on the front end the plugin collects the required images and outputs them through Soliloquy. In some modes, the ID represents a post; in others, it is a custom unique identifier; in others, it is a service prefix such as folder-, nextgen-, or envira-.

Why a Unique ID Matters

The official documentation makes a separate point of this: if an example uses id="custom-XXX", you need to replace it with a unique value, and dynamic sliders should not share the same ID on a single page or post. This is not just a formality. The ID is tied to the container, scripts, navigation, and CSS. If two dynamic blocks receive the same identifier, the browser and JavaScript may not know which container should be initialized.

In practice, it helps to follow a simple rule: for a slider tied to a post ID, use the post ID; for a manual image set built from media library IDs, use a descriptive prefix plus a number such as custom-project-42; for a folder, use exactly the format required by the documentation, such as folder-slider, where everything after folder- is the folder name.

Where the Dynamic Addon Intersects with Standard Soliloquy

The Dynamic Addon does not live separately from the main plugin. It uses the Soliloquy interface, slider settings, and general output rules. That means many checks from regular Soliloquy still apply: the slider must be published, the shortcode must be inserted in a place where WordPress processes shortcodes, the theme must correctly output footer scripts, and conflicting optimization tools must not break the slider's JavaScript.

This overlap matters for troubleshooting. If a dynamic slider does not appear, do not assume right away that the problem is in the Dynamic Addon. First determine whether a regular Soliloquy slider works on the same page, whether the shortcode is being processed, whether the source contains images, whether there are JavaScript errors, and whether cached output is serving an older version of the page.

What to Check Before Installation and Activation

Before installation, it is better not to begin with the Activate button. For the Dynamic Addon, the starting conditions matter: access to the required Soliloquy tier, an active core plugin, a clearly defined image source, media library permissions, and a predictable theme. If you do not verify those things up front, the error will show up on the live page, where the cause is harder to identify.

The Core Plugin and Addon Availability

The Dynamic Addon is an add-on for Soliloquy, not a standalone replacement for the core slider. According to the official documentation, it is available on higher Soliloquy tiers and requires WordPress to be installed. This guide will not treat pricing details as permanent facts, because they can change. The reliable check is to open your Soliloquy account and the Soliloquy - Addons page in the admin panel, where the add-ons available for your installation are listed.

If the Dynamic Addon does not appear in the add-ons list, that does not automatically mean something is technically broken. Possible reasons include lack of access to advanced add-ons, the main plugin not being installed, the add-on already being installed but not activated, or the site not receiving updates. In that case, do not download suspicious ZIP files from mirrors. It is better to check the official account, documentation, and the WordPress updates screen.

Image Source and Editor Permissions

The most common logic mistake is assuming that any image visible in a post will automatically work with any dynamic mode. To output attached images, the file must have been uploaded through the specific post or linked as an attachment. For ID-based output, you need the correct IDs from the media library. For URLs, you need accessible direct addresses. For folder mode, the files must be in the correct directory and have names without spaces.

Check in advance who will manage the images. If it is an editor without server access, folder mode inside wp-content is not a good fit. If the images come from external storage, make sure the URLs are not temporary, do not require authentication, and open for site visitors. If you are using NextGEN or Envira, verify that the corresponding gallery exists and that its ID is easy to find.

Theme, Cache, and Optimization

Soliloquy outputs an interactive block, so the front-end result depends on JavaScript, CSS, and proper loading of theme scripts. The Soliloquy troubleshooting documentation recommends checking for a theme or plugin conflict, clearing the browser cache, and confirming the presence of wp_footer() in the theme. That may sound technical to a typical editor, but the practical meaning is simple: if the theme does not output the necessary scripts at the bottom of the page, the slider may never initialize.

Before rolling this out on an important page, test it on a draft page or in a staging environment. Place one regular Soliloquy slider and one dynamic slider. If the regular one works but the dynamic one does not, the problem is more likely in the source or the shortcode. If neither works, look for a conflict involving the theme, caching, JavaScript optimization, or Soliloquy's own settings.

Safe preparation: do not change the homepage first. Build a test slider, verify it on a draft, then repeat the setup on the live page and only clear the site cache after that.

Installation and the First Post-Activation Check

In a standard setup, installing the Dynamic Addon happens through the Soliloquy add-ons interface. The official instructions describe the path through Soliloquy - Addons: find the required add-on, click Install, then click Activate. After installation, add-on updates are checked like regular plugin updates on the Plugins page.

If the main Soliloquy plugin is not installed yet, install that first. For the paid version, the documentation describes downloading the ZIP archive from your account, installing it through Plugins - Add New - Upload Plugin, and activating it. For this guide, the upload procedure itself is not the important part. What matters is the follow-up check: the admin panel should show the Soliloquy menu, and the add-ons list should be accessible without errors.

Initial Check in the Admin Panel

After activation, verify three things. First, the Dynamic Addon appears as active. Second, a special Dynamic Settings slider is now visible or available in Soliloquy. Third, you can open it for editing and move through its settings tabs. If the tabs do not load or the screen looks broken, do not move on to the shortcode yet. First rule out an admin script conflict, browser cache issues, or an incomplete installation.

For a clean starting point, create a separate test post with three images. Upload them directly from that post's editor, publish or save the post so it receives an ID, and only then try the dynamic shortcode. That test immediately shows whether the Dynamic Addon can see the post attachments and output them using the base settings.

What Not to Do Right Away

Do not begin with folder mode inside wp-content if you have not yet tested a simpler mode. Do not insert a template tag into parent theme files without a child theme and a backup. Do not reuse the same custom-XXX from the documentation in multiple places. And do not load your first test with dozens of large images: if the slider is slow, you will not know whether the cause is the source, file size, or a broader conflict.

A good first validation looks like this: one base Dynamic Settings slider, one test post, three prepared images, one shortcode in the editor, and a front-end check without cache. After that, you can move on to real-world scenarios and more complex sources.

Core Settings for the Dynamic Settings Slider

The Dynamic Settings slider is the center of the configuration. It is not a slider with a specific image set. It is a rule set that your dynamic outputs will use. If you set a poor size, an incorrect position, or questionable navigation behavior here, the same issue will repeat everywhere you use dynamic output.

Image Size and Cropping

Start with size. For a dynamic slider, it is especially important that the source images have similar proportions. If one file is horizontal, another is square, and a third is vertical, the slider can feel jumpy or require aggressive cropping. Soliloquy settings usually let you choose size and cropping behavior, but the final result always depends on the source files and the theme.

For a typical content slider on a post page, a moderate horizontal format is usually better than an oversized hero height. For a project page, a wider format can work well if the photos were prepared with that in mind. For a gallery inside an article, stability matters most: consistent height, clear arrows, readable captions, and no abrupt jumps when switching slides.

Check after changing the size: open the page on a desktop screen and a mobile device, move through every slide, and look for cropped details or stretched images. If the issue appears only with some files, start with image preparation rather than assuming the plugin is at fault.

Navigation, Autoplay, and Interaction

A dynamic slider is often placed inside content that visitors are actively reading. Because of that, aggressive autoplay can be distracting. If the slider is there to illustrate a post, it is usually better to keep navigation clear without making it too intrusive. If the block sits near the top of the page and is meant to quickly showcase a set of items, autoplay can make sense, but it should be tested on mobile.

Arrows and navigation dots are useful when visitors need to understand that the block contains multiple images. If you only have two slides, arrows may be enough. If there are more, dots help communicate the size of the set. With dynamic sources, remember that the number of slides can change, so the navigation design should hold up whether there are three images or ten.

Captions, Alt Text, and Media Library Data

The Dynamic Addon documentation confirms that captions can be added through the WordPress Media Library. That is an important advantage: the editor can maintain captions and alt text in one place, and the dynamic output can use that data. But this only works if the media library is managed consistently. If the images have empty captions, the dynamic slider will not make them useful on its own.

Before publishing, open the media library and review at least three fields: title, alt text, and caption. Do not turn alt text into SEO spam. For a product image, project photo, or property shot, a short description of what is visible in the frame is usually best. If a caption is only needed in the article and becomes distracting in the slider, check whether it can be disabled in the settings or whether a different source would be a better fit.

How to Safely Roll Back a Questionable Setting

Before changing the base Dynamic Settings slider, take screenshots of the current tabs or export the slider if you use a settings transfer workflow. Soliloquy supports importing and exporting regular slider settings, but add-on settings import correctly only when the relevant add-ons are active. So for a dynamic configuration, it is not enough to save the JSON alone - you also need to confirm that the target site has the same extensions enabled.

If a change breaks the output, do not edit several parameters at once. Revert the last setting you changed, click Update, clear the cache, and test the page again. That approach is much faster than randomly changing size, navigation, autoplay, and CSS at the same time.

Image Sources: Which Mode to Choose

The most product-specific part of Soliloquy Dynamic is choosing the image source. This is where the Dynamic Addon differs most clearly from a regular slider. The documentation lists several options: images attached to the current or a specific post, images by Media Library ID, images by URL, files from a folder inside wp-content, a standard WordPress gallery using the soliloquy="true" parameter, and galleries from NextGEN and Envira.

Attached Post Images

This is the best starting mode if each post or page has its own set of photos. It is important to understand the word "attached." The Soliloquy documentation explains that an image is considered attached if it was uploaded directly into the post. If the file was uploaded to the media library earlier and only later inserted into the post, it may appear in the content without necessarily being the attachment the dynamic shortcode expects.

The practical workflow is this: open the post, upload images through Add Media, save the post, check its ID in the admin URL, and insert the shortcode with that ID. If the result is empty, do not just verify the shortcode itself. Also check the media library to confirm that the images are actually attached to that post.

When This Mode Is Convenient

This mode works well for photo reports, listing pages, individual case studies, event pages, and custom post types. It gives the editor a clear mental model: the images belong to the post, and the slider outputs the post's images. The fewer manual ID lists you need, the lower the risk of mistakes in day-to-day work.

When This Mode Is Less Convenient

If the same image set needs to appear on many pages, attached mode can become inconvenient. In that case, it is often better to use specific media library IDs, a regular Soliloquy slider, or a separate Envira or NextGEN gallery if that gallery is already the source of truth.

Images by Media Library ID

ID-based mode is useful when you need to build a set from files that already exist. The documentation recommends the Show IDs plugin so you can see IDs in the media library list. In practice, other methods work too, but the principle is the same: the Dynamic Addon needs exact image IDs passed in the images parameter.

An example shortcode looks like this:

[soliloquy_dynamic id="custom-project-42" images="600,601,602"]

Do not copy the numbers from the example. Replace them with your actual image IDs, and make custom-project-42 unique to the page. After inserting it, verify the slide order and captions. If the images change infrequently but the editor needs control over the order, this mode is often more convenient than attached mode.

Direct Image URLs

The Dynamic Addon supports output by URL. This option works when the images live in external storage or are generated outside the standard media library. But it requires strict validation. A direct URL should open the image file itself, not an HTML preview page. The file must be accessible to site visitors without authentication. Ideally, the source should not issue temporary links that expire after a few hours.

Example structure:

[soliloquy_dynamic id="custom-remote-01" images="https://example.com/image-01.jpg,https://example.com/image-02.jpg"]

This mode should not be used as a replacement for a normal media library without a clear reason. If the images belong to the site and are meant to remain part of its content over time, the WordPress media library is more convenient for alt text, captions, search, and maintenance.

A Folder Inside wp-content

Folder mode is appealing at first glance: drop images into a directory and output them dynamically. But the Soliloquy documentation explicitly notes that this is a more technical method that requires access to server files. The folder must be directly inside wp-content, subdirectories do not work, file names should ideally be alphanumeric without spaces, and supported formats include JPG, JPEG, PNG, and GIF.

The ID format defines the folder name after the prefix:

[soliloquy_dynamic id="folder-slider"]

In this example, the Dynamic Addon expects the folder wp-content/slider. If you create wp-content/uploads/slider or wp-content/slider/gallery, that is a different path and you will not get the expected result. This mode can be useful for a small internal image set. For a large photo archive, it is a weaker fit: the official documentation warns that performance may be lower, and recommends using it only for a small number of images.

WordPress Gallery, NextGEN, and Envira

If the site already uses standard WordPress galleries, the Dynamic Addon lets you override their output by adding soliloquy="true" to the gallery shortcode. This is a convenient way to improve older content without rebuilding every slider manually. But it requires careful editing: the parameter must be added to the gallery shortcode itself, not to a normal text block.

For NextGEN and Envira, the logic is similar: you need the gallery ID and a special prefix in the shortcode. The documentation shows formats such as nextgen-3 and envira-258. This mode is especially useful when the gallery is already the main image repository and Soliloquy is simply being used as an alternative display method.

Shortcode and Template Tag Without Unnecessary Risk

The Dynamic Addon can be output through a shortcode in content or through a template tag in a PHP template. The right choice depends on who controls placement. If the slider should appear inside a post, page, or block, a shortcode is usually enough. If the slider needs to be part of the theme layout, such as directly under the title of a custom post type, a template tag may be the better option.

Shortcode for Editors

The strength of a shortcode is that it can be inserted in the editor without changing theme files. In the block editor, use a shortcode block or another location where WordPress processes shortcodes correctly. In the classic editor, place the shortcode in the post body. One important rule: make sure the quotation marks in the shortcode are plain quotes, not typographic ones. If copied from an article or chat app, curly quotes can break the parameter and make WordPress read it incorrectly.

Basic examples:

[soliloquy_dynamic id="123"]
[soliloquy_dynamic id="custom-gallery-12" images="600,601,602"]
[soliloquy_dynamic id="folder-slider"]

The first option outputs images associated with a post or another ID-based source. The second defines specific images from the media library. The third uses a folder. On a real site, replace every ID with your own values, and do not reuse the same custom ID across multiple dynamic sliders on the same page.

Template Tag for Developers

A template tag is needed when the dynamic slider should be part of a PHP template. The Soliloquy documentation recommends checking whether the soliloquy_dynamic function exists before calling it. That is a safe practice: if the add-on is disabled, the site should not fail because of a missing function.

<?php
if ( function_exists( 'soliloquy_dynamic' ) ) {
    soliloquy_dynamic( array( 'id' => 'custom-gallery-12', 'images' => '600,601,602' ) );
}
?>

Do not place code like this in a parent theme if you do not control its updates. Use a child theme, a documented template area, or another safe insertion method. If you need to render a shortcode through PHP, the official WordPress documentation describes the do_shortcode() function, but it should also be used carefully and only where it is truly needed.

Minimal CSS for Targeted Alignment

Sometimes the slider works correctly but still needs to be aligned inside a specific container. The Soliloquy documentation shows that CSS can be tied to a container ID such as #soliloquy-container-395378. Below is a safe example for a case where a specific dynamic slider needs to be centered and limited in width. Replace the ID with your own, found in the Soliloquy Slider Code sidebar or in the page HTML.

#soliloquy-container-395378 {
    max-width: 960px;
    margin-left: auto;
    margin-right: auto;
}

The check is simple: after adding the CSS, clear the cache, open the page, and confirm that only the intended slider changed. The rollback is equally simple: remove that snippet from wherever you store custom CSS. Do not use a global selector for all Soliloquy containers if the issue applies to only one dynamic block.

Practical Scenario: A Slider for a Project Page

Let us walk through a real scenario. Imagine an agency website where each project page includes several images: an overview, a detail shot, part of the process, and the final result. The goal is for the editor to upload those images directly to the project post, while the site automatically displays them as a slider below the intro text. For this use case, the Dynamic Addon is a better fit than manually creating a separate slider for each project.

Goal

Create a dynamic slider on the project page that pulls images attached to that page, applies a shared settings template, and does not require the editor to do separate work in the Soliloquy sliders list. The result should be stable: if the editor adds a new attached image, it becomes part of the set after the page is updated and the cache is cleared.

Preparation

Before configuring anything, make sure the main Soliloquy plugin and the Dynamic Addon are active, the Dynamic Settings slider is published, and the editor has permission to upload images. Prepare 4 to 6 files with the same orientation and reasonable size. Do not start with full-size camera originals: the slider should be visually clean and fast.

Steps

1. Open the project post in the WordPress admin panel.
2. Upload images through that post's editor so they become associated with the content.
3. Save the post and check its ID in the admin address bar.
4. Insert the shortcode [soliloquy_dynamic id="123"], replacing 123 with the actual post ID.
5. Update the post and open the public page outside edit mode.
6. Verify that all required images are visible, navigation works, and the block height does not jump.

Verifying the Result

On the public page, you should see more than just an image. You should see a full Soliloquy slider: the container, arrows or navigation dots, slide switching, correct height, and no overlap with nearby text. If captions are enabled, make sure they match the images. If captions are empty or duplicated, go back to the media library and fill in the file data.

The Detail That Commonly Breaks This Scenario

If the images were uploaded to the media library in advance and then simply inserted into the post, the Dynamic Addon may not recognize them as attached to that post. This is not a slider bug. It is a feature of how WordPress media attachments work. In that case, either reattach the images or use media library ID mode instead. For an editorial team, it is worth documenting this in a short internal guideline: "for the project slider, upload images from the project editor, not from the shared media library."

Scenario takeaway: the Dynamic Addon is especially useful where page structure repeats but the image set changes from post to post. The key is to choose a source that matches the editor's normal workflow.

How to Check the Front-End Result After Setup

Result validation matters not only after the initial setup. A dynamic slider depends on its data source, so its state can change after images are added, the theme is changed, plugins are updated, optimization is enabled, or the site is migrated. A solid validation process helps you distinguish a content issue from a technical conflict.

Browser Check

Open the page in a regular browser and then in a private window. If the slider works while you are logged in as an admin but fails for guests, check caching, script optimization, and image access permissions. If the slider does not work anywhere, open the browser console and look for JavaScript errors. Soliloquy's troubleshooting documentation recommends capturing the red console errors and sending them to support in complex cases.

Also check image network loading. If the slides come from external URLs, confirm that the browser is not receiving an access error, a redirect to an HTML page, or a blocked resource. If the source is a folder, confirm that the files open by direct URL and are located in the expected place.

Mobile Device Check

On mobile screens, problems with height, cropping, navigation buttons, and lazy loading show up most often. Switch through every slide, rotate the screen, and revisit the page after clearing the cache. If the images look too tall, start by reviewing the original proportions and size settings. If the first frame stays blank for too long, check image optimization and lazy-loading settings. The Soliloquy support forum includes discussions about lazy load and mobile images, so these checks are worth taking seriously.

Post-Update Check

After updating WordPress, Soliloquy, add-ons, the theme, or an optimization plugin, open the pages that contain dynamic output. Check one shortcode inside content, one template tag if you use it, and one slider from a nonstandard source. This minimal set reveals problems much faster than casually looking at the homepage.

If Soliloquy or add-on updates do not appear, the official documentation recommends refreshing the Dashboard - Updates page several times so WordPress rechecks available updates. This guide does not treat that as a universal fix, but as an initial check of the update mechanism it is useful.

When Soliloquy Dynamic Is the Right Choice

Soliloquy Dynamic is worth using when you already have a clear image source and want to turn it into a clean WordPress slider without manually rebuilding every set. Strong use cases include project pages, photo reports, custom post types, older WordPress galleries, media library sets with known IDs, small server-side folders, and integrations with Envira or NextGEN when those galleries are already being used as the data source.

Before deploying it on a live site, verify three things: the Dynamic Settings slider is configured as a shared template, the image source was chosen intentionally, and the public page passes testing on desktop, mobile, and outside admin mode. If all of that checks out, you can move to production placement and download the latest version of Soliloquy Dynamic for further testing on your own site.

If instead you need complex animations, a visual layer editor, and design-heavy hero sections, compare the Dynamic Addon with alternatives before implementation. Soliloquy Dynamic works best not as a flashy design builder, but as a practical bridge between existing WordPress images and a repeatable slider output workflow. That is why it should be evaluated based on source stability, editor usability, and clear diagnostics - not just the appearance of the first slide.