Start from scratch
To start from scratch to create a Workers Site, follow these steps:
Ensure you have the latest version of Wrangler and Node.js installed.
In your terminal run
wrangler generate --site <project-name>
, replacing<project-name>
with the name of your project. For example, I’ll create a project called my-site by running this command:$ wrangler generate --site my-site
This command creates the following:
public
: The static assets for your project. By default it contains anindex.html
and afavicon.ico
.workers-site
: The JavaScript for serving your assets. You don’t need to edit this- but if you want to see how it works or add more functionality to your Worker, you can editworkers-site/index.js
.wrangler.toml
: Your configuration file. You’ll configure your account and project information here.
Add your
account_id
yourwrangler.toml
. You can find youraccount_id
on the right sidebar of the Workers or Overview Dashboard. Note: You may need to scroll down! For more details on finding youraccount_id
visit Getting started.You can preview your site by running:
$ wrangler preview --watch
Decide where you’d like to publish your site to: a workers.dev subdomain or your personal domain registered with Cloudflare.
Then, update your
wrangler.toml
:Personal Domain: Add your
zone_id
and aroute
.zone_id = "42ef.."route = "example.com/*"
workers.dev: Set
workers_dev
to true. This is the default.Learn more about configuring your project.
Run:
$ wrangler publish