dvorakmortonxd/dvorakmortonxd.dev
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: note the reveal contract in agents.md

Browse source
This commit is contained in:
Martin Dvořák 2026-09-30 08:13:49 +00:00
commit 39f383b7cf
1 changed files with 6 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

6
agents.md
View file

@ -228,6 +228,12 @@ not free placement. Don't confuse the two.
- CSS classes are prefixed by area: `win-` (desktop), `app-` / `kickoff` etc.
(desktop windows), plus the editorial design-system classes (`shell`, `display`,
`label`, `rule*`, `glass*`). Grep by prefix to find styles.
- The editorial page reveals blocks with `.reveal` (see `Reveal` in
`editorial-ui.tsx`): hidden by default, `.is-in` shows. On load the first
screenful cascades top-to-bottom (90ms per block, in DOM order); the rest
reveal when they scroll in. **Wrap every content block** — anything left
unwrapped paints before the top and breaks the top-to-bottom order. The
`<noscript>` rule in `layout.tsx` keeps everything visible without JS.
- Several places deliberately use **imperative DOM work** (e.g. the drag ghost).
This is intentional for performance; prefer matching the existing pattern over
"Reactifying" it.