Skip to content

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”.