{"id":66,"date":"2025-12-08T00:00:00","date_gmt":"2025-12-08T00:00:00","guid":{"rendered":"https:\/\/wordpress.securinsight.ca\/index.php\/2025\/12\/08\/workers-configure-workers-programmatically-using-the-vite-plugin\/"},"modified":"2025-12-08T00:00:00","modified_gmt":"2025-12-08T00:00:00","slug":"workers-configure-workers-programmatically-using-the-vite-plugin","status":"publish","type":"post","link":"https:\/\/wordpress.securinsight.ca\/index.php\/2025\/12\/08\/workers-configure-workers-programmatically-using-the-vite-plugin\/","title":{"rendered":"Workers – Configure Workers programmatically using the Vite plugin"},"content":{"rendered":"

The Cloudflare Vite plugin<\/a> now supports programmatic configuration of Workers without a Wrangler configuration file. You can use the config<\/code> option to define Worker settings directly in your Vite configuration, or to modify existing configuration loaded from a Wrangler config file. This is particularly useful when integrating with other build tools or frameworks, as it allows them to control Worker configuration without needing users to manage a separate config file.<\/p>\n

The config<\/code> option<\/h4>\n

The Vite plugin’s new config<\/code> option accepts either a partial configuration object or a function that receives the current configuration and returns overrides. This option is applied after any config file is loaded, allowing the plugin to override specific values or define Worker configuration entirely in code.<\/p>\n

Example usage<\/h4>\n

Setting config<\/code> to an object to provide configuration values that merge with defaults and config file settings:<\/p>\n

\n
\n
import <\/span>{<\/span> <\/span>defineConfig<\/span> <\/span><\/span>}<\/span> from <\/span>\"vite\"<\/span>;<\/span><\/div><\/div>
import <\/span>{<\/span> <\/span>cloudflare<\/span> <\/span><\/span>}<\/span> from <\/span>\"@cloudflare\/vite-plugin\"<\/span>;<\/span><\/div><\/div>
\n<\/div><\/div>
export<\/span> <\/span>default<\/span> <\/span>defineConfig<\/span>(<\/span>{<\/span><\/div><\/div>
  <\/span><\/span>plugins<\/span>:<\/span> [<\/span><\/div><\/div>
    <\/span>cloudflare<\/span>(<\/span>{<\/span><\/div><\/div>
      <\/span><\/span>config<\/span>:<\/span> <\/span>{<\/span><\/div><\/div>
        <\/span><\/span>name<\/span>:<\/span> <\/span>\"my-worker\"<\/span>,<\/span><\/div><\/div>
        <\/span><\/span>compatibility_flags<\/span>:<\/span> [<\/span>\"nodejs_compat\"<\/span>]<\/span>,<\/span><\/div><\/div>
        <\/span><\/span>send_email<\/span>:<\/span> [<\/span><\/div><\/div>
          <\/span>{<\/span><\/div><\/div>
            <\/span><\/span>name<\/span>:<\/span> <\/span>\"EMAIL\"<\/span>,<\/span><\/div><\/div>
          <\/span>},<\/span><\/div><\/div>
        <\/span><\/span>]<\/span>,<\/span><\/div><\/div>
      <\/span>},<\/span><\/div><\/div>
    <\/span>}<\/span>)<\/span>,<\/span><\/div><\/div>
  <\/span><\/span>]<\/span>,<\/span><\/div><\/div>
}<\/span>)<\/span>;<\/span><\/div><\/div><\/code><\/pre>\n
<\/div>\n<\/figure>\n<\/div>\n
Use a function to modify the existing configuration:<\/p>\n
\n
\n
import <\/span>{<\/span> <\/span>defineConfig<\/span> <\/span><\/span>}<\/span> from <\/span>\"vite\"<\/span>;<\/span><\/div><\/div>
import <\/span>{<\/span> <\/span>cloudflare<\/span> <\/span><\/span>}<\/span> from <\/span>\"@cloudflare\/vite-plugin\"<\/span>;<\/span><\/div><\/div>
export<\/span> <\/span>default<\/span> <\/span>defineConfig<\/span>(<\/span>{<\/span><\/div><\/div>
  <\/span><\/span>plugins<\/span>:<\/span> [<\/span><\/div><\/div>
    <\/span>cloudflare<\/span>(<\/span>{<\/span><\/div><\/div>
      <\/span>config<\/span>:<\/span> <\/span>(<\/span>userConfig<\/span>)<\/span> <\/span>=><\/span> <\/span>{<\/span><\/div><\/div>
        <\/span>delete<\/span> <\/span>userConfig<\/span>.<\/span>compatibility_flags<\/span>;<\/span><\/div><\/div>
      <\/span>},<\/span><\/div><\/div>
    <\/span>}<\/span>)<\/span>,<\/span><\/div><\/div>
  <\/span><\/span>]<\/span>,<\/span><\/div><\/div>
}<\/span>)<\/span>;<\/span><\/div><\/div><\/code><\/pre>\n
<\/div>\n<\/figure>\n<\/div>\n
Return an object with values to merge:<\/p>\n
\n
\n
import <\/span>{<\/span> <\/span>defineConfig<\/span> <\/span><\/span>}<\/span> from <\/span>\"vite\"<\/span>;<\/span><\/div><\/div>
import <\/span>{<\/span> <\/span>cloudflare<\/span> <\/span><\/span>}<\/span> from <\/span>\"@cloudflare\/vite-plugin\"<\/span>;<\/span><\/div><\/div>
\n<\/div><\/div>
export<\/span> <\/span>default<\/span> <\/span>defineConfig<\/span>(<\/span>{<\/span><\/div><\/div>
  <\/span><\/span>plugins<\/span>:<\/span> [<\/span><\/div><\/div>
    <\/span>cloudflare<\/span>(<\/span>{<\/span><\/div><\/div>
      <\/span>config<\/span>:<\/span> <\/span>(<\/span>userConfig<\/span>)<\/span> <\/span>=><\/span> <\/span>{<\/span><\/div><\/div>
        <\/span>if<\/span> (<\/span>!<\/span>userConfig<\/span>.<\/span>compatibility_flags<\/span>.<\/span>includes<\/span>(<\/span>\"no_nodejs_compat\"<\/span>)) <\/span>{<\/span><\/div><\/div>
          <\/span>return<\/span> <\/span>{<\/span> compatibility_flags<\/span>:<\/span> [<\/span>\"nodejs_compat\"<\/span>] <\/span>};<\/span><\/div><\/div>
        <\/span>}<\/span><\/div><\/div>
      <\/span>},<\/span><\/div><\/div>
    <\/span>}<\/span>)<\/span>,<\/span><\/div><\/div>
  <\/span><\/span>]<\/span>,<\/span><\/div><\/div>
}<\/span>)<\/span>;<\/span><\/div><\/div><\/code><\/pre>\n
<\/div>\n<\/figure>\n<\/div>\n
Auxiliary Workers<\/h4>\n
Auxiliary Workers also support the config<\/code> option, enabling multi-Worker architectures without config files.<\/p>\n
Define auxiliary Workers without config files using config<\/code> inside the auxiliaryWorkers<\/code> array:<\/p>\n
\n
\n
import <\/span>{<\/span> <\/span>defineConfig<\/span> <\/span><\/span>}<\/span> from <\/span>\"vite\"<\/span>;<\/span><\/div><\/div>
import <\/span>{<\/span> <\/span>cloudflare<\/span> <\/span><\/span>}<\/span> from <\/span>\"@cloudflare\/vite-plugin\"<\/span>;<\/span><\/div><\/div>
\n<\/div><\/div>
export<\/span> <\/span>default<\/span> <\/span>defineConfig<\/span>(<\/span>{<\/span><\/div><\/div>
  <\/span><\/span>plugins<\/span>:<\/span> [<\/span><\/div><\/div>
    <\/span>cloudflare<\/span>(<\/span>{<\/span><\/div><\/div>
      <\/span><\/span>config<\/span>:<\/span> <\/span>{<\/span><\/div><\/div>
        <\/span><\/span>name<\/span>:<\/span> <\/span>\"entry-worker\"<\/span>,<\/span><\/div><\/div>
        <\/span><\/span>main<\/span>:<\/span> <\/span>\".\/src\/entry.ts\"<\/span>,<\/span><\/div><\/div>
        <\/span><\/span>services<\/span>:<\/span> [<\/span>{<\/span> binding<\/span>:<\/span> <\/span>\"API\"<\/span>,<\/span> service<\/span>:<\/span> <\/span>\"api-worker\"<\/span> <\/span>}<\/span>]<\/span>,<\/span><\/div><\/div>
      <\/span>},<\/span><\/div><\/div>
      <\/span><\/span>auxiliaryWorkers<\/span>:<\/span> [<\/span><\/div><\/div>
        <\/span>{<\/span><\/div><\/div>
          <\/span><\/span>config<\/span>:<\/span> <\/span>{<\/span><\/div><\/div>
            <\/span><\/span>name<\/span>:<\/span> <\/span>\"api-worker\"<\/span>,<\/span><\/div><\/div>
            <\/span><\/span>main<\/span>:<\/span> <\/span>\".\/src\/api.ts\"<\/span>,<\/span><\/div><\/div>
          <\/span>},<\/span><\/div><\/div>
        <\/span>},<\/span><\/div><\/div>
      <\/span><\/span>]<\/span>,<\/span><\/div><\/div>
    <\/span>}<\/span>)<\/span>,<\/span><\/div><\/div>
  <\/span><\/span>]<\/span>,<\/span><\/div><\/div>
}<\/span>)<\/span>;<\/span><\/div><\/div><\/code><\/pre>\n
<\/div>\n<\/figure>\n<\/div>\n
For more details and examples, see Programmatic configuration<\/a>.<\/p>","protected":false},"excerpt":{"rendered":"
The Cloudflare Vite plugin now supports programmatic configuration of Workers without a Wrangler configuration file. You can use the config option to define Worker settings directly in your Vite configuration, or to modify existing configuration loaded from a Wrangler config file. This is particularly useful when integrating with other build tools or frameworks, as it […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-66","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/posts\/66","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/comments?post=66"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/posts\/66\/revisions"}],"wp:attachment":[{"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/media?parent=66"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/categories?post=66"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.securinsight.ca\/index.php\/wp-json\/wp\/v2\/tags?post=66"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}