Beginner’s Guide - UI Deployment

WARNING

First, you need to register a domain. If you want to use it for registering on websites or games like Steam, don’t use cheap domains such as .top or .xyz, because those might be blocked as temporary email domains.

1 Bind Domain

Register an account and log in to the Cloudflare dashboard to start binding your domain (if already bound, you can skip to step 2).

Choose the free plan

Set DNS

DNS modification is similar across providers; here Huawei Cloud is used as an example

After setting, it may take a few minutes. You can refresh the browser to check if it’s done

Interface after completion

Now your account homepage will show your domain, domain binding is complete

2 Create Worker Project

Go to the project repository and fork the project code to your own repo

This copies the repository to your account

Go back to Cloudflare dashboard, find the Workers page and import your GitHub repository code

Set the start directory

Wait for build and deployment to complete

Page after build completion

Now the project will appear in the worker list. Click its name to view and configure

3 Set Environment Variables

The service also needs some environment variables and database bindings to run properly

Add the following variables, Note that the domain is of JSON type. The admin account must be registered on the registration page.

Variable Name	Value	Type	Purpose
domain	["yourdomain"], e.g. ["mornglow.top"], multiple domains: ["domain1", "domain2"]	JSON	The website will use this domain as the email domain
admin	Administrator’s email, e.g. [email protected]	Plain Text	This user becomes the site admin after registration
jwt_secret	Any random string, e.g. Z7f!xPq8mV@L2bC$r9X&N1t	Plain Text	Security key for login token

This is how it looks after setting custom domain and environment variables

4 Bind Database

Go to Storage and Database in the left menu, create a KV database, name it arbitrarily

Create a D1 database, name arbitrarily, location near you

Go back to worker settings and bind the created databases
D1 database variable name: db
KV database variable name: kv

In browser, go to https://your-custom-domain/api/init/your-jwt_secret to auto-initialize the database
(if previously deployed, it will update without overwriting existing data)