mrkeyoor.com_
Fri 16 Oct 18:51 UTC
Automationevaluationupdated 11 Oct 2026

jev-workflow-builder review

Jev Workflow Builder is a shared visual editor for connecting Jev decisions and language-model calls. It uses Liveblocks for collaboration and lets an application invoke a workflow through a REST endpoint. The repository presents it as a demo for developers building their own editor.

+0 / 4dstars / 7d
Verdict

Our Jev Workflow Builder build failed after 22 seconds, and npm audit reported 1 critical and 2 high vulnerabilities after a 458-package install. Use its source to study collaborative Jev workflows if Liveblocks fits your stack. I would require real caller authorization and successful build verification before adapting it for private team work.

We ran it

Lab card: what happened when we ran jev-workflow-builderScreenshot of jev-workflow-builder (github.com/CTNicholas/jev-workflow-builder)
Install✓ · 15s458 packages · 491 MB
Build✗ · 22s
Testsn/ano test script
Known vulns31 critical · 2 high · 0 moderate · 0 low (npm audit)
Repo37 files~5,828 lines of source · 0.3 MB · 0 CI workflows

Answers from our run

Does jev-workflow-builder build from source?

Dependencies installed in 15 seconds (458 packages), and the build failed. We cloned commit 9a652d2 into a clean Debian container with 3 CPUs and no project-specific setup.

Does jev-workflow-builder have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does jev-workflow-builder have known vulnerabilities in its dependencies?

npm audit flagged 3 known advisories in the dependency tree, including 1 critical at the time of our run.

Who should not use jev-workflow-builder?

Teams seeking an offline workflow engine: the README requires Liveblocks, TypeSafe, and Vercel accounts and keys.

What are the alternatives to jev-workflow-builder?

React Flow, Flowise, n8n. Our Jev Workflow Builder build failed after 22 seconds, and npm audit reported 1 critical and 2 high vulnerabilities after a 458-package install.

Setup2/515-second install, then build failure and multiple service keys
Docs2/5Clear key setup, little execution or deployment guidance
Community2/5September push, 150 stars, and no issue discussion
Maturity1/5Demo identities, skipped tests, and a failed build

Who it’s for

TypeScript developers implementing collaborative workflow editing with Liveblocks and React Flow.
Teams already using Jev and willing to supply TypeSafe and AI Gateway credentials.
Builders studying conditional branches, run previews, and server execution before adapting the code.

Who it’s NOT for

Teams seeking an offline workflow engine: the README requires Liveblocks, TypeSafe, and Vercel accounts and keys.
Operators expecting a deployment-ready platform: the README calls this a demo, and our build failed while collecting a workflow API route.
Teams requiring automated release verification: our scan found no CI workflows or tests directory, and there was no test target.
Developers who cannot review dependencies before exposure: our npm audit reported 1 critical and 2 high vulnerabilities.

Setup reality

Our sandbox installed commit 9a652d2 in 15 seconds, adding 458 packages and occupying 491 MB. The build failed after 22 seconds while collecting page data for the workflow-run API route, with the log pointing at Liveblocks initialization. No test target existed, so tests were skipped. Npm audit reported 3 vulnerabilities: 1 critical and 2 high.

The README requires LIVEBLOCKS_SECRET_KEY, TYPESAFE_API_KEY, and AI_GATEWAY_API_KEY from separate service accounts. Missing model keys can select mock responses in the source, but the shared storage still depends on Liveblocks. Our sandbox had no secrets.

The sample auth route chooses example users and grants broad example-room access. Replace that identity and permission logic before private use. The log excerpt does not establish that supplying credentials alone would fix the build, and the repository has no Dockerfile.

The useful part is collaborative workflow editing

Jev Workflow Builder lets colleagues connect decision nodes and language-model nodes on a shared canvas. The README promises multiplayer state and cursors, preview runs, and a REST entry point for invoking the graph. Its source uses React Flow for the diagram and Liveblocks for shared storage. If you're building a collaborative decision editor, these connections are more instructive than a screenshot of boxes and arrows.

Our checkout contained 37 files and about 5,828 source lines, occupying only 0.3 MB. That compact codebase is approachable for a developer studying how graph editing connects to server execution. The README explicitly calls it a demo. I would judge it as an implementation example whose parts you adapt, rather than assume that a small repository supplies the operational controls of an established automation platform.

What happened when we ran it

Our sandbox installed Jev Workflow Builder commit 9a652d2 in 15 seconds, adding 458 packages and occupying 491 MB. The build failed with exit code 1 after 22 seconds. The October 8, 2026 run used the lab-node:22 image in an unprivileged container with 3 CPUs, 8 GB of RAM, and no secrets. No test script or target was available, so the test step was skipped.

