我的书签
添加书签
移除书签SvelteKit (2)
Last updated Oct 10, 2026 In this guide, you will create a new SvelteKit ↗︎ application and deploy to Cloudflare Workers.
Already have a SvelteKit project?
Run wrangler deploy in a project without a Wrangler configuration file and Wrangler will automatically detect SvelteKit, generate the necessary configuration, and deploy your project.
npmyarnpnpm
npx wrangler deploy
yarn wrangler deploy
pnpm wrangler deploy
Learn more about automatic project configuration.
First deploy fails with `Types file not found`
When Wrangler configures an existing SvelteKit project, it runs the Svelte CLI (sv add) to install the Cloudflare adapter. This adds wrangler types --check to the build script in your package.json. The types file does not exist yet, so the first build fails with the following error:
✘ [ERROR] Types file not found at worker-configuration.d.ts.
To fix this, generate the types file, then deploy again:
npmyarnpnpm
npx wrangler types
yarn wrangler types
pnpm wrangler types
npmyarnpnpm
npx wrangler deploy
yarn wrangler deploy
pnpm wrangler deploy
You only need to do this once. Wrangler has already created your Wrangler configuration file, so the second deploy skips project setup.
SvelteKitDetected
Generated configuration
wrangler.jsonc
main:.svelte-kit/cloudflare/_worker.js
wrangler.jsonc
assets:directory: .svelte-kit/cloudflare
wrangler.jsonc
compatibility_flags:nodejs_compat
wrangler.jsonc
observability:enabled: true
svelte.config.js
adapter:@sveltejs/adapter-cloudflare
WorkersDeployed
Wrangler handles configuration automatically
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 SvelteKit's official setup tool, and provide the option to deploy instantly.
To use create-cloudflare to create a new SvelteKit project with Workers Assets, run the following command:
npmyarnpnpm
npm create cloudflare@latest -- my-svelte-app --framework=svelte
yarn create cloudflare my-svelte-app --framework=svelte
pnpm create cloudflare@latest my-svelte-app --framework=svelte
After setting up your project, change your directory by running the following command:
cd my-svelte-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
Bindings
Your SvelteKit application can be fully integrated with the Cloudflare Developer Platform, in both local development and in production, by using product bindings. The SvelteKit documentation ↗︎ provides information about configuring bindings and how you can access them in your SvelteKit hooks and endpoints.
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
Docs{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/framework-guides/web-apps/sveltekit/#page","headline":"SvelteKit","description":"Create a SvelteKit application and deploy it to Cloudflare Workers with Workers Assets.","url":"https://developers.cloudflare.com/workers/framework-guides/web-apps/sveltekit/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/framework-guides/web-apps/sveltekit/og.png?v=ca4adb487e3c7611","dateModified":"2026-10-10","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":["spa"]}
description: Deploy a TanStack Start application to Cloudflare Workers. title: TanStack Start image: https://developers.cloudflare.com/workers/framework-guides/web-apps/tanstack-start/og.png?v=7e028d16354c90aa
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.
