Remove unnecessary configurations

Configuration files should only include options that are supported in production and work out of the box. Remove configuration fields that are unsupported in production environments, comment out configurations that require external provisioning, and maintain consistency across templates by removing redundant or debugging-specific settings.

copy reviewer prompt

Prompt

Reviewer Prompt

Configuration files should only include options that are supported in production and work out of the box. Remove configuration fields that are unsupported in production environments, comment out configurations that require external provisioning, and maintain consistency across templates by removing redundant or debugging-specific settings.

Key principles:

  • Remove production-unsupported options (like worker loader id fields)
  • Comment out configurations requiring external setup (like R2 buckets) to prevent broken out-of-box experiences
  • Remove debugging/development-specific settings for template consistency (like minify: true)

Example from wrangler.jsonc:

{
  "name": "my-worker",
  "main": "src/index.ts",
  "compatibility_date": "2024-09-26",
  // Remove unsupported production options
  // "unsafe": {
  //   "bindings": [
  //     {
  //       "name": "LOADER", 
  //       "type": "worker-loader"
  //       // "id": "random-id" <- Remove this
  //     }
  //   ]
  // },
  // Comment out configs requiring external provisioning
  // "r2_buckets": [
  //   {
  //     "binding": "CACHE_BUCKET",
  //     "bucket_name": "<BUCKET_NAME>"
  //   }
  // ]
}

This ensures templates work immediately after creation and don’t include configurations that will fail in production deployments.

Source discussions