Start from existing

Last updated Apr 23, 2026 Use Workers Static Assets Instead

You should use Workers Static Assets to host full-stack applications instead of Workers Sites. It has been deprecated in Wrangler v4, and the Cloudflare Vite plugin does not support Workers Sites. Do not use Workers Sites for new projects.

Workers Sites require Wrangler ↗︎ — make sure to use the latest version.

To deploy a pre-existing static site project, start with a pre-generated site. Workers Sites works with all static site generators, for example:

Getting started

  1. Run the wrangler init command in the root of your project's directory to generate a basic Worker:

sh wrangler init -y

This command adds/update the following files: - wrangler.jsonc: The file containing project configuration. - package.json: Wrangler devDependencies are added. - tsconfig.json: Added if not already there to support writing the Worker in TypeScript. - src/index.ts: A basic Cloudflare Worker, written in TypeScript. 2. Add your site's build/output directory to the Wrangler file:

jsonc { "site": { "bucket": "./public" // <-- Add your build directory name here. } }

toml [site] bucket = "./public"

The default directories for the most popular static site generators are listed below: - Hugo: public - Gatsby: public - Jekyll: _site - Eleventy: _site 3. Install the @cloudflare/kv-asset-handler package in your project:

sh npm i -D @cloudflare/kv-asset-handler

  1. Replace the contents of src/index.ts with the following code snippet:
import { getAssetFromKV } from "@cloudflare/kv-asset-handler";
import manifestJSON from "__STATIC_CONTENT_MANIFEST";
const assetManifest = JSON.parse(manifestJSON);

export default {
    async fetch(request, env, ctx) {
        try {
            // Add logic to decide whether to serve an asset or run your original Worker code
            return await getAssetFromKV(
                {
                    request,
                    waitUntil: ctx.waitUntil.bind(ctx),
                },
                {
                    ASSET_NAMESPACE: env.__STATIC_CONTENT,
                    ASSET_MANIFEST: assetManifest,
                },
            );
        } catch (e) {
            let pathname = new URL(request.url).pathname;
            return new Response(`"${pathname}" not found`, {
                status: 404,
                statusText: "not found",
            });
        }
    },
};

Service Workers are deprecated

Service Workers are deprecated, but still supported. We recommend using Module Workers instead. New features may not be supported for Service Workers.

import { getAssetFromKV } from "@cloudflare/kv-asset-handler";

addEventListener("fetch", (event) => {
    event.respondWith(handleEvent(event));
});

async function handleEvent(event) {
    try {
        // Add logic to decide whether to serve an asset or run your original Worker code
        return await getAssetFromKV(event);
    } catch (e) {
        let pathname = new URL(event.request.url).pathname;
        return new Response(`"${pathname}" not found`, {
            status: 404,
            statusText: "not found",
        });
    }
}
  1. Run wrangler dev or npx wrangler deploy to preview or deploy your site on Cloudflare. Wrangler will automatically upload the assets found in the configured directory.

sh npx wrangler deploy

  1. Deploy your site to a custom domain that you own and have already attached as a Cloudflare zone. Add a route property to the Wrangler file.

jsonc { "route": "https://example.com/*" }

toml route = "https://example.com/*"

Note

Refer to the documentation on Routes to configure a route properly.

Learn more about configuring your project.

Was this helpful?

YesNo

On this page

Start from existing - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/static-assets/#page","headline":"Start from existing","description":"Deploy an existing static site project to Cloudflare using Workers Sites.","url":"https://developers.cloudflare.com/workers/static-assets/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/configuration/sites/start-from-existing/og.png?v=04d6cd6f62df986c","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/"}}

description: Create a new Workers Sites project from scratch with Wrangler. title: Start from scratch image: https://developers.cloudflare.com/workers/configuration/sites/start-from-scratch/og.png?v=cd8ea9ed24d99a3f

Skip to content

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.