DF0064: Remote Assets Materialization Failed
Message
Failed to materialize the remote assets of "
{package}@{version}":{reason}
Cause
A static build (createBuild) with a remote-assets distDir needs every asset file up front — the output must be self-contained. Materialization walks the provider's file listing and downloads each file, and one of those steps failed: the provider has no listFiles (custom providers may omit it), the listing request failed, or an individual file download errored.
Example
sh
my-tool buildRunning a static build on a machine without network access to the CDN provider — and without the assets package installed locally — throws DF0064.
Fix
- Install the assets package locally (
npm install <package>@<version>) — builds copy from the local install and touch no network. - Otherwise ensure the provider and its file-listing API are reachable during the build, or configure a custom provider that implements
listFiles.
Source
packages/devframe/src/utils/remote-assets.ts—createRemoteAssetsStore()'smaterialize()throws this when the file listing is unavailable or a download fails.