{"id":166,"date":"2026-10-17T14:16:04","date_gmt":"2026-10-17T14:16:04","guid":{"rendered":"http:\/\/plugin-docs.com\/?post_type=doc&#038;p=166"},"modified":"2026-10-18T12:36:27","modified_gmt":"2026-10-18T12:36:27","slug":"why-workflow-editor-missing-build-assets","status":"publish","type":"doc","link":"https:\/\/dragwyb.com\/docs\/why-workflow-editor-missing-build-assets\/","title":{"rendered":"Why does the workflow editor report missing build assets?"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The workflow editor depends on compiled JavaScript assets. If the builder has not been built, the plugin displays an admin notice instead of leaving the editor blank. The distributed ZIP inspected for version 0.1.3 includes the compiled builder files; a source checkout may not.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Confirm which installation you have<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>If you installed a released plugin ZIP, check that it is the complete release package and that the <code>assets\/builder\/build\/<\/code> directory was included when the ZIP was created.<\/li>\n\n\n<li>If you are working from a source checkout, use the package scripts in the plugin directory to build the editor assets.<\/li>\n\n\n<li>Do not assume that installing Composer dependencies builds the JavaScript editor. The builder uses the npm scripts in <code>package.json<\/code>.<\/li>\n\n<\/ul>\n\n\n\n\n<p class=\"wp-block-paragraph\">Screenshot to add: [Workflow Editor missing build assets notice]<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Build the editor from source<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The project README documents this build sequence from the plugin directory:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>npm install\nnpm run build<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The <code>build<\/code> script runs <code>wp-scripts build<\/code>. The builder source is under <code>assets\/builder\/src\/<\/code>, and the compiled output is written to <code>assets\/builder\/build\/<\/code>. The plugin uses the compiled asset manifest to load the builder script and its declared dependencies.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The plugin declares PHP 7.4+ and WordPress 5.8+ as its minimum requirements. The package defines npm build scripts and pins <code>@wordpress\/scripts<\/code> to the 27.x line for its WordPress compatibility target. The project files inspected do not specify a minimum Node.js version, so check the installed npm and Node.js versions against your package manager&#8217;s requirements rather than guessing a version.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Check the compiled files<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Confirm <code>assets\/builder\/build\/index.asset.php<\/code> exists. The editor checks this file and displays the missing-build notice when it is absent.<\/li>\n\n\n<li>Confirm <code>assets\/builder\/build\/index.js<\/code> exists. The editor enqueues this compiled JavaScript file when the asset manifest is present.<\/li>\n\n\n<li>Confirm <code>assets\/builder\/build\/style-index.css<\/code> exists if the editor styles are missing. The stylesheet is optional in the enqueue code, so a missing CSS file does not trigger the same missing-build notice.<\/li>\n\n\n<li>After building or replacing the ZIP, reload the editor and confirm the notice is gone and the builder interface appears.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">If the notice remains<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Check that you ran the commands from the plugin directory containing <code>package.json<\/code>.<\/li>\n\n\n<li>Check that the files were generated in <code>assets\/builder\/build\/<\/code>, not in a different project or output directory.<\/li>\n\n\n<li>If you distribute the plugin to another site, rebuild or repackage it with the compiled files included. Do not ask the production site to build assets unless that is part of your deployment process.<\/li>\n\n\n<li>If the files exist but the editor still does not load, follow the separate <a href=\"https:\/\/dragwyb.com\/docs\/docs\/ai-agent-workflows-by-dragwyb\/why-workflow-editor-not-loading\/\">workflow editor not loading<\/a> guide. The asset notice checks the manifest file; it does not diagnose every JavaScript or REST API failure.<\/li>\n\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The source inspection confirms the expected paths and commands. It does not establish that a particular hosting environment has a broken cache or a missing file; verify the installed ZIP and actual files first.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Why does the workflow editor report missing build assets?<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":165,"menu_order":0,"template":"","class_list":["post-166","doc","type-doc","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/166","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/types\/doc"}],"version-history":[{"count":1,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/166\/revisions"}],"predecessor-version":[{"id":909,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/166\/revisions\/909"}],"up":[{"embeddable":true,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/165"}],"wp:attachment":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/media?parent=166"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}