Documentation

A zero-dependency JavaScript framework built entirely on native browser standards.

Why Weblisk?

Architecture

Weblisk follows the Islands Architecture: pages are fully static HTML, with small interactive "islands" that hydrate independently.

• Instant page loads — HTML renders before any JavaScript runs
• Minimal JS — only interactive parts ship JavaScript
• Works with any backend — Django, Rails, Go, static files
• No build step required — what you write is what ships

Quick Example

<!-- Drop weblisk into any HTML page -->
<script type="importmap">
{ "imports": { "weblisk": "/lib/weblisk/weblisk.js", "weblisk/": "/lib/weblisk/" } }
</script>

<div data-island="/islands/counter.js" data-hydrate="visible">
  <button>Count: 0</button>
</div>

<script type="module">
import { hydrateIslands } from 'weblisk/core/hydrate.js';
hydrateIslands();
</script>

What's Included

52 modules across 11 domains — all opt-in, all zero-dependency:

• Core — Signals, Islands, Hydration, Scheduler, Workers, DevTools
• UI — 13 component utilities (dialog, toast, tabs, accordion, tooltip, dropdown, carousel, progress, skeleton, virtualList, clipboard, theme, component)
• Data — Local-first IDB store with background sync
• State — Forms, undo/redo, cross-tab sync, IDB-backed signals
• Navigation — Route guards, scroll restoration, view transitions, SPA router
• Networking — Enhanced fetch, SSE, WebSocket, WebTransport
• Security — CSP, CSRF, sanitization, Trusted Types, permissions
• Performance — Web Vitals, timing marks, beacon reporting, prefetch & prerender
• PWA — Offline state, push notifications, manifest
• Accessibility — ARIA, focus management, reduced motion, locale formatting
• Testing — DOM assertions, signal spies, island test harness