我的书签
添加书签
移除书签Hono (2)
Last updated Apr 23, 2026 Start from CLI - scaffold a full-stack app with a Hono API, React SPA and the Cloudflare Vite plugin for lightning-fast development.
npmyarnpnpm
npm create cloudflare@latest -- my-hono-app --template=cloudflare/templates/vite-react-template
yarn create cloudflare my-hono-app --template=cloudflare/templates/vite-react-template
pnpm create cloudflare@latest my-hono-app --template=cloudflare/templates/vite-react-template
Or just deploy - create a full-stack app using Hono, React and Vite, with CI/CD and previews all set up for you.
What is Hono?
Hono ↗︎ is an ultra-fast, lightweight framework for building web applications, and works fantastically with Cloudflare Workers. With Workers Assets, you can easily combine a Hono API running on Workers with a SPA to create a full-stack app.
Creating a full-stack Hono app with a React SPA
- Create a new project with the create-cloudflare CLI (C3)npmyarnpnpm
npm create cloudflare@latest -- my-hono-app --template=cloudflare/templates/vite-react-template
yarn create cloudflare my-hono-app --template=cloudflare/templates/vite-react-template
pnpm create cloudflare@latest my-hono-app --template=cloudflare/templates/vite-react-template
<details><summary>
How is this project set up?</summary>
Below is a simplified file tree of the project. - my-hono-app - src - worker/ - index.ts - react-app/ - index.html - vite.config.ts - wrangler.jsonc
<code>wrangler.jsonc</code> is your <a href="https://developers.cloudflare.com/workers/wrangler/configuration/">Wrangler configuration file</a>. In this file: - <code>main</code> points to <code>src/worker/index.ts</code>. This is your Hono app, which will run in a Worker. - <code>assets.not_found_handling</code> is set to <code>single-page-application</code>, which means that routes that are handled by your SPA do not go to the Worker, and are thus free. - If you want to add bindings to resources on Cloudflare's developer platform, you configure them here. Read more about <a href="https://developers.cloudflare.com/workers/runtime-apis/bindings/">bindings</a>.
<code>vite.config.ts</code> is set up to use the <a href="https://developers.cloudflare.com/workers/vite-plugin/">Cloudflare Vite plugin</a>. This runs your Worker in the Cloudflare Workers runtime, ensuring your local development environment is as close to production as possible.
<code>src/worker/index.ts</code> is your Hono app, which contains a single endpoint to begin with, <code>/api</code>. At <code>src/react-app/src/App.tsx</code>, your React app calls this endpoint to get a message back and displays this in your SPA.</details>
- Develop locally with the Cloudflare Vite plugin
After creating your project, run the following command in your project directory to start a local development server.npmyarnpnpm
npm run dev
yarn run dev
pnpm run dev
<details><summary>
What's happening in local development?</summary>
This project uses Vite for local development and build, and thus comes with all of Vite's features, including hot module replacement (HMR).
In addition, <code>vite.config.ts</code> is set up to use the Cloudflare Vite plugin. This runs your application in the Cloudflare Workers runtime, just like in production, and enables access to local emulations of bindings.</details>
- Deploy your project
Your project can be deployed to a *.workers.dev subdomain or a Custom Domain, from your own machine or from any CI/CD system, including Cloudflare's own Workers Builds.
The following command will build and deploy your project. If you are using CI, ensure you update your "deploy command" configuration appropriately.npmyarnpnpm
npm run deploy
yarn run deploy
pnpm run deploy
Bindings
The Hono documentation ↗︎ provides information on how you can access bindings in your Hono app.
With bindings, your application can be fully integrated with the Cloudflare Developer Platform, giving you access to compute, storage, AI and more.
Bindings
Access to compute, storage, AI and more.
Was this helpful?
YesNo
On this page
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/hono/#page","headline":"Hono","description":"Create a Hono application and deploy it to Cloudflare Workers with Workers Assets.","url":"https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/hono/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/hono/og.png?v=90fa67c4eec730db","dateModified":"2026-04-23","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["Hono"]}
description: Learn how Wrangler automatically detects and configures your project for Cloudflare Workers. title: Deploy an existing project image: https://developers.cloudflare.com/workers/framework-guides/automatic-configuration/og.png?v=7d0f8d3dc115af82
Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.
