Images and assets
How files are checked, copied and served.
The build reads each referenced file, checks its bytes, copies it to .specistry/artifacts/assets/<sha256>.<ext> and rewrites the reference. Assets are served with an immutable cache.
| Problem | Diagnostic |
|---|---|
Path leaves docs/ | CONTENT_ASSET_OUTSIDE_ROOT |
File missing | CONTENT_ASSET_NOT_FOUND |
Absolute or malformed path | CONTENT_ASSET_INVALID |
SVG or other type | CONTENT_ASSET_UNSUPPORTED |
Over 2 MiB, or project over 20 MiB | CONTENT_ASSET_TOO_LARGE |