Skip to content

Add docs for cre workflow simulate --wasm and listen mode behavior - #4376

Open
wentzeld wants to merge 1 commit into
mainfrom
docs/cre-simulate-wasm-listen
Open

wentzeld wants to merge 1 commit into
mainfrom
docs/cre-simulate-wasm-listen

Conversation

@wentzeld

Copy link
Copy Markdown
Contributor

Documents behavior of cre workflow
simulate that was not covered, based on testing with CLI v1.39.0.

Changes:

  • Add --wasm and --http-trigger-port to the simulate reference, with examples.
  • Add a "Simulating with a pre-built binary" section, and a build-once section in Custom WASM Builds.
  • Expand Listen mode: request format (POST /trigger with an input field), empty 200 response, one run at a time, the 30-second default HTTP trigger
    limit (and --limits none), and error behavior.
  • Fix the listen mode curl example in Testing HTTP Triggers in Simulation, and state that the simulator compiles once at startup.
  • Add a comparison of the local listener and the deployed gateway.
  • Add notes that cre-http-trigger and --listen both default to port 2000 but do different things.

Please confirm with the CLI team: the engine-level error behavior in listen mode, the 97-character limit on a local --wasm path, and that a
relative --wasm path resolves from the workflow directory.

@wentzeld
wentzeld requested review from a team as code owners October 30, 2026 19:51
@vercel

vercel Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
documentation Ready Ready Preview Oct 30, 2026 8:01pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 0729d4ed Deployed Oct 30, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant