Dashboard

Follow this guide to create a Workers application using the Cloudflare dashboard.

Try the Playground

The quickest way to experiment with Cloudflare Workers is in the Playground ↗. The Playground does not require any setup. It is an instant way to preview and test a Worker directly in the browser.

Prerequisites

Sign up for a Cloudflare account ↗ if you have not already.

Setup

To create a Workers application:

1. Log in to the Cloudflare dashboard ↗ and select your account.
2. Go to Workers & Pages.
3. Select Create application.
4. Select a template or Create Worker.
5. Review the provided code and select Deploy.
6. Preview your Worker at its provided workers.dev subdomain.

Development

Dashboard

Editing in the dashboard is helpful for simpler use cases.

Once you have created your Worker script, you can edit and deploy your Worker using the Cloudflare dashboard:

1. Log in to the Cloudflare dashboard ↗ and select your account.
2. Select Workers & Pages.
3. Select your application.
4. Select Edit Code.

Wrangler CLI

To develop more advanced applications or implement tests, start working in the Wrangler CLI.

1. Install npm ↗.
2. Install Node.js ↗.

Node.js version manager

Use a Node version manager like Volta ↗ or nvm ↗ to avoid permission issues and change Node.js versions. Wrangler, discussed later in this guide, requires a Node version of 16.17.0 or later.

3. Run the following command, replacing the value of [<DIRECTORY>] which the location you want to put your Worker Script.

npm

npm create cloudflare@latest [<DIRECTORY>] -- --type=pre-existing

yarn

yarn create cloudflare@latest [<DIRECTORY>] --type=pre-existing

pnpm

pnpm create cloudflare@latest [<DIRECTORY>] --type=pre-existing

bun

bun create cloudflare@latest [<DIRECTORY>] --type=pre-existing

After you run this command - and work through the prompts - your local changes will not automatically sync with dashboard. So, once you download your script, continue using the CLI.