Gatsby (2)
Last updated Apr 23, 2026 In this guide, you will create a new Gatsby ↗︎ application and deploy to Cloudflare Workers (with the new Workers Assets).
1. Set up a new project
Use the create-cloudflare ↗︎ CLI (C3) to set up a new project. C3 will create a new project directory, initiate Gatsby's official setup tool, and provide the option to deploy instantly.
To use create-cloudflare to create a new Gatsby project with Workers Assets, run the following command:
npmyarnpnpm
npm create cloudflare@latest -- my-gatsby-app --framework=gatsby
yarn create cloudflare my-gatsby-app --framework=gatsby
pnpm create cloudflare@latest my-gatsby-app --framework=gatsby
After setting up your project, change your directory by running the following command:
cd my-gatsby-app
2. Develop locally
After you have created your project, run the following command in the project directory to start a local server. This will allow you to preview your project locally during development.
npmyarnpnpm
npm run dev
yarn run dev
pnpm run dev
3. 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.
The following command will build and deploy your project. If you're using CI, ensure you update your "deploy command" configuration appropriately.
npmyarnpnpm
npm run deploy
yarn run deploy
pnpm run deploy
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/gatsby/#page","headline":"Gatsby","description":"Create a Gatsby application and deploy it to Cloudflare Workers with Workers Assets.","url":"https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/gatsby/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/gatsby/og.png?v=bad21e12227ec412","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":["ssg"]}
description: Create a Hono application and deploy it to Cloudflare Workers with Workers Assets. title: Hono image: https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/hono/og.png?v=90fa67c4eec730db
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.
Docs