From ec812ab64c53e3dc2e4f69aec3028c40cde393cf Mon Sep 17 00:00:00 2001 From: Bert Belder Date: Thu, 1 Oct 2026 12:59:48 -0700 Subject: [PATCH 1/3] docs(cli): document --build-timeout unit suffixes and deno.json precedence --- runtime/reference/cli/deploy.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/runtime/reference/cli/deploy.md b/runtime/reference/cli/deploy.md index 72a3421d1..a52539eb5 100644 --- a/runtime/reference/cli/deploy.md +++ b/runtime/reference/cli/deploy.md @@ -1,5 +1,5 @@ --- -last_modified: 2026-02-12 +last_modified: 2026-10-01 title: "deno deploy" command: deploy openGraphLayout: "/open_graph/cli-commands.jsx" @@ -68,6 +68,11 @@ These flags control where the app code comes from: #### Build configuration options +If the app directory's `deno.json` has a `deploy` section, it takes precedence +over these options on every deploy, and `deno deploy create` warns when they +would be overridden. See +[editing app configuration from source code](/deploy/reference/builds/#editing-app-configuration-from-source-code). + - `--app-directory ` - Path to the app directory within the project - `--framework-preset ` - Use a framework preset for build defaults. Supported values: `astro`, `nextjs`, `nuxt`, `remix`, `solidstart`, @@ -99,8 +104,8 @@ These flags control where the app code comes from: #### Build resource options -- `--build-timeout ` - Build timeout. Allowed values: `5`, `10`, `15`, - `20`, `25`, `30` +- `--build-timeout ` - Build timeout, in minutes or with a unit suffix + (e.g. `10`, `10m` or `600s`). Allowed values: 5, 10, 15, 20, 25 or 30 minutes - `--build-memory-limit ` - Build memory limit in MB. Allowed values: `1024`, `2048`, `3072`, `4096` - `--region ` - Deployment region. Allowed values: `us`, `eu`, `global` @@ -119,7 +124,8 @@ you through each configuration step: 6. **Build configuration** - Auto-detects framework settings. You can accept the detected config or configure manually (framework preset, install/build commands, runtime mode, etc.) -7. **Build timeout** - How long the build can run +7. **Build timeout** - How long the build can run (skipped when the detected + `deno.json` `deploy` section decides it) 8. **Build memory limit** - How much memory the build gets 9. **Region** - Where to deploy (`us`, `eu`, or `global`) 10. **Confirm** - Review and confirm before creating From d480877cfcb876e2a8c6312acd07520e5ff2edf8 Mon Sep 17 00:00:00 2001 From: Bert Belder Date: Thu, 1 Oct 2026 13:02:47 -0700 Subject: [PATCH 2/3] docs(cli): don't overstate the create warning; mention deno.jsonc --- runtime/reference/cli/deploy.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/runtime/reference/cli/deploy.md b/runtime/reference/cli/deploy.md index a52539eb5..373bf0dbe 100644 --- a/runtime/reference/cli/deploy.md +++ b/runtime/reference/cli/deploy.md @@ -68,9 +68,8 @@ These flags control where the app code comes from: #### Build configuration options -If the app directory's `deno.json` has a `deploy` section, it takes precedence -over these options on every deploy, and `deno deploy create` warns when they -would be overridden. See +If the app directory's `deno.json` or `deno.jsonc` has a `deploy` section, it +takes precedence over these options on every deploy. See [editing app configuration from source code](/deploy/reference/builds/#editing-app-configuration-from-source-code). - `--app-directory ` - Path to the app directory within the project @@ -125,7 +124,7 @@ you through each configuration step: detected config or configure manually (framework preset, install/build commands, runtime mode, etc.) 7. **Build timeout** - How long the build can run (skipped when the detected - `deno.json` `deploy` section decides it) + `deno.json` or `deno.jsonc` `deploy` section decides it) 8. **Build memory limit** - How much memory the build gets 9. **Region** - Where to deploy (`us`, `eu`, or `global`) 10. **Confirm** - Review and confirm before creating From 76c91cc30f8e13e505d8938f70e21279505f8b90 Mon Sep 17 00:00:00 2001 From: Bert Belder Date: Thu, 1 Oct 2026 13:06:16 -0700 Subject: [PATCH 3/3] docs(cli): narrow the deno.json precedence note --- runtime/reference/cli/deploy.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/runtime/reference/cli/deploy.md b/runtime/reference/cli/deploy.md index 373bf0dbe..84380073a 100644 --- a/runtime/reference/cli/deploy.md +++ b/runtime/reference/cli/deploy.md @@ -68,8 +68,9 @@ These flags control where the app code comes from: #### Build configuration options -If the app directory's `deno.json` or `deno.jsonc` has a `deploy` section, it -takes precedence over these options on every deploy. See +If the app directory's `deno.json` or `deno.jsonc` sets build configuration in +its `deploy` section, that takes precedence over the corresponding options on +every deploy. See [editing app configuration from source code](/deploy/reference/builds/#editing-app-configuration-from-source-code). - `--app-directory ` - Path to the app directory within the project @@ -123,8 +124,8 @@ you through each configuration step: 6. **Build configuration** - Auto-detects framework settings. You can accept the detected config or configure manually (framework preset, install/build commands, runtime mode, etc.) -7. **Build timeout** - How long the build can run (skipped when the detected - `deno.json` or `deno.jsonc` `deploy` section decides it) +7. **Build timeout** - How long the build can run (skipped when you accept a + build configuration detected from `deno.json` or `deno.jsonc`) 8. **Build memory limit** - How much memory the build gets 9. **Region** - Where to deploy (`us`, `eu`, or `global`) 10. **Confirm** - Review and confirm before creating