hono-preact docs

A small, opinionated full-stack framework. Hono on the edge, Preact in the browser, manifest driven routes, typed RPC, streaming everywhere.

Get started

• Quick start: five-minute walkthrough from pnpm install to a deployed page.
• Project structure: what each file in a hono-preact project does.

Routing and layouts

• Routes: defineRoutes() and the route table.
• Pages: view components and definePage().
• Layouts: nested layouts that survive navigation.
• Vite config: what defineApp() does for you.
• Active links: marking the current route in navigation.
• View transitions: animated route changes with the View Transition API.

Data

• Loaders: server-rendered data with defineLoader().
• Actions: mutations via <Form> and typed RPC.
• Optimistic UI: useOptimistic() and friends.
• Loading states: fallbacks and suspense boundaries.
• Streaming: generator loaders, streaming forms, SSE.

Auth and access

• Middleware: the unified use primitive for auth gates, redirects, request-scoped setup, and stream observers.
• CSRF protection: built-in CSRF token validation for forms and mutations.
• Composing Hono middleware: wiring Hono-native middleware and custom routes alongside the framework.

Operations

• Prefetch: preloading routes on hover or focus.
• Link prefetch: browser-level speculation rules for near-instant navigation.
• Reloading: invalidating loaders after mutations.
• renderPage: the SSR entry point.
• Deployment: shipping to Cloudflare Workers or Node.js.
• WebSockets: full-duplex connections via Hono's WebSocket helper.

Looking for a working app to read? The whole demo is built with the framework.