feat: add Waku to C3

[rmarscher]

Fixes #7594.

Adding a C3 template for Waku, a minimal React framework. https://waku.gg/

• Tests
  • TODO (before merge)
  • Tests included
  • Tests not necessary because:
• E2E Tests CI Job required? (Use "e2e" label or ask maintainer to run separately)
  • I don't know
  • Required
  • Not required because:
• Public documentation
  • TODO (before merge)
  • Cloudflare docs PR(s): [Workers] Add Waku framework guide cloudflare-docs#25450 & Add Waku framework guide cloudflare-docs#20444
  • Documentation not necessary because:

[changeset-bot]

🦋 Changeset detected

Latest commit: 14de58a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
create-cloudflare	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

A wrangler prerelease is available for testing. You can install this latest build in your project with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-wrangler-8314

You can reference the automatically updated head of this PR with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/prs/8314/npm-package-wrangler-8314

Or you can use npx with this latest build directly:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-wrangler-8314 dev path/to/script.js

Additional artifacts:

cloudflare-workers-bindings-extension:

wget https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-workers-bindings-extension-8314 -O ./cloudflare-workers-bindings-extension.0.0.0-veb635466b.vsix && code --install-extension ./cloudflare-workers-bindings-extension.0.0.0-veb635466b.vsix

create-cloudflare:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-create-cloudflare-8314 --no-auto-update

@cloudflare/kv-asset-handler:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-kv-asset-handler-8314

miniflare:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-miniflare-8314

@cloudflare/pages-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-pages-shared-8314

@cloudflare/unenv-preset:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-unenv-preset-8314

@cloudflare/vite-plugin:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-vite-plugin-8314

@cloudflare/vitest-pool-workers:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-vitest-pool-workers-8314

@cloudflare/workers-editor-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-workers-editor-shared-8314

@cloudflare/workers-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-workers-shared-8314

@cloudflare/workflows-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/13699747655/npm-package-cloudflare-workflows-shared-8314

Note that these links will no longer work once the GitHub Actions artifact expires.

---

wrangler@3.113.0 includes the following runtime dependencies:

Package	Constraint	Resolved
miniflare	workspace:*	3.20250224.0
workerd	1.20250224.0	1.20250224.0
workerd --version	1.20250224.0	2025-02-24

Please ensure constraints are pinned, and miniflare/workerd minor versions match.

[emily-shen]

would you be able to make this a wrangler.jsonc? for consistency :)

[rmarscher]

Definitely! I didn't see that the other templates started migrating. I'll get that updated in the Cloudflare Waku template and also rebase to fix the new conflicts.

[rmarscher]

OK. That is all set in this PR. I also submitted an upstream PR to switch to wrangler.jsonc and to recognize an existing toml, json or jsonc file. wakujs/waku#1301

[petebacondarwin]

Sorry this has sat here for a while. Would you mind resolving the conflicts?

[rmarscher]

Sorry this has sat here for a while. Would you mind resolving the conflicts?

No problem. Thank you for looking at it. I think this is ready for review.

[github-actions]

A Wrangler prerelease is available for testing. You can install this latest build in your project with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-wrangler-8314

Prereleases for other packages:

cloudflare-workers-bindings-extension:

wget https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-workers-bindings-extension-8314 -O ./cloudflare-workers-bindings-extension.0.0.0-vc581b4f4c.vsix && code --install-extension ./cloudflare-workers-bindings-extension.0.0.0-vc581b4f4c.vsix

create-cloudflare:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-create-cloudflare-8314 --no-auto-update

@cloudflare/kv-asset-handler:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-kv-asset-handler-8314

miniflare:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-miniflare-8314

@cloudflare/pages-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-pages-shared-8314

@cloudflare/unenv-preset:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-unenv-preset-8314

@cloudflare/vite-plugin:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-vite-plugin-8314

@cloudflare/vitest-pool-workers:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-vitest-pool-workers-8314

@cloudflare/workers-editor-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-workers-editor-shared-8314

@cloudflare/workers-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-workers-shared-8314

@cloudflare/workflows-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14462527551/npm-package-cloudflare-workflows-shared-8314

Note that these links will no longer work once the GitHub Actions artifact expires.

[emily-shen]

lgtm for the most part! thanks for your patience, hopefully we can get this out soon 🧡

would you be able to add a changeset, fix the tests and run pnpm fix to fix the linting issues? let me know if you'd like a hand with any of these :)

[petebacondarwin]

