Under the hood Bindings

How Devflare wires Version Metadata from config to runtime

Version Metadata exposes a Worker version id, version tag, and timestamp to code running in that version.

Version Metadata compiles from to Wrangler , with local/test behavior called out explicitly.

Use this page when you need emitted config, preview behavior, or Cloudflare-specific limits. The overview and example pages stay focused on everyday app code.

Normalization: Devflare normalizes before emitting Wrangler
Compile target: Wrangler
Preview note: Cloudflare supplies real deployment metadata; local tests should assert deterministic fallback behavior only.

How authored config becomes Wrangler config

The authored config stays camelCase and project-oriented. The compiler translates that into the Wrangler keys Cloudflare expects.

The emitted output is shown here so the usage pages do not have to explain compiler details.

Version Metadata config and emitted Wrangler output

Use this when you need to check how the Devflare config becomes Wrangler-compatible config.

import { defineConfig } from 'devflare/config'

export default defineConfig({

name: 'versioned-worker',

bindings: {

versionMetadata: {

binding: 'CF_VERSION_METADATA'

}

})

What local runtime support covers

Offline-native: Devflare can provide deterministic local metadata without Cloudflare state
The default docs recipe uses or .
Pure unit tests can use / when the test only needs deterministic application behavior.

Compile, preview, and cleanup behavior

Devflare emits Wrangler from the native config surface.
Preview and deployment lifecycle stay feature-specific; do not assume all Cloudflare products can be created, cloned, or cleaned up the same way.
Cloudflare supplies real deployment metadata; local tests should assert deterministic fallback behavior only.

Cloudflare docs vs the Devflare layer

Cloudflare Version Metadata docs is the platform reference. Use this internals page when you need to compare Cloudflare's product docs with Devflare config, generated env types, local support, and preview behavior for .

Reference

Cloudflare Version Metadata docs

Cloudflare Docs

Platform reference for Worker version id, version tag, and version timestamp bindings.

Question	Cloudflare docs	This Devflare page
Primary focus	Platform reference for Worker version id, version tag, and version timestamp bindings.	How to author , what the runtime surface looks like, and how Version Metadata fits a Devflare project.
Testing and runtime lens	Cloudflare’s docs focus on the raw binding API, product semantics, and platform limits for the binding itself.	Offline-native: Devflare can provide deterministic local metadata without Cloudflare state. Use the Devflare guidance when you need the honest local harness or the right remote gate instead of only the product API shape.
When to open it	When you need the platform contract, limits, APIs, or account-level product details.	When you are wiring, testing, previewing, or reviewing the binding inside a Devflare app.

Version Metadata

Add the Version Metadata config, call from worker code, and start with the local test path Devflare supports.

Testing Version Metadata

Test Version Metadata by choosing the local harness that matches the product boundary instead of reaching for Cloudflare by default.