Islands & resumability

A component renders to static HTML and ships no client JavaScript unless it declares interactivity. The default page is inert HTML plus a stylesheet — the cheapest thing to deliver and run.

Because weak devices make execution a first-order cost, Gomani prefers resumability over hydration: handlers are fetched just-in-time — on hover, viewport entry, idle, interaction, or media — so unreached code is never downloaded or executed. That also conserves battery.

import { island } from '@gomani/core';

// resume only when the island scrolls into view
export default island(Gallery, 'visible');

A throwing island restores its server HTML instead of escaping, so its siblings and the shell are unaffected — fault isolation at the island boundary.