HTML and CSS rules
HTML and CSS in a design are never pasted into the page as written. The app reads them, keeps only what is allowed, and draws the result. Anything else is refused with a clear message.
Example: you write a skin for a card in your Habits collection.
<div class="habit" onclick="celebrate()"> <img src="https://example.com/smile.gif"> <field name="Done" mark="star"></field></div>The app refuses two things. onclick is an on… attribute, and src points to a web address.
The skin that passes uses an uploaded file instead. Its tick-effect setting plays confetti when
you tick Done, with no script:
<div class="habit"> <img asset="smile" alt=""> <field name="Done" mark="star" tick-effect="confetti"></field></div>HTML
Allowed elements
| Group | Elements |
|---|---|
| Text and structure | div span p br hr h1–h6 strong b em i u s small sub sup mark code pre kbd blockquote q abbr time |
| Lists | ul ol li dl dt dd |
| Tables | table thead tbody tfoot tr th td caption |
| Sections | figure figcaption section article header footer aside details summary |
| Meters | progress meter |
| Our own | field (a property, with its standard editor), piece (a real piece of the entry page, like <piece name="properties">), icon, text |
| Pictures | img and picture, with an uploaded file only (the asset attribute) |
| Safe SVG | svg g path circle ellipse line polyline polygon rect text tspan defs linearGradient radialGradient stop clipPath mask title desc; links only inside the same SVG |
Allowed attributes
class, asset (on pictures), data-*, role, aria-*, lang, dir, title, alt, width,
height, colspan, rowspan, datetime, value, min, max, open, the settings of our own
elements (like mark and tick-effect on field), and SVG shape and paint attributes.
Ids are prefixed, so they can never clash with the app’s own.
Never allowed
| Kind | Refused |
|---|---|
| Elements | script iframe frame object embed form input button textarea select base meta link style template dialog a video audio math foreignObject use image animate set |
| Attributes | any on… attribute, href, src (pictures use asset), srcdoc, action, formaction, ping, contenteditable, inline style |
CSS
| Rule | Detail |
|---|---|
| Allowed properties only | every property must be on the allowed list: the ones the Chrome engine and the Safari engine (at the Safari 18 level) both support. The exact list is not decided yet. |
| No web addresses | no url() except an uploaded file; no image-set(), @import, @font-face or @namespace |
| No fixed position | position: fixed is refused |
No text in content |
a pseudo-element cannot relabel a button |
| Locked dialog buttons | order, flex-direction, direction and transform are refused on a dialog’s footer |
| Locked delete items | a menu item that deletes or removes keeps its place, its wording and a built-in font |
| Selectors | may name only tags, pieces, states and the skin’s own classes; at most three steps; no :has() and no bare * (both are slow on big pages) |
| Screen sizes | @media and @container rules are allowed; every card is a container called card |
| Toasts | can be restyled, never hidden or made transparent |
A second wall: the app’s security rule (CSP, a rule the browser enforces about where a page may load things from) lets pictures and fonts load only from the app itself. So even a rule that slipped past the checker could not send anything out.
HTML blocks are different
These rules are for skins: HTML and CSS that restyle a part of the app. An HTML block is not a skin. It is a block in a Block page or a Dashboard that runs your own HTML, CSS and, if you want, JavaScript, sealed in its own frame. Inside its frame, the lists above do not apply.
| HTML block | Approving one the AI or someone else made |
|---|---|
| Runs a script | a change only you can make: Face ID, a fingerprint, Windows Hello or your device password |
| No script | your tap on the Enable screen; not a protected change |
Size limits
| What | Limit |
|---|---|
| CSS per skin | 32 KB |
| HTML per skin | 16 KB |
| Script | 64 KB |
| HTML block | 1 MB |
Uploaded files
Pictures, GIFs, SVGs, fonts and animation files are always uploaded files, stored in your own account. A design never points to a web link.
| File | What happens on upload |
|---|---|
| Every file | its real type is read from the file itself, not its name; size limits apply |
| Pictures | decoded and saved again, which drops anything hidden inside |
| GIF | becomes an animated WebP, sized for its use, with a still first frame for reduced motion |
| SVG | cleaned with the same safe-SVG list as above |
| Font | checked by OpenType Sanitizer (the font checker Chrome and Firefox use) |
| Lottie animation | its scripts and outside links are removed |
Files are served from their own separate address, marked “never run”, so a file opened directly can never act inside the app.
Uploaded fonts never apply to dialog buttons, delete items or protected screens. A changed font could make “Deny” look like “Allow”.
Sharing a font through the Library works only if its licence allows it (for example the Open Font License). Otherwise the listing names the font and falls back to a built-in one.
Free CSS
Free CSS is an opt-in for your own account. With it, selectors may aim at anything, including parts with no name tag. These rules still apply: no web addresses, the second wall, the locked dialog buttons, and no reach into protected screens. Free CSS is never shared through the Library.
Colours in your designs
Your own designs may use any colour value. The AI writes theme tokens (var(--color-*)) by default,
so your design follows the theme. A Library listing with fixed colours is labelled “won’t follow
your theme”.