Skip to Main content

tuyen workers deploy

Create or replace a Cloudflare Worker with a built static site.

Create or replace a Cloudflare Worker with a built static site.

Authentication uses the supplied token or CLOUDFLARE_API_TOKEN. This command deploys assets only and does not build the application or load Wrangler configuration.

Usage

tuyen workers deploy [OPTIONS] --app-path <APP_PATH>

Options

-a, --app-path <APP_PATH>

  • Path to the built static application directory to deploy.
  • Required: Yes.
  • Aliases: app, assets.

-n, --name <NAME>

  • Worker name to create or replace, falling back to CLOUDFLARE_WORKER_NAME.
  • Alias: worker-name.

--account-id <ACCOUNT_ID>

  • Cloudflare account identifier, falling back to CLOUDFLARE_ACCOUNT_ID.

-t, --token <TOKEN>

  • Cloudflare API token with Workers Scripts Write permission, falling back to CLOUDFLARE_API_TOKEN.
  • Alias: api-token.

--workers-dev <WORKERS_DEV>

  • Explicitly enable or disable the Worker's public workers.dev route.
  • Possible values: true, false.

--html-handling <HTML_HANDLING>

  • Control how HTML paths are normalized and served.
  • Default value: auto-trailing-slash.
  • Possible values: auto-trailing-slash, force-trailing-slash, drop-trailing-slash, none.

--not-found-handling <NOT_FOUND_HANDLING>

  • Select the response behavior when no matching static asset exists.
  • Default value: none.
  • Possible values: none, 404-page, single-page-application.

--compatibility-date <COMPATIBILITY_DATE>

  • Cloudflare compatibility date controlling runtime behavior.
  • Default value: 2026-09-25.

--exclude <EXCLUDE>

  • Exclude an app-relative glob pattern, pruning matching directories and their contents.

--dry-run

  • Validate and hash local assets without credentials or network requests.
  • Possible values: true, false.

-h, --help

  • Print help.