I've been trying to land this over the weekend.
But it appears that there is no a legitimate issue in the Waku build (as demonstrated by the failed CI jobs).

  create-cloudflare:test:e2e: > waku build --with-cloudflare
  create-cloudflare:test:e2e: vite v7.0.5 building SSR bundle for production...
  create-cloudflare:test:e2e: transforming...
  create-cloudflare:test:e2e: "sqlite" is imported by "sqlite?commonjs-external", but could not be resolved – treating it as an external dependency.
  create-cloudflare:test:e2e: ✓ 525 modules transformed.
  create-cloudflare:test:e2e: ✗ Build failed in 11.19s
  create-cloudflare:test:e2e: node:internal/modules/run_main:123
  create-cloudflare:test:e2e:     triggerUncaughtException(
  create-cloudflare:test:e2e:     ^
  create-cloudflare:test:e2e: 
  create-cloudflare:test:e2e: Could not resolve "./node.js" from "node_modules/blake3-wasm/esm/index.js"

[rmarscher]

I've been trying to land this over the weekend. But it appears that there is no a legitimate issue in the Waku build (as demonstrated by the failed CI jobs).

I will look into it @petebacondarwin. I haven't encountered that build error before. First thing we can try is updating create-waku to the latest version (0.12.5-0.26.1-0).

[rmarscher]

Updating create-waku did not seem to fix it. I am reproducing the error running the e2e test locally using

E2E_FRAMEWORK_TEMPLATE_TO_TEST=waku pnpm test:e2e -F create-cloudflare -- frameworks

When I run that command, it seems to wait forever on the waku (workers) step of e2e/tests/frameworks/frameworks.test.ts. I found the log file at packages/create-cloudflare/.e2e-logs/pnpm/frameworks/waku_workers.ansi and that shows that it failed to build and run the preview with the same error message.

🎉  SUCCESS  Application created successfully!
💻 Continue Developing
Change directories: cd c3-tests-e2e--web-frameworksuU34hY/tmp-e2e-c374d3d6a0-waku--workers
Start dev server: pnpm run dev
Deploy: pnpm run deploy
📖 Explore Documentation
https://developers.cloudflare.com/workers
🐛 Report an Issue
https://github.com/cloudflare/workers-sdk/issues/new/choose
💬 Join our Community
https://discord.cloudflare.com

Running command: pnpm run preview --port 55354

> tmp-e2e-c374d3d6a0-waku--workers@0.0.0 preview /private/tmp/c3-tests-e2e--web-frameworksuU34hY/tmp-e2e-c374d3d6a0-waku--workers
> pnpm run build && wrangler dev "--port" "55354"
> tmp-e2e-c374d3d6a0-waku--workers@0.0.0 build /private/tmp/c3-tests-e2e--web-frameworksuU34hY/tmp-e2e-c374d3d6a0-waku--workers
> waku build --with-cloudflare
vite v7.1.5 building SSR bundle for production...
transforming...
"sqlite" is imported by "sqlite?commonjs-external", but could not be resolved – treating it as an external dependency.
✓ 513 modules transformed.
✗ Build failed in 12.87s
node:internal/modules/run_main:122
    triggerUncaughtException(
    ^

Could not resolve "./node.js" from "node_modules/.pnpm/blake3-wasm@2.1.5/node_modules/blake3-wasm/esm/index.js"

But if I cd into the temp dir in the logs (/private/tmp/c3-tests-e2e--web-frameworksuU34hY/tmp-e2e-c374d3d6a0-waku--workers), I can run pnpm run preview --port 55354 without any errors and the scaffolded app is working at http://localhost:55354/.

So I'm not exactly sure why it is failing with e2e. It looks like the default node version on my machine right now is v22.12.0.

[petebacondarwin]

I'll take a look...

[petebacondarwin]

I can reproduce the error in e2e locally. But also create a new project locally that works. Same as you. I am using Node 20.
So I am also not sure what is happening.

[rmarscher]

I compared environment variables and found that NODE_ENV=test causes this problem with the Waku / Vite setup. Adding NODE_ENV=production to the build command fixes it. I'll raise an upstream issue, but hopefully this unblocks getting this PR landed. Thank you so much for all of your help.

[holopin-bot]

Congratulations @rmarscher, the maintainer of this repository has issued you a holobyte! Here it is: https://holopin.io/holobyte/cmg5k2y2i0024l704mur2mxvs

This badge can only be claimed by you, so make sure that your GitHub account is linked to your Holopin account. You can manage those preferences here: https://holopin.io/account.
Or if you're new to Holopin, you can simply sign up with GitHub, which will do the trick!