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: the honoPreact() Vite plugin and its options.
• 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: switching on the LoaderState status to show skeletons and spinners.
• 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.

For LLMs and AI tools#

These docs are available as plain text for LLMs and AI coding assistants: /llms.txt is a curated index of every page, and /llms-full.txt is the entire documentation concatenated into one file.

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