Asset Rules
Assets are the optional static files a skin ships — images and fonts. They live under assets/ and are the main surface the Security model constrains.
Allowed types
Section titled “Allowed types”| Kind | Extensions | Notes |
|---|---|---|
| Image | .png .webp .svg |
SVG MUST be static — no <script>, no external refs. |
| Font | .woff2 |
Subsetted fonts recommended. |
Anything else is a validation error.
Limits (v1)
Section titled “Limits (v1)”- Per file: ≤ 2 MB.
- Total assets: ≤ 10 MB per skin.
- File count: ≤ 64 assets.
Files over the limits are an error; approaching them is a warning.
Safety rules
Section titled “Safety rules”- SVGs MUST NOT contain scripts, event handlers, or external references.
- No asset may reference a network URL. See Security.
- Filenames follow the Folder Structure naming rules.