6.0.0
Breaking changes
- Obfuscate CSS custom properties declared in stylesheets; list names also set or read by JavaScript or inline styles in
:public_css_variables - Render
script/2astype="module" crossorigin="anonymous", ignoring caller:typeand:crossorigin, and sendrel=modulepreloadearly hints - Default
<.picture>fetchpriorityto"auto" - Without
:onlyor:only_matching, pass unknown paths to the next plug instead of responding404 - Reject class attributes that mix literal strings with dynamic values
- Require Phoenix.HTML 4.4 (CVE-2026-117645) and Floki 0.38
- Remove unused functions, including
build_static_file/2,source_snapshot/1,build_from_source_snapshot/1andManifest.cached_loaded?/0
Enhancements
- Add
mix phoenix_asset_pipeline.imagesto regenerate PNG sources from artwork - Apply endpoint path prefixes to SVG sprite hrefs and early hints
- Accept script and style names without an extension
- Minify empty attribute values to bare attribute names, and drop whitespace that is never rendered: at the document level, in
<head>, tables and<select> - Rebuild cached manifests after upgrades and refresh cached URLs when the endpoint configuration changes
- Update Bun to 1.4.4 and dependencies, including Vix 0.43 and mbrotli 0.5.22
Bug fixes
- Prepare CSS on a dedicated stack, so deeply nested rules and long expressions no longer terminate the VM
- Fix
Cache-Controlon 406 and 416 responses,If-Match,If-None-Match: *, content-coding preference andnosniff - Fix
@supports selector()renaming, whitespace in spread attributes,</in inline styles and comma-separatedsrcset - Recover interrupted image generation and Bun installs, reinstall dependencies changed during installation, scan default arguments and
defdelegateheads and skip typespecs when collecting image references, and keep manifests in sync with the latest static files - Track package metadata of extended TypeScript configs without watching their directories
- Fix
localhosthost mirroring and IPv6 literals - Keep
<pre>,<textarea>,<script>and<style>contents intact when dynamic parts split them - Formatter: produce output the next
mix formatkeeps unchanged, keep multi-line literals, long literals, non-UTF-8 input,phx-no-formatcontents and expressions inside raw text elements unchanged, split classes on HTML whitespace only, keep pixel values during Tailwind canonicalization, and canonicalize single-quoted or spaced class attributes in one pass
5.0.1
- Preserve CSS comments while rewriting selectors and custom properties
- Parse Elixir and HEEx for SVG sprite references, including braced literal attributes, without treating comments or documentation as dependencies
- Preserve whitespace-sensitive HEEx text and honor
phx-no-formatin inline and file templates - Share short-class allocation and prefix normalization, avoiding repeated suffix scans for module-scope classes
- Update native dependencies, including fearless_simd 1.2.0, and require mbrotli 0.5.17 or later
- Ignore byte ranges when
If-Rangecannot match a strong ETag, including digested assets without ETags - Accept
If-None-Match: *only as a standalone value, preserving weak ETag and list matching - Reject ETag matches followed by invalid suffixes or missing list separators
- Share range validation without scanning
If-Rangeon requests without a byte range
5.0.0
- Replace Brotli with compression-only mbrotli and reuse bounded encoder workspaces per dirty scheduler thread
- Preload only explicitly selected JavaScript entries in early hints, include their integrity hashes, and cache each selection independently
- Require Elixir 1.20, Erlang/OTP 29, and Phoenix LiveView 1.2; update the Rustler crate to 0.39
- Require the oriented source pixel width in
<.picture source_width={...}>, emit accurate width descriptors for every image format, and support responsivesizes - Keep the highest-density candidate when generated widths coincide, and match libvips rounding for nonuniform density configurations
- Update the managed Bun runtime to 1.4.3, verify archives and executables with pinned SHA-256 checksums, and type-check TypeScript builds
- Use OTP's system CA certificates for Bun downloads, with an explicit custom CA bundle option
- Allow GitHub release redirects with response headers up to 64 KiB when installing Bun
- Replace MD5 content identities with SHA-256 and reject symlink traversal or duplicate asset output paths
- Require one canonical CSP header with compile-time application-specific directives, accept bounded Reporting API batches and parameterized CSP report content types without logging report contents, and remove manifest race fallbacks
- Track JavaScript dependencies, package metadata, and inherited compiler configs without rebuilding on unrelated file events
- Scope Bun caches by asset root and track type-only imports, new module-resolution candidates, Tailwind source/import dependencies, and source-directory retargeting; reject unsupported binary bundle outputs
- Confirm stable dependency snapshots before caching Bun output, retry only changed build groups, and fail after three unstable attempts
- Keep
idattribute values quoted, preserve HTML attribute backslashes, quoted HEEx attribute values, HTML5 entities, class-expression comments, and SVG self-closing tags, safely reduce redundant whitespace, and sort multiline attributes without altering their contents - Preserve class attribute selectors, grouped style-query custom-property references, URL tokens, and unknown or invalid feature-test guards during CSS rewriting; match only exact Tailwind legacy conditions and reject unsupported class-selector matching modes
- Serve all manifest image extensions and use linear short-class allocation
- Validate complete cached static assets and use canonical CORS origins for endpoints with path prefixes
- Preserve raw HEEx text across dynamic expressions and rename CSS custom properties consistently in transitions, including Unicode names
- Remove all application dependency cycles
- Reduce NIF allocation overhead for Brotli and CSS output
- Isolate Bun temporary directories between processes, bound parallel compression, and remove redundant SVG source fields and legacy descriptor records
- Let configured SVG sprite modes override directory naming, and omit a shared root viewBox in stacked sprites
- Keep nested and overlapping compiler-disable scopes balanced
- Update dependencies, including Plug Crypto 2.2.1 to fix CVE-2026-105963
4.2.0
- Canonicalize Tailwind classes through the HEEx formatter with an optional stylesheet setting
- Load the generated manifest immediately so the first production startup succeeds
- Reduce memory use when compiling production manifests
4.1.0
- Add generated files to the shared manifest
4.0.1
- Rebuild Bun assets when imported dependencies outside configured asset sources change
- Allow LiveView to update
<.picture>and remove its requiredid - Update Vix to 0.42.0 and bundled libvips to 8.18.7
4.0.0
- Remove image placeholders from
<.picture> - Strip metadata from generated images, including PNG resolution (
pHYs) - Preserve SVG transforms and their precision during optimization of standalone files and sprites
- Update Brotli to 9.0 and Bun to 1.4.2
- Replace
:manifest_modewith:precompiled_manifest(defaultfalse); enable it for production - Fix development reloads, HTTP ranges and conditional requests, HEEx
noformat, and class formatting - Reduce Bun hashing, module-class scans, numeric-entity parsing costs, and temporary allocations
3.0.2
- Render image placeholders at 80% opacity
3.0.1
- Preserve updated adapter state after sending 103 Early Hints
3.0.0
- Extract, obfuscate, and format component attributes ending in
_classlike standardclassattributes - Require Rust 1.98 and use buffered integer formatting for CSS marker generation
- Compress high-density AVIF variants more aggressively while preserving 1x quality
- Serve monotone light-gray image placeholders as content-addressed PNG assets with inset masks that preserve transparency
- Remove generated placeholder CSS and
data:from the default image CSP
2.1.1
- Generate monotone light-gray image placeholders constrained to the solid inset silhouette of transparent masters
- Remove the image placeholder cleanup runtime from generated JavaScript bundles
2.1.0
- Upgrade the managed Bun runtime to 1.4.0.
- Accept JPEG image masters, auto-orient them, enforce a configurable pixel limit, and generate configurable density variants.
- Generate obfuscated Bun ThumbHash placeholders, render them through a configured stylesheet and the
manifest-backed
picturecomponent, and remove their backgrounds after images load.
2.0.2
- Include non-hidden files under the root
.well-knownstatic directory automatically.
2.0.1
- Add Hex package links and README badges for the changelog and documentation.
2.0.0
Breaking changes
- Require Elixir 1.18+ and Erlang/OTP 28+.
- Use
PhoenixAssetPipeline.HTML.Enginefor HEEx templates. - Add
:phoenix_asset_pipeline_preparebefore Elixir and:phoenix_asset_pipelineafter:app. - Replace the previous asset tasks and storage with the manifest pipeline.
- Remove
phoenix_asset_pipeline.assets.build,phoenix_asset_pipeline.assets.deploy, and packaged image/SVG scripts. - Move development rebuilds from endpoint watchers to
PhoenixAssetPipeline.Watcher. - Default
:manifest_modeto:cached; production builds must select:precompiledand provide an exact:bun_versionplusassets/bun.lock.
Highlights
- Build JS, Tailwind CSS, SVG sprites, optimized images, static files, and the manifest in one pipeline.
- Namespace internal sprite IDs by default and support cache-aware root metadata from
metadata_file. - Minify module-scope classes before Elixir compilation and reserve identical mappings during CSS rewriting.
- Resolve function and HEEx class expressions from the current manifest at runtime.
- Rewrite CSS selectors and Tailwind custom properties in native passes without Elixir byte scanning.
- Deduplicate content, cache build outputs, and compress production assets with four bounded workers.
- Serve sparse Brotli, gzip, deflate, and Zstandard representations with range and conditional request support.
- Store dynamic manifests in indexed ETS generations and generate precompiled production manifests.
- Provide manifest-backed HTML helpers, components, CSP helpers, early hints, LiveView integration, and static plugs.