The build log points at new Liveblocks(...), where the constructor receives process.env.LIVEBLOCKS_SECRET_KEY. It then reports failure to collect page data for /api/workflows/[workflowId]/runs. That establishes a failure while preparing a server route in our credential-free environment. The excerpt doesn't supply the underlying constructor exception, so it cannot prove that adding a key alone produces a successful build or a working workflow.

Npm audit reported 3 known vulnerabilities: 1 critical and 2 high, with none moderate or low. The supplied block doesn't identify affected dependencies, exploit conditions, or fixes. We therefore can't attach those severities to a particular public route. Our scan found 0 CI workflow files, no Dockerfile, and no tests directory. This run gives a concrete reason to inspect dependencies and verification before adapting the example for deployment.

Liveblocks is required even when model replies are mocked

The setup instructions require accounts and keys for Liveblocks, TypeSafe, and Vercel's AI Gateway. Those services have separate jobs: Liveblocks maintains shared workflow state, Jev answers typed questions, and the gateway supplies language-model generation. Our 491 MB install didn't demonstrate any authenticated service call. It only established that dependency installation completed in the sandbox.

The source adds a useful nuance absent from the short README. Without TYPESAFE_API_KEY, Jev answers come from keyword matching. Without AI_GATEWAY_API_KEY, the language-model node streams a canned response. Both paths mark the result as mock. That helps illustrate graph behavior while you're developing, but a moving preview isn't evidence that Jev classified the input or a language model drafted the response. Liveblocks still has its own constructor and secret requirement.

The graph executor rejects cycles and records node results

The executor reads a snapshot of the workflow graph from Liveblocks storage and checks its execution order. It returns an error when the graph contains a cycle or lacks an input node. Branches can require any incoming condition or all incoming conditions, and upstream answers become available to later questions. These are concrete implementation choices you can study within the roughly 5,828 lines our scan counted.

Run status and node messages go into Liveblocks feeds. The API can return a run identifier immediately or wait for the final trace when the caller requests it. That makes the execution path inspectable in source and lets another application invoke a workflow. It doesn't give us evidence of durable recovery after a server interruption, correct billing behavior, or reliable execution under concurrent load. None of those outcomes was measured by our lab.

Sample identities need replacing before private workflows

The Liveblocks auth route accepts a sample user identifier or selects a random example user. It then grants write permissions across the example room prefix. A separate source file contains the sample identities. This is convenient gallery behavior, but it is a poor fit for private team workflows without application-specific identity and room authorization.

The workflow-run route checks whether the server has its Liveblocks secret, then looks up the requested workflow and starts execution. That server configuration check doesn't authenticate the caller. Our 22-second failed build never exposed a running endpoint, so this is a source finding rather than an observed attack. A developer adapting the demo should add caller checks to the run route as well as replacing the example collaboration permissions.

September activity provides little operating history

GitHub records a last push of September 21, 2026, with 150 stars and 0 open issues and PRs. The latest-release endpoint returns no release, and the recent issue list is empty. Those facts show a small public example with little visible issue discussion. They don't establish either abandonment or trouble-free operation. The README offers local development instructions but no detailed deployment or recovery guide.

The absence of a test target matters more alongside our 3 audit findings and failed build than it would in a diagram-only example. This project includes server execution and calls that can use paid services. Before trusting an adapted version, prove one authenticated workflow from input through branch selection to output, then exercise failed service calls. Keep mock results visible so nobody mistakes an illustrative preview for completed work.

Pick an editor foundation or an automation platform deliberately

React Flow is the narrower alternative when you want to build the canvas and own execution yourself. Flowise addresses visual AI workflows, while n8n is worth considering for broader automation and integrations. Jev Workflow Builder earns attention when Liveblocks collaboration around Jev decisions is exactly what you're implementing. Budget for real authorization and dependency review before letting its run route spend service credentials.

Alternatives

ProjectWhat it isPick it when
React FlowLibraries for constructing node-based user interfaces.pick this instead when you want a canvas and will design execution and collaboration yourself.
Flowise gh↗A visual builder for AI workflows and agents.pick this instead when you want a broader AI workflow product rather than a Jev collaboration example.
n8n gh↗A fair-code workflow automation platform with visual editing and integrations.pick this instead when general automation and service integrations are the main requirement.

What people are saying

  1. [velocity-scout] CTNicholas/jev-workflow-builder

Sources

  1. Jev Workflow Builder README
  2. Liveblocks authentication source
  3. Workflow executor
  4. Workflow-run API route
  5. TypeSafe adapter and mock answers
  6. Language-model adapter and mock replies
  7. React Flow
  8. Flowise

More automation reviews

supersidian · genspark-claw · orc-claude-plugin · tiktok-views-bot · Ydisks-Xianyu-Helper · jev-gui-delegate · the whole board →