Skip to main content
Install the script once in your shared layout. Give targets stable selectors and make sure they exist before Dynamite binds them. Use the published site when checking installation.

​
React and client navigation

React can overwrite external DOM changes during hydration or rerendering. Use a stable wrapper outside interactive subtrees, or insert content after a stable anchor. Keep forms and application state owned by React. Dynamite observes History API navigation and binds on the next animation frame. If a target renders later, you need an application-specific lifecycle integration. Calling refresh() does not discover missing elements. For deeper integration, use the adaptive library with your own renderer.

​
Domains and checkout

Origins must match exactly, including scheme, hostname, and port. Configure staging separately from production. A storefront script does not automatically run in checkout or apply discounts. Keep prices, stock, and checkout behavior in the commerce platform. Check initial load, client navigation, back/forward navigation, and the original state before publishing.