Documentation
Fuzor is an HTML-first framework built on Vite and Effect. Write pages as HTML or Markdown folders, use Precompiled Resumable UI for native interaction, and embed third-party runtimes through Framework Islands. The compiler prepares static structure ahead of time; dynamic server work runs when needed.
The mental model
Three independent choices describe every Fuzor app:
| Choice | Options | Decided by |
|---|---|---|
| Navigation | spa: one document, the router swaps pages. mpa: one document per page, normal links. | --target |
| Delivery | Static files, or a Node/Cloudflare runtime | Automatic for backend/request-rendered routes; --server forces it |
| Interactivity | Managed native state/handlers, imperative scripts or Framework Islands | HTML module scripts and optional <fuzor-island> integrations |
Pages are static by default. A server can serve those same prerendered documents alongside API endpoints and server data. Explicit request-rendering policies also run backend work against compiled templates before sending HTML; compiled server components remain an opt-in integration.
Where to go next
- New to Fuzor: Getting started, then the examples, which run all four delivery modes side by side.
- Building UI: Fuzor UI, live components, styling and restoration.
- Writing an app: Project structure, pages and routing, islands, Markdown.
- Adding a backend: API endpoints and server data.
- Shipping: build profiles and deployment.
- Looking something up: CLI, configuration, runtime API, server API.
- Integrating a product: Advanced, including UI brands.
Frequently Asked Questions
--target flag.
fuzor/ui, which provides design-system agnostic components driven by Zag.js state machines.
Status
Fuzor is early software and these docs follow the current repository, including unreleased changes. The API can change between minor versions; the upgrade guide lists breaking changes. Node and Cloudflare delivery and Electron/Capacitor integrations have repository verification; they have distinct limits described in deployment and embedded apps. Automatic ISR storage and Vercel/Netlify adapters are not implemented.