Di chuyển từ Vercel to Workers Migrate from Vercel to Workers

In this tutorial, you will learn how to migrate your Vercel application to Cloudflare Workers.

You should already have an existing project deployed on Vercel that you would like to host on Cloudflare Workers. Vercel specific features are not supported by Cloudflare Workers. Review the Workers compatibility matrix for more information on what is supported.

Some frameworks like Next.js, Astro with on demand rendering, and others have specific guides for migrating to Cloudflare Workers. Refer to our framework guides for more information. If your framework has a Deploy an existing project on Workers guide, follow that guide for specific instructions. Otherwise, continue with the steps below.

To move your application to Cloudflare Workers, you will need to know your build command and build directory. Cloudflare Workers will use this information to build and deploy your application. We'll cover how to find these values in the Vercel Dashboard below.

In your Vercel Dashboard, find the project you want to migrate to Workers. Go to the Settings tab for your specific project and find the Build & Development settings panel. You will find the Build Command and Output Directory fields there. If you are using a framework, these values may not be filled in but will show the defaults used by the framework. Save these for deploying to Cloudflare Workers. In the below image, the Build Command is npm run build, and the Output Directory is dist.

In the root of your project, create a wrangler.jsonc or wrangler.toml file (wrangler.jsonc is recommended). What goes in the file depends on what type of application you are deploying: static or single-page application.

For each case, be sure to update the <your-project-name> value with the name of your project and <your-build-directory> value with the build directory from Vercel. Be sure to set the right pathing, for example ./dist if the build directory is dist or ./build if your build directory is build.

For a static site, you will need to add the following to your wrangler file.

• wrangler.jsonc
• wrangler.toml

JSONC

{

  "name": "<your-project-name>",

  // Set this to today's date

  "compatibility_date": "2026-06-10",

  "assets": {

    "directory": "<your-build-directory>",

  },

}

TOML

name = "<your-project-name>"

# Set this to today's date

compatibility_date = "2026-06-10"


[assets]

directory = "<your-build-directory>"

For a single page application, you will need to add the following to your wrangler file, which includes the notfoundhandling field.

• wrangler.jsonc
• wrangler.toml

JSONC

{

  "name": "<your-project-name>",

  // Set this to today's date

  "compatibility_date": "2026-06-10",

  "assets": {

    "directory": "<your-build-directory>",

    "not_found_handling": "single-page-application",

  },

}

TOML

name = "<your-project-name>"

# Set this to today's date

compatibility_date = "2026-06-10"


[assets]

directory = "<your-build-directory>"

not_found_handling = "single-page-application"

Some frameworks provide specific guides for migrating to Cloudflare Workers. Please refer to our framework guides for more information. If your framework includes a “Deploy an existing project on Workers” guide, follow it for detailed instructions.

Your application has the proper configuration to be built and deployed to Cloudflare Workers.

The Connect a new Worker guide will instruct you how to connect your GitHub project to Cloudflare Workers. In the configuration step, ensure your build command is the same as the command you found on Vercel. Also, the deploy command should be the default npx wrangler deploy.

Workers Custom Domains only supports domains that are configured as zones on your account. A zone refers to a domain (such as example.com) that Cloudflare manages for you, including its DNS and traffic.

Follow these instructions for adding a custom domain to your Workers project. You will also find additional information on creating a zone for your domain.

Once your custom domain is set up and sending requests to Cloudflare Workers, you can safely delete your Vercel application.

For additional migration instructions, review the Cloudflare Pages to Workers migration guide. While not Vercel specific, it does cover some additional steps that may be helpful.

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/workers/","name":"Workers"}},{"@type":"ListItem","position":3,"item":{"@id":"/workers/static-assets/","name":"Static Assets"}},{"@type":"ListItem","position":4,"item":{"@id":"/workers/static-assets/migration-guides/","name":"Migration Guides"}},{"@type":"ListItem","position":5,"item":{"@id":"/workers/static-assets/migration-guides/vercel-to-workers/","name":"Migrate from Vercel to Workers"}}]}