plain-assets changelog

0.4.1 (2026-06-26)

Removed references to the retired plain.esbuild package from the docs and the compile command's comments; plain.tailwind remains an example plain.assets.compile hook. (c6b3c7efc9)

Reserved two top-level subdirectory names inside any assets dir for build tooling. A top-level src/ holds build inputs (a bundler's entry points and the modules they import) — it's skipped by discovery and never served. A top-level dist/ holds build outputs the tool has already content-hashed — Plain serves them immutable and as-is, without re-fingerprinting (it trusts the build tool's hash). Only the top-level src//dist/ are special; a nested foo/src/ is treated normally. Added the is_build_output() helper. (ceefa283)
The assets manifest now records each asset's role inline (redirect target, immutable terminal, or mutable terminal) so immutability survives save/load. (ceefa283)

If you serve files from a top-level src/ directory inside your assets, they will no longer be served — move them out of src/ (or rename the directory). If you output a build tool's pre-hashed files into a top-level dist/, they'll now be served immutable without Plain re-fingerprinting them. Otherwise no changes required.

Command renamed: plain assets build → plain assets compile. Now that the command lives under plain.assets (not core deploy-prep), the verb follows what the asset pipeline actually does. Pre-steps (user shell commands, package entry points) generate inputs that get compiled. (3b30b62309)
User shell commands move from [tool.plain.assets.build.run] to [tool.plain.assets.run]. Drops the redundant .build. segment.
Entry-point group renamed from plain.assets.build to plain.assets.compile. Packages registering pre-compile hooks update their group name.

Replace plain assets build with plain assets compile in deploy scripts, Procfiles, and CI.
Rename [tool.plain.assets.build.run] → [tool.plain.assets.run] in your pyproject.toml.
If you ship a third-party package with a build entry point, rename the group from plain.assets.build to plain.assets.compile. Framework-internal packages (plain.tailwind, plain.esbuild) are updated in this release wave.

Build orchestrator namespace renamed from plain.build to plain.assets.build so the contract follows the package that owns it. (f698ec3436)
- User-defined commands move from [tool.plain.build.run] to [tool.plain.assets.build.run] in pyproject.toml.
- Package entry points move from [project.entry-points."plain.build"] to [project.entry-points."plain.assets.build"].
README documents the build hooks ([tool.plain.assets.build.run] for shell commands, the entry-point group for packages) under a new "Pre-compile build steps" section.

Rename your pyproject.toml:

# Before
[tool.plain.build.run]
openapi = {cmd = "..."}

# After
[tool.plain.assets.build.run]
openapi = {cmd = "..."}

If you ship a third-party package that registers a build entry point, rename your entry-point group from plain.build to plain.assets.build. The framework-internal packages (plain.tailwind, plain.esbuild) are updated in this release wave.

First release. plain.assets is now a separate package, extracted from plain core (844f46e428). It owns:
- The asset finder, manifest, compile pipeline, AssetView, and AssetsRouter
- The plain assets build CLI command (replaces the old plain build)
- The asset() template global
- Settings: ASSETS_REDIRECT_ORIGINAL, ASSETS_CDN_URL, ASSETS_LOG_304

Install the package and add it to INSTALLED_PACKAGES — see the plain 0.142.0 release notes for the full migration.

On this page