Motivation

Why Swoff

Modern web frameworks (Next.js, Nuxt, etc.) have shifted toward server-side rendering, leaving powerful browser APIs — Service Worker, IndexedDB, Cache API — underutilized. Meanwhile, state management libraries lock you into specific frameworks, and most tools abstract away the browser's native offline capabilities.

Swoff is a framework-agnostic, zero-dependency CLI for client-first web apps. It generates code you own:

• Run npx @swoff/cli generate to produce SW + supporting files
• Every generated file is yours — edit, extend, or remove as needed
• Pair with any framework (React, Vue, Svelte, vanilla JS)
• Build offline-first, installable PWAs that feel native
• Ship updates instantly — no app store friction

We provide code and architecture, not locked-in dependencies.

What Swoff is NOT

• Not a runtime npm package — the CLI generates code you own, with zero runtime dependencies
• Not a backend framework — bring your own Go, Node.js, Python
• Not tied to any fullstack framework — purely client-side
• Not an SSR framework — we focus on browser APIs after the page loads

Next Steps

• Introduction — get started in 2 commands
• CLI Reference — command overview